Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
Vegaは、プレーヤーがコンテンツから広告への切り替えを管理するための3つの広告挿入技法をサポートしています。これらの技法は、複数の広告を繋ぎ合わせてストリームにするサーバー側広告挿入とは対照的です。これらの技法は、広告の決定をどれが事前に行うか(アプリ、マニフェストマーカーにあるクライアント、サーバー)という点で互いに異なります。
  • CSAI - 帯域外: アプリが、マニフェストマーカーではなく外部スケジュールを使用して、広告を挿入するタイミングを決定します。アプリがVASTまたはVMAPを取得し、クリエイティブを再生します。
  • CSAI - 帯域内境界マーカー: マニフェストが、何を再生するかを示すのではなく、広告ブレークをどこに置くかを示します。クライアントはマーカーを検出し、VASTを取得して広告を決定します。
  • SGAI - サーバー誘導: マニフェストには再生可能な広告のURLが格納されます。何をプレイするかはサーバーが既に決定しているため、プレーヤーはそのプレイ対象を直接取得して再生します。
上記3つのいずれの場合も、コンテンツストリームは変更されず、プレーヤーがコンテンツ再生と広告再生の間の切り替えを、1つの共有サーフェスで行うか、メインコンテンツのサーフェスと広告のサーフェスで別々に行います。

広告挿入技法

CSAI - 帯域外(スタンダード)

標準のCSAIでは、マニフェストタグではなく外部情報に基づいて、クライアントアプリが広告の挿入タイミングを決定します。プレーヤーは、変更されていないコンテンツマニフェストを受け取り、広告ロジックを自身で処理します。 広告のタイミングはマニフェストの外部で決定されます。決定元としては以下があります。
  • VMAP: プレーヤーが、特定のタイムスタンプ(0秒、300秒など)に広告ブレークをスケジュールする外部XMLファイルを取得します。
  • ハードコードされたロジック: アプリが、プレーヤーの現在の時間位置に基づいて一定の間隔(20秒ごとなど)で広告リクエストをトリガーします。
  • サイドカーファイル: アプリが、特定のコンテンツ片に対する広告ブレーク時間のリストを含む別個の構成ファイル(JSON/XML)をコンテンツ管理システム(CMS)からダウンロードします。
  • 広告SDK: SDK(Google Interactive Media Adsなど)が、広告ルールに基づいて内部でタイミングを管理します。この場合、開発者が特定のタイムスタンプやマニフェストタグを管理する必要はありません。
フロー: アプリが広告ブレーク時間を決定→VASTを取得→クリエイティブを再生 帯域外の一般的な実装では、UIレイヤーで広告マーカーが定義され(ハードコードやスケジュールからの取得など)、位置リスナーが挿入を直接トリガーします。サービスレイヤーには広告情報は送信されません。

CSAI - 帯域内境界マーカー(上級者向け)

