StreamManager
동적 광고 삽입 스트림을 처리합니다. DAI 백엔드와의 상호작용을 관리하고 핑 추적은 물론 스트림과 광고 이벤트를 게시자에게 전달하는 작업을 처리합니다. 이 관리자는 특정 광고의 관리자가 아니라 전체 스트림의 관리자이기 때문에 BaseAD에서 상속되지 않습니다.
생성자
StreamManager
새 StreamManager(videoElement, adUiElement, uiSettings)
매개변수 |
|
---|---|
videoElement |
재생이 발생하는 HTML 동영상 요소입니다. 값은 null이 아니어야 합니다. |
adUiElement |
선택사항 광고 UI 요소를 보관하는 데 사용하는 HTML 요소입니다. 이 요소는 높이와 너비가 동영상 재생과 동일해야 하며 직접 오버레이되어야 합니다. 제공하지 않으면 UI가 표시되지 않으며 건너뛸 수 있는 광고와 같이 UI가 필요한 광고가 요청되지 않습니다. 값은 null이 아니어야 합니다. |
uiSettings |
선택사항 이 스트림에 사용할 UI 설정입니다. 값은 null이 아니어야 합니다. |
- 구현
- EventTarget
- 생성 값
-
요구사항을 충족하지 않는 경우입니다.
방법
contentTimeForStreamTime
contentTimeForStreamTime(streamTime)은 숫자를 반환합니다.
지정된 스트리밍 시간에 광고가 없는 콘텐츠 시간을 반환합니다. 실시간 스트림의 지정된 스트림 시간을 반환합니다.
매개변수 |
|
---|---|
streamTime |
숫자 삽입된 광고가 있는 스트리밍 시간 (초)입니다. |
- 반환 값
-
number
는 광고가 삭제된 후 지정된 스트림 시간에 해당하는 콘텐츠 시간입니다.
초점
포커스()
건너뛰기 버튼(있는 경우)에 포커스를 맞춥니다. 없으면 아이콘이나 양방향 광고 소재를 비롯한 상호작용 요소에 포커스가 놓입니다.
getAdSkippableState
getAdskippableState()는 불리언을 반환합니다.
현재 광고를 건너뛸 수 있는 경우 true를 반환합니다. 이 값이 변경되면 StreamManager
는 StreamEvent.SKIPPABLE_STATE_CHANGED
이벤트를 실행합니다.
- 반환 값
-
boolean
현재 광고를 건너뛸 수 있는 경우 true, 그렇지 않은 경우 false입니다.
loadStreamMetadata
loadStreamMetadata()
SDK에 광고 메타데이터를 로드하도록 요청한 다음 StreamEvent.LOADED를 브로드캐스트합니다. 서드 파티 동영상 합치기에서 스트림 매니페스트를 가져온 후에는 수동으로 트리거해야 합니다. 서드 파티 동영상 합치기가 포함된 광고 모음 게재 VOD에만 사용되며 다른 스트림 요청에는 작동하지 않습니다.
onTimedMetadata
onTimedMetadata(metadata)
처리된 메타데이터 사전을 전달합니다. 사전에는 사용자 정의 메타데이터 문자열이 값으로 포함된 'TXXX' 키가 필요합니다. 플레이어가 원시 메타데이터를 제공하는 경우 대신 StreamManager.processMetadata를 호출하세요.
매개변수 |
|
---|---|
metadata |
객체 메타데이터 사전입니다. 값은 null이 아니어야 합니다. |
previousCuePointForStreamTime
이전CuePointForStreamTime(streamTime)은 CuePoint를 반환합니다.
지정된 스트리밍 시간의 이전 큐 시점을 반환합니다. 이러한 큐 포인트가 없는 경우 null을 반환합니다. 스냅백과 같은 기능을 구현하는 데 사용되며 사용자가 광고 시점으로 돌아가기 위해 사용자가 탐색한 것을 게시자가 감지할 때 호출됩니다.
매개변수 |
|
---|---|
streamTime |
숫자 찾으려는 스트림 시간. |
- 반환 값
-
nullable CuePoint
: 지정된 스트리밍 시간의 이전 큐 시점입니다.
processMetadata
processMetadata(type, data, timestamp)
실시간 스트림의 시간 지정 메타데이터를 처리합니다. 동영상 플레이어가 타임스탬프와 함께 파싱되지 않은 메타데이터를 제공하는 경우 사용하고, 그렇지 않은 경우 StreamManager.onTimedMetadata를 호출합니다.
매개변수 |
|
---|---|
유형 |
string 메타데이터의 유형입니다. HLS의 경우 'ID3', DASH의 경우 이벤트 메시지 스킴 ID URI여야 합니다. |
데이터 |
(null이 아닌 Uint8Array 또는 문자열) 원시 태그 데이터입니다. ID3의 경우 전체 원시 태그 데이터여야 합니다. DASH 이벤트 메시지의 경우 메시지 데이터 문자열입니다. |
timestamp |
숫자 데이터를 처리해야 하는 시간(초)입니다. DASH의 경우 이벤트 메시지 시작 시간입니다. |
replaceAdTagParameters
replaceAdTagParameters(adTagParameters)
실시간 스트림의 예정된 광고 요청에 사용되는 모든 광고 태그 매개변수를 대체합니다.
매개변수 |
|
---|---|
adTagParameters |
문자열 속성이 있는 객체 새 광고 태그 매개변수입니다. 문자열 값이 있어야 합니다. 값은 null이 아니어야 합니다. |
requestStream
requestStream(streamRequest)
제공된 스트림 매개변수를 사용하여 스트림이 로드되도록 요청합니다.
매개변수 |
|
---|---|
streamRequest |
스트림 메타데이터를 로드하는 매개변수가 포함됩니다. 값은 null이 아니어야 합니다. |
재설정
재설정()
스트림 관리자를 재설정하고 지속적인 폴링을 삭제합니다.
setClickElement
setClickElement(clickElement)
광고 클릭연결 요소를 설정합니다. 이 요소는 광고가 재생되는 동안 클릭이나 탭 수신기로 사용되며, 결과적으로는 현재 페이지에서 벗어날 수 있습니다. 이 기능은 이제 지원 중단되었으므로 adUiElement는 대신 StreamManager에 전달해야 합니다. adUiElement가 StreamManager 생성자에 지정되면 이 메서드는 노옵스(no-ops)가 됩니다.
매개변수 |
|
---|---|
clickElement |
요소 광고를 클릭연결하는 데 사용되는 요소입니다. 값이 null일 수 있습니다. |
- 지원 중단됨
- 대신 StreamManager 생성자에 adUiElement를 제공합니다.
streamTimeForContentTime
StreamTimeForContentTime(contentTime)은 숫자를 반환합니다.
지정된 콘텐츠 시간의 광고가 있는 스트리밍 시간을 반환합니다. 실시간 스트림의 지정된 콘텐츠 시간을 반환합니다.
매개변수 |
|
---|---|
contentTime |
숫자 광고가 없는 콘텐츠 시간 (초)을 표시합니다. |
- 반환 값
-
number
는 광고가 삽입된 후 지정된 콘텐츠 시간에 해당하는 스트림 시간입니다.