도메인 변수 사용 - AWS Elemental MediaTailor
동적 변수로 사용할 구성 별칭 생성구성 별칭을 사용하여 세션의 도메인을 동적으로 구성합니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

도메인 변수 사용

동적 도메인 변수를 사용하면 구성의 플레이어 매개변수와 함께 URL my-ads-serverhttp://.com의 my-ads-server .com 부분과 같은 여러 도메인을 사용할 수 있습니다. 이렇게 하면 단일 구성에서 둘 이상의 콘텐츠 소스 또는 광고 결정 서버 (ADS) 를 사용할 수 있습니다.

URI가 포함된 모든 매개변수와 함께 도메인 변수를 사용할 수 있습니다.

  • AdDecisionServerUrl

  • AdSegmentUrlPrefix

  • ContentSegmentUrlPrefix

  • LivePreroll.AdDecisionServerUrl

  • VideoContentSourceUrl

도메인 변수는 구성 별칭과 함께 사용하여 동적 변수 대체를 수행합니다. 구성 별칭은 일련의 별칭과 값을 동적 도메인 구성에 사용되는 플레이어 매개변수에 매핑합니다.

동적 변수로 사용할 구성 별칭 생성

도메인 변수를 사용하기 전에 먼저 구성의 구성 별칭을 만들어야 합니다. 세션 초기화 시 구성 별칭을 도메인 대체 변수로 사용합니다. 예를 들어 구성 별칭을 사용하여 세션 초기화 중에 원본 URL을 동적으로 구성할 수 있습니다.

구성 별칭 생성

MediaTailor콘솔을 사용하여 도메인 대체에 사용할 구성 별칭을 만들려면 다음 절차를 수행하십시오.

콘솔을 사용하여 구성 별칭을 만들려면

  1. https://console.aws.amazon.com/mediatailor/ 에서 MediaTailor 콘솔을 엽니다.

  2. 구성 페이지의 구성 별칭 섹션에서 플레이어 파라미터 추가를 선택합니다.

  3. 도메인 대체를 위한 동적 변수로 사용할 플레이어 파라미터 이름을 입력합니다. 이름 앞에 를 붙여야 합니다. player_params.

  4. 확인(OK)을 선택합니다.

    AWS Elemental MediaTailor구성 별칭 섹션의 표에 새 매개변수를 표시합니다.

  5. 이제 별칭과 값을 추가해 보겠습니다. 방금 이름을 지정한 플레이어 매개변수를 선택합니다. 이렇게 하면 파라미터 이름 아래 섹션이 확장됩니다.

    새 별칭 추가를 선택합니다.

  6. 앨리어스 키와 값을 입력합니다. 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