기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
세션 제어를 위한 MediaTailor 서비스 변수
AWS Elemental MediaTailor 는 세션 수준 동작을 제어하는 서비스 변수에 대한 aws. 쿼리 파라미터 네임스페이스를 예약합니다. ads. 파라미터(ADS로 전달됨) 및 manifest. 파라미터(개인화된 매니페스트 URLs에 추가됨)와 달리 aws. 파라미터는 MediaTailor에서 직접 사용되며 오리진 서버 또는 ADS로 전달되지 않습니다.
지원되는 파라미터
다음 표에는 세션 수준 동작을 제어하는 데 사용할 수 있는 aws.* 파라미터가 나열되어 있습니다.
| 파라미터 | 유형 | 값 | 기본값 | 설명 |
|---|---|---|---|---|
aws.startTime |
ISO 8601 타임스탬프 | 예: 2026-06-17T10:00:00Z |
설정되지 않음(라이브 엣지 조인) | DVR 창의 특정 지점에서 세션을 시작합니다. MediaTailor는 타임스탬프를 가장 가까운 세그먼트 경계로 확인하고 HLS 매니페스트EXT-X-START:TIME-OFFSET에서를 내보냅니다. |
aws.preroll |
문자열 열거형 | enabled, disabled (대/소문자 비구분) |
enabled |
세션에 대해 프리롤 광고 삽입이 발생하는지 여부를 제어합니다. disabled인 경우 재생 구성에가 있더라도 프리롤이 억제됩니다LivePreRollConfiguration. |
aws.overlayAvails |
문자열 열거형 | on, off (대/소문자 비구분) |
on |
오버레이(비선형) 광고 시간이 세션에 대해 처리되는지 여부를 제어합니다. off인 경우 소스 매니페스트의 오버레이 광고 마커는 무시되고 오버레이 광고는 삽입되지 않습니다. |
aws.logMode |
문자열 열거형 | DEBUG, DISABLED |
DISABLED |
세션에 대한 상세 디버그 로깅을 활성화합니다. 로 설정하면 DEBUG MediaTailor는 문제 해결을 위해 자세한 세션 로그를 CloudWatch Logs로 내보냅니다. |
aws.availSuppressionMode |
문자열 열거형 | OFF, BEHIND_LIVE_EDGE, AFTER_LIVE_EDGE (대/소문자 비구분) |
OFF |
라이브 엣지에 상대적인 위치를 기반으로 광고 가능 구간이 억제되는지 여부를 제어합니다. |
aws.availSuppressionValue |
지속 시간 | HH:MM:SS 형식(예: 00:00:10) |
설정되지 않음 | 가용성 억제 기간입니다. availSuppressionMode이 BEHIND_LIVE_EDGE 또는 일 때 필요합니다AFTER_LIVE_EDGE. |
aws.availSuppressionFillPolicy |
문자열 열거형 | FULL_AVAIL_ONLY, PARTIAL_AVAIL (대/소문자 비구분) |
FULL_AVAIL_ONLY |
모드가 이면 부분적으로 억제된 가용 구간이 채워지는지 여부를 AFTER_LIVE_EDGE제어합니다. |
aws.startTime
aws.startTime이 설정되면 MediaTailor는 지정된 프로그램 날짜-시간에 가장 가까운 세그먼트 경계에서 세션을 시작합니다.
용도
매니페스트 요청에서 쿼리 파라미터aws.startTime로 전달:
GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.startTime=2026-06-17T10:00:00Z또는 명시적 세션 초기화에서 aws. 접두사 없이 최상위 필드로 전달합니다.
POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8 { "startTime": "2026-06-17T10:00:00Z" }
요구 사항
에는 aws.startTime다음 요구 사항이 적용됩니다.
-
소스 매니페스트는 세그먼트에
EXT-X-PROGRAM-DATE-TIME(PDT)를 포함해야 합니다. PDT가 없으면가 확인할aws.startTime수 없으며 무시됩니다. -
HLS 라이브 세션(SSAI 및 SGAI 모두)에만 적용됩니다.
동작
다음 표에서는가 다양한 시나리오에서 어떻게 aws.startTime 작동하는지 설명합니다.
| 시나리오 | 결과 |
|---|---|
| DVR 기간 내 타임스탬프 | 가장 가까운 세그먼트 경계에서 시작하여 내보냅니다. EXT-X-START |
| DVR 기간보다 오래된 타임스탬프 | 창 헤드에서 3×targetDuration으로 고정 |
| 라이브 엣지의 3×targetDuration 이내 타임스탬프 | 를 라이브 엣지 조인으로 취급( 없음EXT-X-START) |
| 라이브 엣지 또는 그 이후의 타임스탬프 | 일반 라이브 엣지 조인 |
| ISO 8601 형식이 잘못되었거나 아님 | 무시됨 - 라이브 엣지 조인으로 돌아가고 오류가 기록됨 |
| 매니페스트에 PDT가 없음 | 무시됨 - 라이브 엣지 조인으로 돌아가고 오류가 기록됨 |
| 파라미터 생략됨 | 기본값: 일반 라이브 엣지 조인 |
클램핑 동작
시작점이 세션 중 DVR 기간을 벗어나는 경우 EXT-X-START는 창 헤드에서 3×targetDuration으로 고정됩니다. 3×targetDuration 버퍼는 RFC 8216 §6.3.3 플레이어 버퍼링 권장 사항에 부합합니다.
예 aws.startTime을 사용한 매니페스트 출력
플레이어가 로 세션을 초기화aws.startTime=2026-06-17T10:00:00Z하고 확인된 오프셋이 라이브 엣지에서 120초가 되면 MediaTailor는 다음을 내보냅니다.
#EXTM3U #EXT-X-TARGETDURATION:6 #EXT-X-START:TIME-OFFSET=-120.120,PRECISE=YES #EXT-X-MEDIA-SEQUENCE:500 #EXT-X-PROGRAM-DATE-TIME:2026-06-17T09:58:00.000Z #EXTINF:6.006, segment500.ts #EXTINF:6.006, segment501.ts ...
는 플레이어에게 라이브 엣지 120초 후 요청된 시작 시간에 가장 가까운 세그먼트 경계에서 재생을 시작하도록 TIME-OFFSET=-120.120 지시합니다.
제한 사항
다음과 같은 제한이 적용됩니다.
-
세션 초기화 후에는이 파라미터를 변경할 수 없습니다.
-
소스 매니페스트
EXT-X-PROGRAM-DATE-TIME에 필요합니다. -
EXT-X-START는 플레이어 힌트입니다. MediaTailor는 모든 플레이어가 이를 준수한다고 보장할 수 없습니다.
aws.preroll
aws.preroll=disabled인 경우 MediaTailor는 재생 구성에가 있더라도 세션에 대한 프리롤 광고 삽입을 억제합니다LivePreRollConfiguration.
용도
매니페스트 요청에서 쿼리 파라미터aws.preroll로 전달:
GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.preroll=disabled또는 명시적 세션 초기화에서 aws. 접두사 없이 최상위 필드로 전달합니다.
POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8 { "preroll": "disabled" }
요구 사항
에는 aws.preroll다음 요구 사항이 적용됩니다.
-
이 파라미터를 적용하려면 재생 구성
LivePreRollConfiguration에이 있어야 합니다. 프리롤이 구성되지 않은 경우이 파라미터를 설정해도 아무런 효과가 없습니다. -
HLS 라이브 세션(SSAI 및 SGAI 모두)에 적용됩니다.
동작
다음 표에서는가 aws.preroll 작동하는 방식을 설명합니다.
| 값 | 결과 |
|---|---|
enabled (또는 생략됨) |
프리롤이 평소처럼 삽입됨 |
disabled |
이 세션에 대해 프리롤이 금지됨 |
| 잘못된 값 | 오류로 로깅되고 로 처리됨 enabled |
제한 사항
세션 초기화 후에는이 파라미터를 변경할 수 없습니다.
aws.overlayAvails
aws.overlayAvails=off인 경우 MediaTailor는 소스 매니페스트에서 오버레이(비선형) 광고 마커를 무시하고 세션에 오버레이 광고를 삽입하지 않습니다.
용도
매니페스트 요청에서를 쿼리 파라미터aws.overlayAvails로 전달합니다.
GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.overlayAvails=off요구 사항
에는 aws.overlayAvails다음 요구 사항이 적용됩니다.
-
이 파라미터가 효과를 발휘하려면 소스 매니페스트에 오버레이 광고 마커(예: 오버레이 분할 유형의 SCTE-35 이벤트)가 포함되어야 합니다.
-
HLS 및 DASH, 라이브 및 VOD 세션(SSAI 및 SGAI 모두)에 적용됩니다.
동작
다음 표에서는가 aws.overlayAvails 작동하는 방식을 설명합니다.
| 값 | 결과 |
|---|---|
on (또는 생략됨) |
오버레이 가용성이 처리되고 광고가 평소와 같이 삽입됩니다. |
off |
오버레이 광고 마커가 무시되고 오버레이 광고가 삽입되지 않음 |
| 잘못된 값 | 오류로 로깅됨, 지정되지 않음으로 처리됨(기본값: on) |
제한 사항
세션 초기화 후에는이 파라미터를 변경할 수 없습니다.
aws.logMode
aws.logMode=DEBUG인 경우 MediaTailor는 세션에 대한 상세 디버그 로깅을 활성화합니다. 디버그 로그는 CloudWatch Logs로 내보내지고 매니페스트 개인화, 광고 결정 서버 요청 및 세션 상태에 대한 자세한 정보를 제공합니다. 이는 광고 삽입 문제를 해결하는 데 유용합니다.
용도
매니페스트 요청에서를 쿼리 파라미터aws.logMode로 전달합니다.
GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.logMode=DEBUG요구 사항
에는 aws.logMode다음 요구 사항이 적용됩니다.
-
디버그 로그를 내보내려면 재생 구성에 로깅이 활성화(
PercentEnabled > 0또는EnabledLoggingStrategies구성)되어 있어야 합니다. -
디버그 로깅은 과도한 로그 볼륨을 방지하기 위해 고객별로 속도가 제한됩니다.
동작
다음 표에서는가 aws.logMode 작동하는 방식을 설명합니다.
| 값 | 결과 |
|---|---|
DEBUG |
세션에 대해 생성된 세부 정보 디버그 로그 |
DISABLED (또는 생략됨) |
일반 로깅 동작(재생 구성 설정 기준) |
| 잘못된 값 | 오류 발생, 세션 초기화 실패 |
제한 사항
다음과 같은 제한이 적용됩니다.
-
세션 초기화 후에는이 파라미터를 변경할 수 없습니다.
-
값은 대/소문자를 구분합니다(
DEBUG가 아님debug).
aws.availSuppressionMode
라이브 엣지에 상대적인 위치를 기반으로 광고 가능 구간이 억제되는지 여부를 제어합니다. 예를 들어 이벤트 중간에 라이브 스트림에 조인할 때 최종 사용자가 이미 통과한 광고 시간을 채우지 않도록 하려면 이를 사용하여 라이브 엣지 뒤 또는 뒤의 기간 내에 속하는 광고 시간을 건너뜁니다.
용도
매니페스트 요청에서 가용 억제 파라미터를 쿼리 파라미터로 전달합니다.
GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10이 파라미터는 다음 두 가지 컴패니언 파라미터와 함께 작동합니다.
-
aws.availSuppressionValue- 기간(모드가가 아닌 경우 필수OFF) -
aws.availSuppressionFillPolicy- 부분 채우기 동작을 제어합니다(AFTER_LIVE_EDGE모드에만 적용됨).
요구 사항
가용성 억제 파라미터에는 다음 요구 사항이 적용됩니다.
-
HLS 및 DASH 라이브 세션에 적용됩니다.
-
aws.availSuppressionValue모드가BEHIND_LIVE_EDGE또는 인 경우HH:MM:SS형식으로를 제공해야 합니다AFTER_LIVE_EDGE. -
aws.availSuppressionFillPolicy는 모드가 인 경우에만 유효합니다AFTER_LIVE_EDGE.
모드 동작
다음 표에서는 각 억제 모드의 효과를 설명합니다.
| Mode | Effect |
|---|---|
OFF (또는 생략됨) |
가용성 억제 없음 - 모든 광고 중단이 정상적으로 채워집니다. |
BEHIND_LIVE_EDGE |
라이브 엣지 뒤의 지정된 기간 내에 시작되는 광고 시간 억제 |
AFTER_LIVE_EDGE |
라이브 엣지에서 지정된 기간 이후에 시작되는 광고 시간 억제 |
채우기 정책(AFTER_LIVE_EDGE만 해당)
다음 표에서는 모드가 일 때의 채우기 정책 동작을 설명합니다. AFTER_LIVE_EDGE
| 채우기 정책 | Effect |
|---|---|
FULL_AVAIL_ONLY(기본값) |
억제 기간 외부에 있는 가용 영역만 채웁니다. |
PARTIAL_AVAIL |
억제 기간을 넘어 확장되는 가용 영역 부분을 채웁니다. |
예가용성 억제 예제
다음 요청은 라이브 엣지 뒤 10초 이내에 광고 시간을 억제합니다.
GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10제한 사항
다음과 같은 제한이 적용됩니다.
-
세션 초기화 후에는이 파라미터를 변경할 수 없습니다.
-
aws.availSuppressionValue모드가 인 경우를 제공해서는 안 됩니다OFF. -
의 시간 형식이 잘못
aws.availSuppressionValue되면 모드가 로 돌아갑니다OFF.
