サポート問い合わせ先| システムステータス
ページコンテンツ

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

    このトピックでは、サーバーサイド広告を含み、ユーザーエクスペリエンスを向上させるためにLiveSSAIのPlayerEnhancementsを利用するBrightcoveNativeSDKを使用してライブストリームを再生する方法を学習します。

    はじめに

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

    Client-side ad components
    クライアント側の広告コンポーネント

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

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

    ステップ

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

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

    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. プレーヤーはライブストリームを再生する準備ができました。

    ページの最終更新日21 May 2021