MediaTailor에서 구성 별칭 생성 및 사용 - AWS Elemental MediaTailor
1단계: 구성 별칭 생성2단계: 세션 초기화에서 구성 별칭 사용

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

MediaTailor에서 구성 별칭 생성 및 사용

도메인 변수를 사용하기 전에 구성에 대한 구성 별칭을 생성합니다. 세션 초기화 시 구성 별칭을 도메인 대체 변수로 사용합니다.

제한 사항

구성 별칭을 사용할 때 다음 제한 사항에 유의하세요.

  • 도메인에 사용되는 모든 동적 변수는 ConfigurationAliases 동적 변수로 정의되어야 합니다.

  • 플레이어 파라미터 변수에는 접두사가 붙어야 합니다player_params.. 예를 들어 player_params.origin_domain입니다.

  • 별칭이 지정된 값 목록은 중요한 URLs(VideoContentSourceUrl, AdSegmentUrlPrefix, ContentSegmentUrlPrefix)의 도메인 변수에 대해 포괄적이어야 합니다.

  • 동적 변수를 지정하지 않거나 잘못된 별칭을 사용하는 중요한 URLs의 도메인 변수에 대한 요청이 이루어진 경우 HTTP 400 상태 코드와 함께 요청이 실패합니다. 중요하지 않은 필드(SlateAdUrl, TranscodeProfileName, 범퍼 URLs)는 경고를 로깅하지만 요청에 실패하지는 않습니다.

누락된 별칭에 대한 대체 동작

구성 별칭을 찾을 수 없거나 유효하지 않은 경우 MediaTailor는 다음 대체 동작을 구현합니다.

  • 도메인 변수: 도메인 변수 별칭이 누락되었거나 유효하지 않은 경우 HTTP 400 상태 코드와 함께 요청이 실패합니다. 모든 도메인 변수에는 유효한 별칭이 정의되어 있어야 합니다.

  • 비도메인 변수: URLs의 비도메인 부분에 사용되는 변수(예: 경로 요소 또는 쿼리 파라미터)의 경우 별칭이 누락되면 빈 문자열이 대체됩니다.

  • 구성 검증: MediaTailor는 구성 생성 및 업데이트 작업 중에 필요한 모든 별칭이 있는지 확인합니다.

1단계: 구성 별칭 생성

MediaTailor 콘솔을 사용하여 도메인 교체에 사용할 구성 별칭을 생성하려면 다음 절차를 수행합니다.

Console
콘솔을 사용하여 구성 별칭을 생성하려면

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

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

  3. 플레이어 파라미터에 동적 변수로 사용할 플레이어 파라미터의 이름을 입력합니다. 예를 들어 player_params.origin_domain입니다.

  4. 별칭에 플레이어 파라미터에 사용할 별칭과 해당 값을 입력합니다.

  5. 확인을 선택합니다.

    AWS Elemental MediaTailor 는 구성 별칭 섹션의 테이블에 새 파라미터를 표시합니다.

  6. 이전 단계를 반복하여 플레이어 파라미터를 더 추가합니다.

  7. 저장을 선택합니다.

API
API를 사용하여 구성 별칭을 생성하려면

MediaTailor 구성을 생성하거나 업데이트할 때 다음 JSON 구조와 함께 ConfigurationAliases 파라미터를 사용합니다.

{
                "ConfigurationAliases": {
                "player_params.origin_domain": {
                "pdx": "abc.mediapackage.us-west-2.amazonaws.com",
                "iad": "xyz.mediapackage.us-east-1.amazonaws.com"
                },
                "player_params.ad_type": {
                "customized": "abc12345",
                "default": "defaultAdType"
                }
                }
                }

2단계: 세션 초기화에서 구성 별칭 사용

구성 별칭을 설정한 후 세션 초기화 요청에서 도메인의 대체 변수로 사용할 수 있습니다. 이렇게 하면 세션의 도메인을 동적으로 구성할 수 있습니다.

예 기본 구성 별칭 예제

다음은 구성 별칭과 동적 도메인 변수를 포함하는 구성의 기본 예제입니다.

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 index.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

매니페스트의 오리진에 대한 요청은 다음과 같습니다.

https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd