動画ストリーム内にメタデータを埋め込む

Amazon Interactive Video Service (IVS) の時間指定メタデータは、Amazon IVS ストリームにメタデータを埋め込む方法を提供します。これにより、ストリームのレイテンシーや地理的位置にかかわらず、すべての視聴者が同時に動画ストリームでメタデータを受信できるようになります。

時間指定メタデータとは

時間指定メタデータは、タイムスタンプ付きのメタデータです。IVS API または IVS broadcast SDK を使用して、プログラムでストリームに挿入できます。Amazon IVS がストリームを処理するとき、時間指定メタデータはオーディオフレームおよび動画フレームと同期されます。再生中、ストリームのすべての視聴者は、ストリームに対してメタデータを同時に取得します。タイムコードはキューポイントとして機能します。キューポイントを使用すると、次のようなデータに基づいてアクションをトリガーできます。

Amazon IVS の時間指定メタデータは、動画セグメントに埋め込まれた ID3 タグを使用します。その結果、録画された動画でメタデータが利用可能になります。

IAM アクセス許可のセットアップ

前提条件: IVS 低レイテンシーストリーミングを開始する（IAM ユーザーの作成とアクセス許可の設定を含む）の手順を実行しておく必要があります。

次に、時間指定メタデータを使用するアクセス許可を IAM ユーザーに付与する必要があります。以下のステップに従ってください。

時間指定メタデータの挿入

時間指定メタデータは、指定されたチャネルのアクティブなストリームにのみ挿入できます。

AWS CLI の使用

テストで、時間指定メタデータを追加する最も簡単な方法は、AWS CLI を使用する方法です。AWS CLI を使用するには、まず、マシンで CLI をダウンロードして設定する必要があります。IVS 低レイテンシーストリーミングを開始する を開始する を実行した際に CLI を取得していなかった場合は、今すぐ取得してください。詳細については、AWS コマンドラインインターフェイスのユーザーガイドを参照してください。

CLI の取得後

Amazon IVS API の使用

プログラムで時間指定メタデータを挿入するには、PutMetadata API オペレーションを使用します。

HTTP リクエストの例を次に示します。

POST /PutMetadata HTTP/1.1
{
    "channelArn": "my_channel",
    "metadata": "{\"question\": \"What does IVS stand for?\", \"correctIndex\": 0, \"answers\": [\"interactive video service\", \"interesting video service\", \"ingenious video service\"]}"
}

IVS Broadcast SDK の使用

IVS Broadcast SDK を使用して時間指定メタデータを帯域内に挿入できます。これは、メタデータをオーディオおよびビデオコンテンツと同期させるのに便利な場合があります。

時間指定メタデータの使用

Amazon IVS Player を使用して、動画ストリームに埋め込まれた時間指定メタデータを使用します。IVS プレーヤー SDK およびその他のプレイヤードキュメントを参照してください。

以下は、Amazon IVS Player SDK を使用してコンソールに受信したメタデータを印刷する例です。再生が、メタデータが埋め込まれたセグメントに到達すると、イベントがトリガーされます。(イベントは、ウェブ用が TEXT_METADATA_CUE、Android 用が onCue()、iOS 用が player(_:didOutputCue:) です)。このイベントを使用して、インタラクティブウィジェットの更新など、クライアントアプリケーション内の機能を開始できます。このイベントは、ライブコンテンツと録画コンテンツの両方に対してトリガーされます。

Amazon IVS Player SDK for Web:

const player = IVSPlayer.create();
player.addEventListener(IVSPlayer.PlayerEventType.TEXT_METADATA_CUE,
    function (cue) {
  console.log('Timed metadata: ', cue.text);
});

Amazon IVS Player SDK for Android:

@Override
public void onCue(@NonNull Cue cue) {
  if(cue instanceof TextMetadataCue) {
    Log.i("Timed Metadata: ", ((TextMetadataCue)cue).text);
  }
}

Amazon IVS Player SDK for iOS:

func player(_ player: IVSPlayer, didOutputCue cue: IVSCue) {
  if let textMetadataCue = cue as? IVSTextMetadataCue {
    print("Timed Metadata: \(textMetadataCue.text)")
  }
}

注: 時間指定メタデータは、Player 1.3.0 以降の iOS Safari および iOS Chrome でサポートされています。

サンプルデモ: クイズアプリ

インタラクティブなクイズアプリのコード例は、GitHub で入手できます。時間指定メタデータを介して JSON を使用し、クイズ UI を設定して質問と回答を表示します。回答は選択可能であり、選択が正しいかどうかが表示されます。

時間指定メタデータの表示

必要に応じて、ライブストリームに埋め込まれた時間指定メタデータをコンソールで表示できます。

追加情報

Amazon IVS の時間指定メタデータの使用に関する 2 部構成のブログシリーズの最初の部分である、Using Amazon Interactive Video Service Timed Metadata を参照してください。