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

はじめに

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

コンパニオン広告スロットとクリックスルーの動作は、デバイスプラットフォームとアプリが提供する広告 UI によって異なります。接続 TV のすべてがモバイルと同じブラウザベースのクリックスルーを提供するわけではないため、対象デバイスでサポートされる機能を確認してください。

Player Enhancements for Live SSAI には、NextGen Live SSAI ストリームを再生できるネイティブ SDK のバージョンが必要です。

• Android 用ネイティブ SDK 10.4.11 以降（最新リリースを推奨）
• iOS/tvOS 用ネイティブ SDK 7.2.18 以降（最新リリースを推奨）

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

• 概要:ライブ 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 ファイルで、livePlaybackToken の値を再生トークンに置き換えます。

   private final String LIVE_PLAYBACK_TOKEN = "your playback token";

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

   HttpRequestConfig httpRequestConfig = new HttpRequestConfig.Builder()
     .addQueryParameter("livePlaybackToken", LIVE_PLAYBACK_TOKEN)
     .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. LivePlaybackToken の値を再生トークンに置き換えます。

   static let LivePlaybackToken = "your playback token"

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

   let queryParameters = [BCOVPlaybackService.ParameterKeyLivePlaybackToken: Constants.LivePlaybackToken]

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

   let configuration = [BCOVPlaybackService.ConfigurationKeyAssetID: Constants.VideoId]
   playbackService.findVideo(withConfiguration: configuration, queryParameters: queryParameters)
     { [weak self] (video: BCOVVideo?, jsonResponse: 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])
   }

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