기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
도메인 변수 사용
동적 도메인 변수를 사용하면 구성의 플레이어 매개변수와 함께 my-ads-serverURLmy-ads-serverhttp://.com의.com 부분과 같은 여러 도메인을 사용할 수 있습니다. 이렇게 하면 단일 구성에서 둘 이상의 콘텐츠 소스 또는 광고 결정 서버 (ADS) 를 사용할 수 있습니다.
다음이 포함된 모든 매개변수와 함께 도메인 변수를 사용할 수 있습니다URI.
-
AdDecisionServerUrl
-
AdSegmentUrlPrefix
-
ContentSegmentUrlPrefix
-
LivePreroll.AdDecisionServerUrl
-
VideoContentSourceUrl
도메인 변수는 구성 별칭과 함께 사용하여 동적 변수 대체를 수행합니다. 구성 별칭은 일련의 별칭과 값을 동적 도메인 구성에 사용되는 플레이어 매개변수에 매핑합니다.
동적 변수로 사용할 구성 별칭 생성
도메인 변수를 사용하기 전에 먼저 구성의 구성 별칭을 만들어야 합니다. 세션 초기화 시 구성 별칭을 도메인 대체 변수로 사용합니다. 예를 들어, 구성 별칭을 사용하여 세션 초기화 중에 오리진을 URL 동적으로 구성할 수 있습니다.
구성 별칭 생성
MediaTailor콘솔을 사용하여 도메인 대체에 사용할 구성 별칭을 만들려면 다음 절차를 수행하십시오.
콘솔을 사용하여 구성 별칭을 만들려면
에서 MediaTailor https://console.aws.amazon.com/mediatailor/
콘솔을 엽니다. -
구성 페이지의 구성 별칭 섹션에서 플레이어 파라미터 추가를 선택합니다.
-
도메인 대체를 위한 동적 변수로 사용할 플레이어 파라미터 이름을 입력합니다. 이름 앞에 를 붙여야 합니다.
player_params.
-
확인을 선택합니다.
AWS Elemental MediaTailor 구성 별칭 섹션의 표에 새 매개변수를 표시합니다.
-
이제 별칭과 값을 추가해 보겠습니다. 방금 이름을 지정한 플레이어 매개변수를 선택합니다. 이렇게 하면 파라미터 이름 아래 섹션이 확장됩니다.
새 별칭 추가를 선택합니다.
-
앨리어스 키와 값을 입력합니다. MediaTailor Value를 도메인 변수의 대체 값으로 사용합니다.
구성 별칭을 사용하여 세션의 도메인을 동적으로 구성합니다.
구성 별칭을 설정한 후에는 세션 초기화 요청에서 이를 도메인의 대체 변수로 사용할 수 있습니다. 이렇게 하면 세션의 도메인을 동적으로 구성할 수 있습니다.
제한 사항
구성 별칭을 사용할 때는 다음 제한 사항에 유의하십시오.
-
도메인에서 사용되는 모든 동적 변수는
ConfigurationAliases
동적 변수로 정의되어야 합니다. -
플레이어 파라미터 변수에는 접두사가 붙어야 합니다.
player_params.
예:player_params.origin_domain
. -
앨리어싱된 값 목록은 모든 플레이어 파라미터의 전체 목록을 포함해야 합니다.
-
도메인에서 사용되는 동적 값을 요청했는데 해당 요청이 동적 변수나 해당 변수에 대해 사전 구성된 별칭 중 하나를 지정하지 않으면 상태 코드와 함께 요청이 실패합니다. HTTP
400
예 사용 예
구성 별칭과 동적 도메인 변수를 포함하는 구성의 예는 다음과 같습니다. 플레이어 파라미터 변수 (예[player_params.origin_domain]
: AdDecisionServerUrl
및 VideoContentSourceUrl
파라미터 도메인) 에 특히 주의하십시오.
PUT /playbackConfiguration
{
"Name": "aliasedConfig",
...
"AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
"VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
...
"ConfigurationAliases": {
"player_params.origin_domain": {
"pdx": "abc",
"iad": "xyz"
},
"player_params.region": {
"pdx": "us-west-2",
"iad": "us-east-1"
},
"player_params.endpoint_id": {
"pdx": "abcd",
"iad": "wxyz"
},
"player_params.ad_type": {
"customized": "abc12345",
"default": "defaultAdType"
},
},
...
}
위 구성을 사용하여 플레이어 변수와 별칭을 지정하여 세션 초기화 요청을 생성합니다.
POST master.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized"
}
}
MediaTailor 별칭 문자열을 구성 앨리어스 구성의 매핑된 값으로 대체합니다.
에 대한 요청은 다음과 같습니다. ADS
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
에 대한 요청은 VideoContentSource
다음과 같습니다.
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd