Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
メインコンテンツへスキップ
このチュートリアルでは、JSアプローチを使用してVegaアプリにクライアント側広告挿入(CSAI)を実装します。このアプローチでは、React Nativeコンポーネントを直接統合し、UIコンポーネントレイヤー内でVideoPlayerインスタンスを作成して管理します。コンテンツ用のメインプレーヤーと、広告ブレーク中に共有ビデオサーフェスを置き換える広告プレーヤーで構成される、デュアルプレーヤーアーキテクチャをセットアップします。 このチュートリアルの例は、シームレスな広告遷移のために広告を事前バッファリングする方法を示しています。CSAIの概念、テクニック、同期戦略に関する基本的な知識については、Vegaでのクライアント側広告挿入を参照してください。 このチュートリアルでは、次の方法を学習します。
  • プレーヤーの参照とインポートを設定する
  • 広告マーカーを検出し、広告プレーヤーを事前に初期化する
  • 広告がバッファリングされるまで待機した後、メインコンテンツを一時停止する
  • ビデオサーフェスを切り替えて広告を再生する
  • 広告の終了後にメインコンテンツに戻る

前提条件

  • Vega開発環境がセットアップされていること
  • Vega SDK v0.22以降
  • @amazon-devices/react-native-w3cmediaパッケージがインストールされていること
  • メインコンテンツプレーヤーが既に初期化され、再生されること
  • React NativeとTypeScriptに関する基本的な知識

プレーヤーの参照の設定

必要なコンポーネントをインポートし、メインプレーヤー、広告プレーヤー、共有サーフェスハンドルの参照を作成します。

広告マーカーの検出と広告プレーヤーの事前初期化

アプリで広告ブレークが近づいていることを検出したら(たとえば、広告の開始時間の5秒前になったら)、広告プレーヤーを事前に初期化し、autoPlay=falseとして広告コンテンツのバッファリングを開始します。
  1. メインプレーヤーにtimeupdateリスナーを登録して、次に来る広告ブレークを検出します。
  2. 広告プレーヤーの初期化関数を作成します。再生を開始するタイミングを手動で制御できるように、autoPlayをfalseに設定します。

広告のバッファリングの待機とメインコンテンツの一時停止

広告プレーヤーからバッファリングの完了(canplay)が通知され、広告の開始時間に到達したら、メインコンテンツを一時停止します。

サーフェスの切り替えと広告の再生

メインコンテンツが一時停止したら、メインプレーヤーのサーフェスを消去して広告プレーヤーに割り当てます。

メインコンテンツへの復帰

広告が終了したら、広告サーフェスを消去し、広告プレーヤーをクリーンアップして、メインコンテンツを再開します。

リソースのクリーンアップ

コンポーネントのマウントが解除されるかプレーヤーセッションが終了したら、両方のプレーヤーの初期化を解除し、サーフェスハンドルを解放します。

関連コンテンツ


最終更新日 2026年10月26日