iOS用ネイティブSDKでのエラー処理

概要

エラーコードの名前には ErrorCode が含まれます。例：

kBCOVPlaybackSessionErrorCodeLoadFailed

イベントの名前には Event が含まれます。例：

kBCOVPlaybackSessionLifecycleEventFail

再生エラー

再生エラーはイベントを通じて処理されます。通常、BCOVPlaybackController のライフサイクルイベントのデリゲートコールバックで受け取ります：

- (void)playbackController:(id<BCOVPlaybackController>)controller
          playbackSession:(id<BCOVPlaybackSession>)session
 didReceiveLifecycleEvent:(BCOVPlaybackSessionLifecycleEvent *)lifecycleEvent;

詳細情報を取得するには、次の操作を行います。

1. kBCOVPlaybackSessionLifecycleEventFail、kBCOVPlaybackSessionLifecycleEventError、kBCOVPlaybackSessionLifecycleEventFailedToPlayToEndTime などのエラーイベントを受け取ったら、イベントの properties 辞書の kBCOVPlaybackSessionEventKeyError（@"error"）キーを確認します。kBCOVPlaybackSessionLifecycleEventResumeFail にはエラーが含まれません。

   問題の情報を持つ NSError オブジェクトを取得できます。

2. 各 NSError には、次のようなエラードメインがあります。

   • NSCocoaErrorDomain
   • kBCOVPlaybackSessionErrorDomain

   各エラードメインには、次のようなエラーコードと説明が関連付けられています。

   • kBCOVPlaybackSessionErrorCodeLoadFailed
   • kBCOVPlaybackSessionErrorCodeNoPlayableSource

3. 一部のエラーには、原因となったエラーも含まれます。エラーの userInfo 辞書から NSUnderlyingErrorKey キーで取得できます。通常は、詳細情報を持つシステムの NSError です。

4. SDK のすべてのエラードメインを調べるには、ヘッダーファイルで次を検索します。

   ErrorDomain

   ErrorDomain を参照するヘッダー：

   • BrightcovePlayerSDK-Swift.h（FairPlay、オフライン動画マネージャー、Playback Service の API）
   • BCOVPlaybackSessionConstants.h（再生セッションのイベントとエラー）

5. すべてのエラーコードを調べるには、各 ErrorDomain で次を検索します。

   ErrorCode

   たとえば、BCOVPlaybackSessionConstants.h の kBCOVPlaybackSessionErrorDomain には、次のエラーコードがあります。

   • kBCOVPlaybackSessionErrorCodeLoadFailed
   • kBCOVPlaybackSessionErrorCodeFailedToPlayToEnd
   • kBCOVPlaybackSessionErrorCodeNoPlayableSource

6. 他のドメインでは、エラーの返し方が異なる場合があります。たとえば、BCOVPlaybackService は、オンラインカタログへの動画リクエストでネットワークエラーが発生すると、完了ブロックにエラーを返します。エラードメインは BCOVPlaybackService.ErrorDomain です。

再生エラーの一覧

以下は、iOS 用 Native SDK で発生する可能性のある再生エラーです。基盤となるフレームワークからエラーが渡されることもあります。