上級者向けであるCSAIでは、マニフェストには「ここで広告ブレーク」を示すマーカーが含まれますが、広告URLは含まれません。何を再生するかはクライアントが決定する必要があります。 一般的な境界マーカーとしては以下のものがあります。 プレーヤーは、境界マーカー(#EXT-X-CUE-OUTなど)を検出すると、それを広告の提供機会として解釈し、指定されている期間に応じて広告サーバーへのVASTリクエストまたはVMAPリクエストを開始します。広告コンテンツは、メインコンテンツが再生され続けている間に同時に取得され、バッファリングされます。メインコンテンツは、広告の表示時間に到達したときにのみ一時停止されます。この時点までには広告が再生可能な状態になっていると想定され、シームレスなエクスペリエンスが実現します。 フロー: マニフェストを解析→境界を検出→クライアントがVASTを取得→決定→クリエイティブを再生 ヘッドレスアプローチを使用する帯域内実装では、UIからsendMessage({type: 'adList', ads})を通じてサービスレイヤーに広告リストを送信して、マニフェスト解析で生成されるのと同じデータを提供できます。サービスはPlayerSessionに広告リストを保存し、getCurrentPlaybackPosition()の実行時に広告マーカーを処理します。広告のプレバッファリング枠に到達すると(startTimeの5秒前)、サービスはUIに{type: 'adMarkers', ad}メッセージを送り返します。これにより、広告の挿入がトリガーされます。

SGAI - サーバー誘導広告挿入

サーバー誘導広告挿入 (SGAI) では、マニフェストには「このURLを再生」(広告URLは既に存在)を意味するマーカーが格納されます。再生内容はサーバー側で既に決定されています。プレーヤーはマニフェストの解析中に広告を見つけ、埋め込まれたURLからクリエイティブを取得して再生します。 SGAIマーカーとしては以下のものがあります。 CSAIの場合とは異なり、VAST解析や広告SDKは必要ありません。プレーヤーは、マニフェストの解析、広告URLの検出、広告メディアの取得、コンテンツの一時停止、広告ストリームの再生、コンテンツの再開を行います。また、プレーヤーはX-RESTRICT(スキップ/ジャンプの制限)属性とCUE(プレロールとポストロールの動作)属性の適用も行います。 フロー: マニフェストを解析→広告URLを抽出→取得と再生(VASTなし、広告SDKなし)。 CSAIとの主な相違点:
  • アプリは広告タグのURLを提供しません。マニフェストは広告のスケジュールになります。
  • VASTまたはVMAPの解析は不要です。URLが、再生可能な.m3u8メディアまたは.mpdメディアを直接指しているためです。
  • どの広告を配信するかは、サーバーが事前に決定します。クライアント側のリアルタイムパーソナライゼーションは利用できません。
  • マニフェストはCDNでキャッシュできます(SSAIと違って視聴者ごとにパーソナライズすることはできません)。
SGAIは、ライブコンテンツやVODコンテンツへのプレロールおよびミッドロールの挿入に適しています。これらの挿入では、コンテンツプロバイダーがパッケージング時に広告の選択を制御します。

サーフェスモード

3つの広告挿入技法はどれも コンテンツのメインプレーヤーと広告用である広告プレーヤーから成るデュアルプレーヤーアーキテクチャを採用しています。プレーヤーは1つのビデオサーフェスを共有することも、それぞれ独自のビデオサーフェスを持つこともできます。

単一サーフェス(共有)

メインプレーヤーと広告プレーヤーの両方が同じKeplerVideoSurfaceViewを共有します。広告プレーヤーでサーフェスにレンダリングするには、その前にメインプレーヤーでサーフェスを解放する必要があります。
  • JSアプローチ: clearSurfaceHandle(surfaceHandle)メインプレーヤーを呼び出し、次に広告プレーヤーを呼び出しますsetSurfaceHandle(surfaceHandle)。
  • ヘッドレスアプローチ: メインプレーヤーセッションでclearVideoView(sessionId)を呼び出し、次に広告プレーヤーセッションでsetVideoView(surfaceHandle, sessionId)を呼び出します。
広告が終了すると、広告プレーヤーがサーフェスを解放し、メインプレーヤーがそのサーフェスを再度設定してから、コンテンツが再開されます。

デュアルサーフェス

各プレーヤーには専用のKeplerVideoSurfaceViewがあります。広告サーフェスは、zIndexの順序指定を使用して、メインコンテンツのサーフェスの上に重ねて配置されます。メインプレーヤーは、広告の再生時にサーフェスを解放する必要がないほか、広告の終了時にそのサーフェスを再度設定する必要もありません。

サーフェスビューのレイアウト (JSX)

メインコンテンツのサーフェスはzIndex: 1を使用し、広告サーフェスはzIndex: 2を使用するため、広告は上部にレンダリングされます。
広告が再生されていないときは広告サーフェスが透明になるため、メインコンテンツが表示されます。広告プレーヤーがフレームをレンダリングすると、下にあるメインコンテンツがフレームで覆われます。

縦横比が異なる広告の処理(デュアルサーフェス)

広告とメインコンテンツの縦横比が同じ場合(両方とも16:9の場合など)、広告サーフェスはメインコンテンツの上に直接重ねて表示されます。追加の処理は必要ありません。 広告の縦横比がメインコンテンツと異なる場合は、サイズの不一致が原因で、非アクティブなサーフェスがアクティブなサーフェスの背後に表示されることがあります。これを防ぐには、オフスクリーンレンダリングを使用して非アクティブなサーフェスを画面外に移動します。
これを実装するには、const [adSurfaceVisible, setAdSurfaceVisible] = useState(false)状態変数を追加して、その状態変数を、広告の開始時刻にはtrueに、終了時刻にはfalseに切り替えます。

再生の同期戦略

3つの広告挿入技法のいずれでも、遷移中にメインプレーヤーと広告プレーヤーを調整するための2つの戦略がサポートされます。共有サーフェスとデュアルサーフェスのいずれを使用するかによって、サーフェスに関する手順は異なってきます。

広告の事前バッファリング(シームレス)

遷移が発生する前に、広告プレーヤーを事前に初期化してバッファリングします。これにより、視覚的な中断のないギャップレスなユーザーエクスペリエンスが提供されます。
  1. メインコンテンツが再生されます。
  2. 広告マーカーが検出されます。広告プレーヤーを事前にautoPlay=falseとして初期化します。
  3. 広告プレーヤーがバッファリングを行います。canplayイベントが生成されるか (JS)、サービスからREADYステータスが送信されます(ヘッドレス)。
  4. UIが準備完了のシグナルを受け取ります。広告が再生できる状態になり、スケジュールされた再生時間まで待機します。
  5. 位置リスナーが、広告の再生時間に到達したことを検出します。メインコンテンツを一時停止します。
  6. メインコンテンツが一時停止されます。広告に切り替え、広告を再生します。
    • 共有サーフェス: メインサーフェスを消去し、同じサーフェスを広告プレーヤーに設定して、広告を再生します。
    • デュアルサーフェス: 広告プレーヤーに広告サーフェスを設定し、広告を再生します。メインサーフェスを消去しないこと。
  7. 広告が終了します。広告サーフェスを消去し、広告プレーヤーをクリーンアップして、メインコンテンツを再開します。
    • 共有サーフェス: 再開する前に、メインプレーヤーのメインサーフェスを再度設定すること。
    • デュアルサーフェス: メインコンテンツを再開すること。メインサーフェスは消去されていないため、再度設定する必要はありません。
次の特徴があります。
  • 視覚的な中断は生じません。
  • 広告コンテンツは再生前にプレバッファリングされます。
  • プレミアム視聴エクスペリエンスに最適です。
  • autoPlayの設定:false(手動制御)

広告のインスタント自動再生(ギャップあり)

広告ブレークの発生時に、オンデマンドで広告プレーヤーを初期化します。広告はautoPlay=trueを通じて再生時に読み込まれるため、広告プレーヤーの初期化時に短時間の遷移ギャップが生じることがあります。
  1. メインコンテンツが再生されます。
  2. 広告マーカーが検出されます。メインコンテンツを一時停止します。
  3. メインコンテンツが一時停止されます。autoPlay=trueを指定して広告プレーヤーを初期化します。
    • 共有サーフェス: 最初にメインサーフェスを消去すること。
    • デュアルサーフェス: メインサーフェスを消去しないこと。
  4. 広告プレーヤーの準備が整います。広告プレーヤーにサーフェス(共有サーフェス、または、デュアルサーフェスモードの場合は広告サーフェス)を設定します。再生が自動的に開始されます。
  5. 広告が終了します。広告サーフェスを消去し、広告プレーヤーをクリーンアップして、メインコンテンツを再開します。
    • 共有サーフェス: 再開する前に、メインプレーヤーのメインサーフェスを再度設定すること。
    • デュアルサーフェス: メインコンテンツを再開すること。メインサーフェスを再度設定する必要はありません。
次の特徴があります。
  • 遷移中に画面が一時的に黒くなったり、一時停止したりすることがあります。
  • 広告はオンデマンドで読み込まれます。
  • よりシンプルな実装です。
  • autoPlayの設定:true(自動再生)

広告の長さの強制

定義されている広告の長さが実際のメディアの再生時間よりも短い場合は、位置リスナーまたは時間更新リスナーを使用して、適切な時間で広告を強制終了できます。
ヘッドレスアプローチでは、広告プレーヤーセッションに登録した位置リスナーを使用して現在の位置を確認し、想定されている広告の長さと照合します。

連続広告

広告ブレークに複数の連続した広告が含まれる場合は、デバイスの性能に応じて次の3つのアプローチを使用できます。
  • 単一の広告プレーヤー(リソースに制約のあるデバイス向け): 広告プレーヤーを一度に1つだけ作成して、広告を1つずつ再生します。この方法では、シームレスでギャップレスな遷移は実現できない可能性があります。メモリやデコーダーが限られているデバイスにのみ推奨されます。
  • 複数の広告プレーヤー(高性能デバイス向け): 広告プレーヤーインスタンスを2つ使用して、広告を連続でシームレスに再生します。連続する広告間をギャップレスで遷移できます。十分なデバイスリソースが必要です。
  • メインコンテンツプレーヤーの再作成(代替アプローチ): メインコンテンツの現在の再生位置を保存します。最後の広告の再生中にメインプレーヤーを再作成します。こうすることで、リソースに制約のあるデバイスでも2つの個別の広告プレーヤーを作成できます。

問題点

クライアント側またはサーバー誘導での広告挿入を実装する際は、以下の問題点を考慮してください。
  • バッファリングと遅延: 広告がオンデマンドで読み込まれる場合(インスタント広告)、コンテンツを一時停止して広告を読み込むと、バッファリングや遅延が発生する可能性があります。これを解決するには、実際の表示時間に到達する前に広告コンテンツをプレバッファリングし、十分にバッファリングされた後にのみメインコンテンツを一時停止します。
  • デバイスの互換性: デバイスのハードウェア機能(メモリ、デコーダー、処理能力)はさまざまであるため、デバイスが異なると性能も異なります。
  • 単一サーフェスのレンダリング: 広告は、メインコンテンツの最後のフレームをレンダリングした後の最初のフレームから再生する必要があります。サーフェスの切り替え中にフレームの欠落や重なりが発生しないようにしてください。この問題点は、デュアルサーフェスモードでは別々のサーフェスを使用するため回避できます。
  • サーフェスの消去時の黒いフラッシュ: 共有サーフェスモードでは、clearSurfaceHandle (JS) またはclearVideoView(ヘッドレス)を呼び出すと表示バッファーが消去され、メインコンテンツの最後のフレームと広告の最初のフレームの間に黒いフレームが表示されます。この問題点が発生しないようにするには、デュアルサーフェスモードを使用してください。

実装アプローチの選択

Vegaでは、CSAIとSGAIの実装方法として2つのアプローチを提供しています。どちらも共有サーフェスモードとデュアルサーフェスモードをサポートしますが、アプリのアーキテクチャに合ったアプローチを選択してください。

JSアプローチ

JSアプローチでは、React Nativeコンポーネントを直接統合し、UIコンポーネントレイヤー内でVideoPlayerインスタンスを作成して管理します。アプリはW3C Media APIに直接アクセスし、メソッドを直接呼び出して再生を制御します。
共有サーフェスモードでは、両方のプレーヤーが順にメインサーフェスへのレンダリングを行います。デュアルサーフェスモードでは、広告プレーヤーがメインサーフェスの上にある独自のサーフェスにレンダリングします。 このアプローチは次のような場合に使用します。
  • アプリでシングルスレッドのReact Nativeアーキテクチャを使用している。
  • W3C Media APIに直接アクセスする必要がある。
  • コンポーネントレベルのシンプルなプレーヤー管理を利用したい。
パッケージ:@amazon-devices/react-native-w3cmedia このアプローチを実装するには、JSアプローチを使用したクライアント側広告挿入の実装を参照してください。

ヘッドレスアプローチ

ヘッドレスアプローチは、クライアント/サーバーアーキテクチャを使用します。UIレイヤーのIPlayerClientインスタンスが、独立したサービスレイヤーで管理されるVideoPlayerインスタンスと通信します。これはKeplerPlayerClientTurboModuleを介して行われ、高パフォーマンスのプロセス間通信 (IPC) を提供するJavaScript Interface (JSI) が使用されます。
共有サーフェスモードでは、両方のプレーヤープレーヤーが順にメインサーフェスへのレンダリングを行います。デュアルサーフェスモードでは、広告プレーヤーセッションがメインサーフェスの上にある独自のサーフェスにレンダリングします。 このアプローチは次のような場合に使用します。
  • アプリでマルチスレッドアーキテクチャを使用して、UIレイヤーとサービスレイヤーを分離している。
  • JSIベースのIPCによるパフォーマンス上のメリットを必要としている。
  • PlayerSessionによるセッションベースのプレーヤー管理を利用したい。
パッケージ: VegaプレーヤークライアントおよびVegaプレーヤーサーバー このアプローチを実装するには、ヘッドレスアプローチを使用したクライアント側広告挿入の実装を参照してください。

関連コンテンツ


最終更新日 2026年10月5日