IPlayerClientインスタンスから、独立したサービスレイヤーのVideoPlayerインスタンスと通信します。コンテンツ用のメインプレーヤークライアントと、広告ブレーク中にメインプレーヤーと共有しているビデオサーフェスまたは専用のサーフェスで広告を再生する広告プレーヤークライアントで構成される、デュアルプレーヤーアーキテクチャをセットアップします。
このチュートリアルの例は、シームレスな広告遷移のために広告を事前バッファリングする方法を示しています。CSAIの概念、テクニック、同期戦略に関する基本的な知識については、Vegaでのクライアント側広告挿入を参照してください。
このチュートリアルでは、次の方法を学習します。
- プレーヤークライアントの参照とインポートを設定する
- 共有モードまたはデュアルサーフェスモード用のビデオサーフェスを設定する
- 広告マーカーを検出し、広告プレーヤークライアントを事前に初期化する
- 広告がバッファリングされるまで待機した後、メインコンテンツを一時停止する
- ビデオサーフェスを切り替えて広告を再生する
- 広告の終了後にメインコンテンツに戻る
前提条件
- Vega開発環境がセットアップされていること
- Vega SDK v0.22以降
@amazon-devices/kepler-player-clientと@amazon-devices/kepler-player-serverのパッケージがインストールされていること- メインコンテンツプレーヤークライアントが既に初期化され、サービスに接続されていること
- React NativeとTypeScriptに関する基本的な知識
プレーヤークライアントの参照の設定
必要なパッケージをインポートし、メインプレーヤークライアント、広告プレーヤークライアント、セッションID、サーフェスハンドルの参照を作成します。ビデオサーフェスのセットアップ
サーフェスモードを選択します。モードの違いについては、Surfaceモードを参照してください。- 共有サーフェス: 1つの
KeplerVideoSurfaceViewをレンダリングし、そのハンドルをsurfaceHandleRefに保存します。両方のプレーヤーのセッションが順にこのサーフェスを使用します。 - デュアルサーフェス: 広告プレーヤー用のメインサーフェスの上に2番目の
KeplerVideoSurfaceViewをレンダリングし、そのハンドルをadSurfaceHandleRefにキャッシュします。
広告マーカーの検出と広告プレーヤークライアントの事前初期化
位置リスナーで広告ブレークが近づいていることを検出したら、広告プレーヤークライアントをautoPlay=falseとして事前に初期化します。さらに、広告のバッファリング完了と終了を検出するためのリスナーを登録します。
-
位置リスナーを設定して、次に来る広告ブレークを検出します。
-
広告プレーヤークライアントの初期化関数を作成します。ステータスリスナーを登録して、READYとENDEDの状態を検出します。
IPlayerSessionState.READYを利用できないプラットフォームでは、サービスはフォールバックとしてplayerReadyメッセージを送信します。
広告のバッファリングの待機とメインコンテンツの一時停止
広告プレーヤーからREADY(バッファリング完了)が通知され、位置リスナーで広告の開始時間になったことが検出されたら、メインコンテンツを一時停止します。サーフェスの切り替えと広告の再生
メインコンテンツのステータスがPAUSEDに変わったら、広告プレーヤーセッションにサーフェスを与えて広告を再生します。- 共有サーフェス: メインセッションのサーフェスを消去してから、同じサーフェスを広告セッションに設定します。
- デュアルサーフェス: 広告セッションに広告サーフェスを設定します。メインセッションのサーフェスを消去しないでください。

