클래스: StreamManager

StreamManager

클래스

동적 광고 삽입 스트림을 처리합니다. DAI 백엔드와의 상호작용을 관리하고 핑 추적을 처리하고 스트림 및 광고 이벤트를 게시자에게 전달합니다. 이 관리자는 특정 광고의 관리자가 아니라 전체 스트림에 대한 관리자이므로 BaseAds에서 상속되지 않습니다.

생성자

StreamManager

새로운 StreamManager(videoElement, adUiElement, uiSettings)

파라미터
videoElement	재생이 이루어지는 HTML 동영상 요소입니다. 값은 null일 수 없습니다.
adUiElement	선택사항 광고 UI 요소를 담는 데 사용할 HTML 요소입니다. 이 요소는 동영상 재생과 높이와 너비가 같아야 하며 직접 오버레이해야 합니다. 제공되지 않으면 UI가 표시되지 않으며 건너뛸 수 있는 광고와 같이 UI가 필요한 광고가 요청되지 않습니다. 값은 null일 수 없습니다.
uiSettings	선택사항 이 스트림에 사용할 UI 설정입니다. 값은 null일 수 없습니다.

생성 값

입력 매개변수가 요구사항을 충족하지 않는 경우

방법

contentTimeForStreamTime

contentTimeForStreamTime(streamTime)에서 number를 반환합니다.

지정된 스트림 시간 동안 광고가 없는 콘텐츠 시간을 반환합니다. 라이브 스트림의 지정된 스트림 시간을 반환합니다.

파라미터
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

beforeCuePointForStreamTime(streamTime)이 CuePoint를 반환함

지정된 스트림 시간의 이전 큐 시점을 반환합니다. 이러한 큐 지점이 없으면 null을 반환합니다. 이 메서드는 스냅백과 같은 기능을 구현하는 데 사용되며 사용자를 광고 시점으로 되돌리기 위해 사용자가 탐색했음을 게시자가 감지하면 호출됩니다.

파라미터
streamTime	숫자 찾고자 했던 스트림 시간입니다.

반환 값

nullable CuePoint: 지정된 스트리밍 시간의 이전 큐 시점입니다.

processMetadata

processMetadata(type, data, timestamp)

라이브 스트림의 시간 표시 메타데이터를 처리합니다. 동영상 플레이어에서 타임스탬프와 함께 파싱되지 않은 메타데이터를 제공하는 경우 사용하고 그렇지 않으면 StreamManager.onTimedMetadata를 호출합니다.

파라미터
유형	문자열 메타데이터의 유형입니다. HLS의 경우 'ID3', DASH의 경우 이벤트 메시지 스키마 ID URI여야 합니다.
데이터	(null이 아닌 Uint8Array 또는 문자열) 원시 태그 데이터 ID3의 경우 전체 원시 태그 데이터여야 합니다. DASH 이벤트 메시지의 경우 메시지 데이터 문자열입니다.
타임스탬프	숫자 데이터를 처리해야 하는 시간(초)입니다. DASH의 경우 이벤트 메시지 시작 시간입니다.

replaceAdTagParameters

replaceAdTagParameters(adTagParameters)

라이브 스트림의 예정된 광고 요청에 사용된 모든 광고 태그 매개변수를 대체합니다.

파라미터
adTagParameters	문자열 속성이 있는 객체 새 광고 태그 매개변수입니다. 문자열 값을 포함해야 합니다. 값은 null일 수 없습니다.

requestStream

requestStream(streamRequest)

제공된 스트림 매개변수를 사용하여 스트림이 로드되도록 요청합니다.

파라미터
streamRequest	StreamRequest 스트림 메타데이터를 로드하는 매개변수가 포함됩니다. 값은 null일 수 없습니다.

재설정

재설정()

스트림 관리자를 재설정하고 지속적인 폴링을 모두 삭제합니다.

setClickElement

setClickElement(clickElement)

광고 클릭연결 요소를 설정합니다. 이 요소는 광고가 재생되는 동안 클릭 또는 탭 수신기로 사용되며, 이로 인해 현재 페이지에서 벗어나게 될 수 있습니다. 이 메서드는 현재 지원 중단되며 대신 adUiElement를 StreamManager에 전달해야 합니다. adUiElement가 StreamManager 생성자에 제공되면 이 메서드는 노옵스(no-ops)가 됩니다.

파라미터
clickElement	요소 광고 클릭연결로 사용되는 요소입니다. 값이 null일 수 있습니다.

지원 중단됨

대신 StreamManager 생성자에 adUiElement를 제공합니다.

streamTimeForContentTime

StreamTimeForContentTime(contentTime)은 숫자를 반환

지정된 콘텐츠 시간에 광고가 포함된 스트림 시간을 반환합니다. 라이브 스트림의 지정된 콘텐츠 시간을 반환합니다.

파라미터
contentTime	숫자 광고 없는 콘텐츠 시간 (초)입니다.

반환 값

number: 광고가 삽입된 후 지정된 콘텐츠 시간에 해당하는 스트림 시간입니다.