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가 포함됩니다.

필드는 표시된 순서대로 표시됩니다.

Field Size: 유형 설명
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 bytes int64 BE Elemental Inference Conditioner 타임라인에서 큐아웃의 PTS입니다.
inference_query_timescale 4 bytes 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 값을 전달합니다.