스트림 매개변수 재정의는 선택사항입니다.
플레이어나 애플리케이션에서 다음을 재정의하기를 원하는 경우 사용할 수 있습니다.
- 스트림 생성 매개변수의 기본값
- HLS 또는 DASH 재생목록이 요청되었을 때 변형의 선택항목 또는 기본 순서
이러한 매개변수는 IMA SDK, SSB(서버 측 비커닝), DAI API 구현 시 플레이어나 앱에서 전달할 수 있습니다.
변형 선택항목 및 순서 재정의
기본 재생목록 순서는 게시자가 결정합니다. 순서 매개변수가 지정되지 않으면 재생목록은 게시자가 반환한 것과 같은 원래 순서로 반환됩니다.
스트림을 생성할 때 지정된 변형 선택 및 순서 매개변수를 재정의할 수 있습니다. 이렇게 하면 마스터 재생목록 요청 응답에 포함된 변형의 하위 집합을 지정하고 해당 변형의 순서를 결정할 수 있습니다. 콘텐츠를 소비하는 사용자에 따라 특정 변형이 다른 변형에 비해 우선적으로 사용되기를 원할 때 유용합니다.
변형의 하위집합 및 순서는 스트림이 사용되는 동안 그대로 유지됩니다. 매개변수는 IMA SDK를 사용할 때 adTagParameters 구조의 일부인 DAI API 매개변수로 수용되거나 SSB를 사용할 때 추가 HTTP GET
매개변수로 수용됩니다.
매개변수 | 스트리밍 프로토콜 | 설명 | 예 |
---|---|---|---|
dai-aor |
HLS, DASH |
반환할 오디오 변형의 대역폭 범위입니다.
|
|
dai-dlid |
HLS, DASH |
동영상 애셋의 CDN 구성을 만들 때 기본 CDN 구성 및 추가 CDN 게재 설정을 정의합니다. 이렇게 하면 두 개 이상의 CDN을 설정하고 키-값을 사용하여 세션 시작 시 게재할 CDN을 동적으로 선택할 수 있습니다. CDN 구성을 설정하고 저장하고 나면 Ad Manager에서는 각각의 이름을 지정합니다. 이 이름은 요청에 이름이 전달되지 않으면 Ad Manager에서는 기본 CDN을 사용합니다. 참고: |
( |
dai-excl |
HLS, DASH | 재생목록에서 제외할 변환입니다. subtitles , codec , audio-lang , subtitle-lang , iframe , resolution 을 지원합니다. 단일 값 또는 여러 값이 쉼표로 구분된 목록을 사용하여 해상도, 오디오 코덱, 동영상 코덱, 오디오 또는 자막 언어를 제외할 수 있습니다. Codec 접두사는 '*' 접미사도 지원되며, 이는 제공된 접두사를 포함하는 codec 이 있는 모든 변환을 제외합니다. |
단일 코덱 여러 코덱 접두사 코덱 단일 언어 오디오 단일 언어 자막 여러 선택항목 해상도 |
dai-os |
HLS | 마스터 재생목록 상단에 배치할 동영상 변형 대역폭입니다. 값이 startBandwidth 에 가장 가까운 변형이 선택됩니다. 두 값의 거리가 같으면 더 낮은 값이 선택됩니다. 이 매개변수는 제공되고 dai-aor 는 제공되지 않는 경우 모든 오디오 전용 변형이 제외됩니다. |
dai-os=1700000 |
dai-ot |
HLS |
|
dai-ot=bw dai-ot=bw_res |
dai-ov |
HLS |
반환될 미디어 재생목록의 순서를 지정하는 쉼표로 구분된 값입니다. 순서 값이 동일한 변형이 여러 개 존재하는 경우(예: 대역폭은 같지만 해상도가 다른 두 개의 변형이 있는 경우) 그러한 변형들은 원래 순서로 유지됩니다. |
|
dai-sr |
HLS, DASH |
반환될 동영상 변형의 대역폭 범위입니다. 더 높은 대역폭을 모두 선택하려면 대역폭 적용은 동영상 콘텐츠에만 적용됩니다.
|
dai-sr=1300000:2500000 |
기타 재정의 매개변수
매개변수 | 스트리밍 프로토콜 | 설명 | 예 |
---|---|---|---|
dai-ah |
HLS, DASH | 실시간 스트림에 광고 동적 삽입 방지 적용 여부를 지정합니다. 광고 동적 삽입 방지 길이는 실시간 스트림 구성에 지정되어야 합니다. | 광고 동적 삽입 방지 사용 설정:dai-ah=1 |
dai-apto (베타) |
HLS, DASH |
VOD 및 라이브 스트림 생성에 대한 광고 모음 결정 제한 시간(밀리초)입니다. 이 값은 스트림 생성 시 모든 광고 차단 결정(선형의 경우 중간 광고 시점 및 과거 광고 시점 결정, VOD의 경우 VMAP 결정)에 사용됩니다. 그러나 과거 광고 시점의 경우 이벤트 유형 재생목록 또는 dai-dpb 매개변수를 사용하는 경우에만 사용할 수 있습니다. 0보다 크고 10,000 이하인 값으로 설정할 수 있습니다.
매우 낮거나 높은 값을 설정하면 광고 유효노출이나 사용자 경험에 영향을 미칠 수 있습니다. |
dai-apto=4000 |
dai-dpb |
HLS, DASH |
비SSB 선형 스트림에 대해 과거 광고 시점 결정을 사용할지 여부를 지정합니다(SSB 스트림의 경우 매개변수가 무시됨). 사용 설정하면 과거 광고 시점은 중간 광고 시점 결정으로 결정됩니다. 이는 사용자가 사용자가 되감기를 하지 않는 한 과거 시점은 조회되지 않으며 이로 인해 코드 제공 횟수가 늘어날 수 있습니다. |
과거 광고 시점 결정 사용 설정:dai-dpb=true HSL 이벤트 유형 재생목록에 대한 과거 광고 시점 결정 사용 안함: dai-dpb=false |
dai-dvr |
HLS, DASH | 사용자가 뒤로 스크롤하여 재생을 원활하게 유지할 수 있는, 실시간 콘텐츠와 광고의 DVR 길이(초)입니다.
이 값의 현재 기본값은 100초 또는 실시간 스트림 설정에 지정된 값입니다. 하지만 실시간 스트림마다 새로운 최대값을 지정할 수 있습니다. SSB의 경우 최대 100초, SDK 또는 API를 사용하면 최대 1800초까지 지정할 수 있습니다. DVR 길이를 더 늘이려면 계정 관리자에게 문의하세요. |
dai-dvr=60 |
dai-emsgv |
HLS |
이벤트 메시지 버전은 호출자가 CMAF(Common Media Application Format) 콘텐츠의 'emsg' 버전을 지정할 수 있는 스트림 생성 매개변수입니다. HLS 표준을 사용하려면 'emsg' 버전 1이 필요합니다. 이 설정은 Roku와 같이 표준 버전 1을 지원하지 않고 버전 0이 필요한 플랫폼에 유용합니다.
|
dai-emsgv=1 |
dai-pre (베타) |
HLS, DASH | 프리롤을 사용 설정한 라이브 스트림이 겹치는 경우 미드롤 대신 프리롤을 표시할지 여부를 지정합니다. 기본 동작은 프리롤 대신 겹치는 미드롤을 표시합니다. | dai-pre=1 |
dai-ad-dlid (베타) |
HLS, DASH |
라이브 스트림에 광고를 게재하기 위해 Google Ad Manager에서 사전 구성한 외부 CDN의 고유한 이름을 지정합니다. 외부 CDN을 통한 광고 게재에 대해 자세히 알아보세요. |
( |
dai-aup (베타) |
HLS, DASH |
라이브 스트림에 광고를 게재하기 위해 광고 세그먼트 URL을 생성하는 데 사용되는 외부 CDN을 가리키는 임의의 URL 접두어를 지정합니다. 외부 CDN을 통한 광고 게재에 대해 자세히 알아보세요. |
dai-aup=https://domain.com/path-c1/path-c2 |