View a markdown version of this page

EICM-Payload: Kontextuelle Metadatenanreicherung - MediaLive
EICM-Nutzlast, Version 1Nutzung im Downstream

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

EICM-Payload: Kontextuelle Metadatenanreicherung

Die Nutzlast der Funktion EICM (Elemental Inference Contextual Metadata) enthält die Informationen, die nachgeschaltete Verbraucher benötigen, um AWS Elemental Inference zum Zeitpunkt der Anzeigenentscheidung nach kontextbezogenen Metadaten abzufragen.

Informationen zur Aktivierung dieser Funktion auf deinem Kanal findest du unter. Kontextuelle Metadatenanreicherung

Diese Nutzlast folgt dem 9-Byte-AWSE-Envelope-Header (für Schemaversion 1). Das feature_id im Umschlag ist. "EICM" Siehe AWSE UPID-Umschlag für die Hüllstruktur.

EICM-Nutzlast, Version 1

Die EICM-Nutzlast beginnt mit einem feature_version Byte, das die Version der Nutzlaststruktur identifiziert. Für Version 1 (feature_version = 0x01) enthalten die verbleibenden Felder die Elemental Inference-Feed-ID, die URL der Datenebene für GetMetadata Abfragen und den PTS auf der Conditioner-Zeitleiste, der dem Cue-Out entspricht.

Die Felder werden in der angegebenen Reihenfolge angezeigt.

Feld Größe Typ Description
feature_version 1 Byte uint8 Identifiziert die Version der EICM-Payload-Struktur. Derzeit 0x01 ist nur gültig; die Felder für Version 1 werden in den verbleibenden Zeilen dieser Tabelle beschrieben. Eine Änderung dieses Werts würde auf eine strukturelle Änderung der verbleibenden Felder hinweisen.
feed_id_length 1 Byte uint8 Länge N des feed_id Feldes.
feed_id N Byte ASCII Die Feed-ID der elementaren Inferenz (kein NUL-Terminator).
inference_query_url_length 1 Byte uint8 Länge M des Feldes. inference_query_url
inference_query_url M Byte ASCII Die URL der Elemental Inference-Datenebene für GetMetadata Abfragen (kein NUL-Terminator, kein abschließender Schrägstrich).
inference_query_pts 8 Bytes int64 BE Das PTS des Cue-Outs auf der Timeline des Elemental Inference Conditioners.
inference_query_timescale 4 Bytes uint32 BE Die Zeitbasis von inference_query_pts (zum Beispiel 90000).

Die gesamte EICM v1-Nutzlastgröße beträgt Byte. 15 + N + M Diese Summe umfasst ein 1-Byte-Versionsfeld, zwei Felder mit einer Länge von 1 Byte, die beiden Zeichenfolgen mit variabler Länge, ein 8-Byte-PTS-Feld und ein 4-Byte-Zeitskalenfeld. In Kombination mit dem 9-Byte-Envelope-Header (für Schemaversion 1) ergibt sich der Gesamtwert. segmentation_upid_length 24 + N + M

Wichtig

Die inference_query_timescale Werte inference_query_pts und können von dem PTS-Format abweichen, das Ihre Ausgabe verwendet. Downstream-Systeme dürfen diese Werte nur verwenden, um die Elemental Inference GetMetadata API abzufragen.

Nutzung im Downstream

Nachgeschaltete Verbraucher, wie z. B. Anzeigenentscheidungssysteme (z. B. AWS Elemental MediaTailor), analysieren die EICM-Nutzlast und verwenden die Felder, um Elemental Inference abzufragen:

  1. Suchen Sie das segmentation_descriptor mit segmentation_type_id = 0x01 und eine UPID, deren Wert ist. format_identifier "AWSE"

  2. Überprüfen Sie feature_id = "EICM" und. feature_version = 0x01

  3. Extrahieren inference_query_url Sie feed_idinference_query_pts,, undinference_query_timescale.

  4. Rufen Sie die Elemental Inference GetMetadata API unter der extrahierten URL auf und übergeben Sie die Feed-ID und den PTS-Wert.