ネイティブSDKでのライブSSAIのプレーヤー拡張機能の使用

はじめに

ライブSSAI でのBrightcoveのプレーヤー機能強化では、広告数、広告カウントダウンタイマー、クリックスルー広告、コンパニオン広告など、ライブストリームの広告ブレイクを向上させることができます。これらのライブストリームは、Brightcoveのネイティブ SDK を使用して再生できます。

テレビはウェブブラウザをサポートしていないため、接続されているテレビではコンパニオン広告やクリックスルー広告をご利用いただけません。

この機能を初めて使用する場合は、以下を参照してください。

• 概要:ライブ SSAI のプレーヤーの機能強化
• ライブ SSAI のプレーヤー機能拡張の実装

ステップ

Brightcoveのネイティブ SDK を使用して拡張プレーヤーでライブストリームを再生するには、次の手順に従います。

1. 「 Live SSAI のプレーヤー拡張の実装」ドキュメントのワークフローに従って、再生トークンを作成します。

2. アプリを構築する:

   • Androidの実装
   • iOSの実装
3. 「 Live SSAI 用のプレーヤーの機能強化の実装」ドキュメントのワークフローに進みます。

Androidの実装

Android 用ネイティブ SDK を使用してアプリを構築するには、次の値が必要です。

• 再生トークン
• アカウント ID
• ビデオ ID
• ポリシーキー

ポリシーキーを取得するには、ポリシーキーのドキュメントを確認します。

アプリを構築するには、次の手順に従います。

1. 基本的な SSAIサンプルアプリをコードの出発点として使用します。
2. res/values/strings.xml ファイルで、次の値を独自の値に置き換えます。
   • アカウント ID
   • ビデオ ID
   • ポリシーキー

3. MainActivity.java ファイルで、ad_config_id値を再生トークンに置き換えます。

   private final String AD_CONFIG_ID_QUERY_PARAM_VALUE = "your playback token";

4. 再生トークンの値がクエリパラメータとして HTTP リクエストに追加されます。ad_config_id

   HttpRequestConfig httpRequestConfig = new HttpRequestConfig.Builder()
     .addQueryParameter(AD_CONFIG_ID_QUERY_PARAM_KEY, AD_CONFIG_ID_QUERY_PARAM_VALUE)
     .build();

5. ライブストリーム動画 ID と更新された HTTP リクエストを使用して、Playback API へのカタログ呼び出しを行います。

   catalog.findVideoByID(getString(R.string.video_id), httpRequestConfig, new VideoListener() {
        @Override
        public void onVideo(Video video) {
            plugin.processVideo(video);
        }
    });

6. プレーヤーはライブストリームを再生する準備ができました。

iOSの実装

iOS 版ネイティブ SDK を使用してアプリを構築するには、次の値が必要です。

• 再生トークン
• アカウント ID
• ビデオ ID
• ポリシーキー

ポリシーキーを取得するには、ポリシーキーのドキュメントを確認します。

アプリを構築するには、次の手順に従います。

1. 基本的な SSAIプレーヤーサンプルをコードの出発点として使用します。
2. ViewController.swift ファイルで、次の値を独自の値に置き換えます。
   • アカウント ID
   • ビデオ ID
   • ポリシーキー

3. AdConfigId値を再生トークンに置き換えます。

   static let AdConfigId = "your playback token"

4. 再生トークンの値がクエリパラメータとして追加されます。AdConfigId

   let queryParameters = [kBCOVPlaybackServiceParamaterKeyAdConfigId: Constants.AdConfigId]

5. ライブストリーム動画 ID とクエリパラメーターを使用して、Playback API へのカタログ呼び出しを行います。

   playbackService.findVideo(withVideoID: Constants.VideoId, parameters: queryParameters)
     { [weak self] (video: BCOVVideo?, jsonResponse: [AnyHashable: Any]?, error: Error?) -> Void in
     guard let _video = video else {
       print("ViewController Debug - Error retrieving video: \(error?.localizedDescription ?? "unknown error")")
       return
     }
     self?.playbackController?.setVideos([_video] as NSFastEnumeration)
   }

6. プレーヤーはライブストリームを再生する準備ができました。