View a markdown version of this page

EICM ペイロード: コンテキストメタデータエンリッチメント - MediaLive
EICM バージョン 1 ペイロードダウンストリームの使用状況

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

EICM ペイロード: コンテキストメタデータエンリッチメント

EICM (Elemental Inference Contextual Metadata) 機能ペイロードには、ダウンストリームコンシューマーが広告決定時にコンテキストメタデータを AWS Elemental Inference にクエリする必要がある情報が含まれています。

チャネルでこの機能を有効にする方法については、「」を参照してくださいコンテキストメタデータエンリッチメント。

このペイロードは、9 バイトの AWSE エンベロープヘッダー (スキーマバージョン 1 の場合) に従います。エンベロープfeature_idの は です"EICM"。エンベロープ構造AWSE UPID エンベロープについては、「」を参照してください。

EICM バージョン 1 ペイロード

EICM ペイロードは、ペイロード構造バージョンを識別するfeature_versionバイトで始まります。バージョン 1 (feature_version = 0x01) の場合、残りのフィールドには、Elemental Inference フィード識別子、GetMetadataクエリのデータプレーン URL、キューアウトに対応するコンディショナータイムラインの PTS が含まれます。

フィールドは表示された順序で表示されます。

フィールド サイズ 型 説明
feature_version 1 バイト uint8 EICM ペイロード構造のバージョンを識別します。現在、 0x01 のみが有効です。バージョン 1 のフィールドは、このテーブルの残りの行で説明されています。この値を変更すると、残りのフィールドの構造的な変更が示されます。
feed_id_length 1 バイト uint8 feed_id フィールドの長さ N。
feed_id N バイト ASCII Elemental Inference フィード識別子 (NUL ターミネーターなし）。
inference_query_url_length 1 バイト uint8 inference_query_url フィールドの長さ M。
inference_query_url M バイト ASCII GetMetadata クエリの Elemental Inference データプレーン URL (NUL ターミネーターなし、末尾のスラッシュなし）。
inference_query_pts 8 バイト int64 BE Elemental Inference コンディショナータイムラインのキューアウトの PTS。
inference_query_timescale 4 バイト uint32 BE のタイムベース inference_query_pts (90000 など）。

EICM v1 ペイロードの合計サイズは15 + N + Mバイトです。この合計には、1 バイトバージョンフィールド 1 つ、1 バイト長フィールド 2 つ、可変長文字列 2 つ、8 バイト PTS フィールド 1 つ、4 バイトのタイムスケールフィールド 1 つが含まれます。9 バイトのエンベロープヘッダー (スキーマバージョン 1 の場合) と組み合わせると、完全な segmentation_upid_lengthは です24 + N + M。

重要

inference_query_pts および のinference_query_timescale値は、出力で使用する PTS 形式とは異なる場合があります。ダウンストリームシステムは、これらの値を Elemental Inference GetMetadata API のクエリにのみ使用する必要があります。

ダウンストリームの使用状況

広告決定システム ( など AWS Elemental MediaTailor) などのダウンストリームコンシューマーは、EICM ペイロードを解析し、 フィールドを使用して Elemental Inference をクエリします。

  1. segmentation_type_id = 0x01 と、 が である UPID segmentation_descriptorを持つ を見つけformat_identifierます"AWSE"。

  2. feature_id = "EICM" と を検証しますfeature_version = 0x01。

  3. feed_id、inference_query_url、inference_query_pts、および を抽出しますinference_query_timescale。

  4. 抽出された URL で Elemental Inference GetMetadata API を呼び出し、フィード ID と PTS 値を渡します。