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

概要

エラーコードの名前には、ErrorCodeという語があります。例は次のとおりです。

kBCOVPlaybackSessionErrorCodeLoadFailed

Eventイベントの名前には単語があります。例は次のとおりです。

kBCOVPlaybackSessionLifecycleEventFail

再生エラー

再生エラーはイベントを通じて処理されます。一般的に、ライフサイクルイベントデリゲートコールバックを使用して、再生エラーを受け取りますBCOVPlaybackController。

- (void)playbackSession:(id<BCOVPlaybackSession>)session
  didReceiveLifecycleEvent:(BCOVPlaybackSessionLifecycleEvent *)lifecycleEvent

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

1. 次のようなエラーイベントが発生した場合kBCOVPlaybackSessionLifecycleEventFailまたはkBCOVPlaybackSessionLifecycleEventResumeFail、イベントを確認してくださいpropertiesのための辞書@"error"キー。

   これにより、NSErrorオブジェクトには問題に関する情報が提供されます。

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

   • NSCocoaErrorDomain
   • kBCOVPlaybackSessionErrorDomain
    

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

   • kBCOVPlaybackSessionErrorCodeLoadFailed
   • kBCOVPlaybackSessionErrorCodeNoPlayableSource

3. 一部のエラーには、エラーオブジェクトから取得できる根本的なエラーもあります。userInfoと辞書NSUnderlyingErrorKeyキー。これは、通常、NSErrorより多くの情報を提供できるシステムになります。

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

   ErrorDomain

   ErrorDomain参照を持つヘッダーのリストは次のとおりです。

   • BCOVFPSAuthorizationProxy.h
   • BCOVFPSBrightcoveAuthProxy.h
   • BCOVOfflineVideoManager.h
   • BCOVOnceCommon.h
   • BCOVOnceONOXMLDocument.h
   • BCOVOUXConstants.h
   • BCOVPlaybackService.h
   • BCOVPlaybackSession.h

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

   ErrorCode

   たとえば、BCOVPlaybackSession.h、 わかるでしょkBCOVPlaybackSessionErrorDomain次のエラーコードがあります。

   • kBCOVPlaybackSessionErrorCodeLoadFailed
   • kBCOVPlaybackSessionErrorCodeFailedToPlayToEnd
   • kBCOVPlaybackSessionErrorCodeNoPlayableSource

6. 他のドメインは異なる方法でエラーを返すことがあります。たとえば、オンラインカタログからビデオを要求するときにネットワークエラーが発生すると、BCOVPlaybackServiceオブジェクトは完了ブロックにエラーを返します。エラードメインを使用しますkBCOVPlaybackServiceErrorDomain。