View a markdown version of this page

Charge utile EICM : enrichissement des métadonnées contextuelles - MediaLive
Charge utile EICM version 1Utilisation en aval

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Charge utile EICM : enrichissement des métadonnées contextuelles

La charge utile de la fonctionnalité EICM (Elemental Inference Contextual Metadata) contient les informations dont les consommateurs en aval ont besoin pour interroger AWS Elemental Inference pour obtenir des métadonnées contextuelles au moment de la prise de décision.

Pour plus d'informations sur l'activation de cette fonctionnalité sur votre chaîne, consultezEnrichissement des métadonnées contextuelles.

Cette charge utile suit l'en-tête d'enveloppe AWSE à 9 octets (pour la version 1 du schéma). C'est feature_id dans l'enveloppe"EICM". Voir Enveloppe AWSE UPID la structure de l'enveloppe.

Charge utile EICM version 1

La charge utile EICM commence par un feature_version octet qui identifie la version de la structure de la charge utile. Pour la version 1 (feature_version = 0x01), les champs restants contiennent l'identifiant du flux d'inférence élémentaire, l'URL du plan de données pour les GetMetadata requêtes et le PTS sur la chronologie du conditionneur correspondant au cue-out.

Les champs apparaissent dans l'ordre indiqué.

Champ Size Type Description
feature_version 1 octet uint8 Identifie la version de la structure de charge utile EICM. Actuellement, seul 0x01 est valide ; les champs de la version 1 sont décrits dans les lignes restantes de ce tableau. Une modification de cette valeur indiquerait une modification structurelle des champs restants.
feed_id_length 1 octet uint8 Longueur N du feed_id champ.
feed_id N octets ASCII L'identifiant du flux d'inférence élémentaire (pas de terminaison NUL).
inference_query_url_length 1 octet uint8 Longueur M du inference_query_url champ.
inference_query_url M octets ASCII L'URL du plan de données d'inférence élémentaire pour les GetMetadata requêtes (pas de terminateur NUL, pas de barre oblique de fin).
inference_query_pts 8 octets int64 BE Le PTS du cue-out sur la chronologie du conditionneur d'inférence élémentaire.
inference_query_timescale 4 octets uint32 BE La base de temps inference_query_pts (par exemple, 90000).

La taille totale de la charge utile EICM v1 est d'octets. 15 + N + M Ce total comprend un champ de version de 1 octet, deux champs de longueur 1 octet, les deux chaînes de longueur variable, un champ PTS de 8 octets et un champ d'échelle de temps de 4 octets. Combiné à l'en-tête d'enveloppe à 9 octets (pour la version 1 du schéma), la valeur complète segmentation_upid_length est. 24 + N + M

Important

Les inference_query_timescale valeurs inference_query_pts et peuvent différer du format PTS utilisé par votre sortie. Les systèmes en aval doivent utiliser ces valeurs uniquement pour interroger l'API Elemental InferenceGetMetadata.

Utilisation en aval

Les consommateurs en aval, tels que les systèmes de décision ad (par exemple AWS Elemental MediaTailor), analysent la charge utile EICM et utilisent les champs pour interroger Elemental Inference :

  1. Localisez le segmentation_descriptor with segmentation_type_id = 0x01 et un UPID dont format_identifier il s'agit"AWSE".

  2. Vérifiez feature_id = "EICM" etfeature_version = 0x01.

  3. Extraire feed_idinference_query_url,inference_query_pts, etinference_query_timescale.

  4. Appelez l'GetMetadataAPI Elemental Inference à l'URL extraite, en transmettant l'ID du flux et la valeur PTS.