View a markdown version of this page

EICM 有效负载：上下文元数据丰富 - MediaLive
EICM 版本 1 有效载荷下游使用情况

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

EICM 有效负载：上下文元数据丰富

EICM（元素推断上下文元数据）功能负载包含下游消费者在广告决策时查询 AWS 元素推断以获取上下文元数据所需的信息。

有关在您的频道上启用此功能的信息，请参阅丰富上下文元数据。

此负载遵循 9 字节 AWSE 信封标头（适用于架构版本 1）。信封feature_id里面是"EICM"。AWSE UPID 信封有关封套结构，请参见。

EICM 版本 1 有效载荷

EICM 负载以标识有效负载结构版本的feature_version字节开头。对于版本 1 (feature_version = 0x01)，其余字段包含元素推断源标识符、GetMetadata查询的数据平面 URL 以及与提示输出对应的调节器时间轴上的 PTS。

字段按所示顺序显示。

字段 Size Type 说明
feature_version 1 字节 uint8 识别 EICM 有效负载结构的版本。当前，0x01仅有效；版本 1 的字段将在该表的其余行中描述。更改此值将表示其余字段的结构发生了变化。
feed_id_length 1 字节 uint8 feed_id字段的长度 N。
feed_id N 字节 ASCII 元素推理源标识符（没有 NUL 终止符）。
inference_query_url_length 1 字节 uint8 inference_query_url字段的长度 M。
inference_query_url M 字节 ASCII 用于GetMetadata查询的元素推理数据平面网址（没有 NUL 终止符，没有尾部斜杠）。
inference_query_pts 8 字节 int64 BE 元素推理调节器时间表上提示的PTS。
inference_query_timescale 4 字节 uint32 BE 的时基inference_query_pts（例如，90000）。

EICM v1 的总有效负载大小为字节。15 + N + M总数包括一个 1 字节版本字段、两个 1 字节长度字段、两个可变长度字符串、一个 8 字节的 PTS 字段和一个 4 字节的时间尺度字段。结合 9 字节的信封标头（适用于架构版本 1），完整内容segmentation_upid_length为24 + N + M。

重要

inference_query_pts和inference_query_timescale值可能与您的输出所使用的 PTS 格式不同。下游系统只能使用这些值来查询元素推断 API GetMetadata。

下游使用情况

下游消费者，例如广告决策系统（例如 AWS Elemental MediaTailor），会解析 EICM 负载并使用这些字段来查询元素推断：

  1. 找到 wit segmentation_descriptor h segmentation_type_id = 0x01 和一个 UPID，其format_identifier是"AWSE"。

  2. 验证feature_id = "EICM"和feature_version = 0x01。

  3. 提取feed_idinference_query_url、inference_query_pts、和inference_query_timescale。

  4. 在提取的网址上调用元素推断 GetMetadata API，传递 Feed ID 和 PTS 值。