양방향 미디어 광고 (IMA) 동적 광고 삽입 (DAI) SDK는 스트림의 미디어 세그먼트에 삽입된 메타데이터 정보 (대역 내 메타데이터), 스트리밍 매니페스트 파일 (매니페스트 내 메타데이터)에서 위치 및 클라이언트 측 광고 이벤트를 지원합니다. 메타데이터는 다양한 형식으로 전송되며 콘텐츠 유형을 설정할 수 있습니다.
동영상 플레이어는 시간이 지정된 메타데이터를 일괄적으로 수신합니다. 플레이어에 따라 메타데이터는 예약된 시간에 또는 일괄적으로 표시할 수 있습니다. 각 메타데이터 문자열에 PTS (프레젠테이션 타임스탬프)가 있어야 합니다. 시작됩니다
앱은 메타데이터를 캡처하여 IMA DAI SDK에 전달해야 합니다. SDK는 이 정보를 전달하기 위해 다음 메서드를 제공합니다.
- onTimedMetadata
이 메서드는 처리할 준비가 된 메타데이터 문자열을 사용할 수 있습니다. 단일 인수를 사용합니다.
metadata
: 연결된 문자열과 함께TXXX
의 키를 포함하는 객체 값 앞에google_
가 붙습니다.
- processMetadata
이 메서드는 지정된 PTS입니다. 다음 인수를 사용합니다.
type
: 처리 중인 이벤트 유형이 포함된 문자열입니다. 수락됨 값은 HLS의 경우ID3
, DASH의 경우urn:google:dai:2018
입니다.data
:google_
가 접두사로 지정된 문자열 값 또는 디코딩합니다.timestamp
: 데이터를 처리해야 하는 시간(초)의 타임스탬프입니다.
IMA DAI SDK에서 지원하는 각 스트림 유형은 고유한 형식의 시간 표시 메타데이터로 구성됩니다.
HLS MPEG2TS 스트림
MPEG2TS 세그먼트를 사용하는 선형 DAI HLS 스트림은 시간이 지정된 메타데이터를 ID3 태그를 통해 동영상 플레이어를 재생할 수 있습니다. 이러한 ID3 태그는 MPEG2TS 세그먼트로 분류되고 TXXX 필드 이름 (맞춤 사용자 정의 텍스트의 경우)이 제공됨 콘텐츠
Safari에서 재생
Safari는 ID3 태그를 숨겨진 트랙으로 자동 처리하므로 cuechange 이벤트 적절한 시점에 실행되도록 하여 각 메타데이터를 처리합니다. 통과해도 괜찮음 모든 메타데이터를 IMA DAI SDK에 전달합니다. 관련성 없음 자동으로 필터링됩니다
예를 들면 다음과 같습니다.
videoElement.textTracks.addEventListener('addtrack', (e) => {
const track = e.track;
if (track.kind === 'metadata') {
track.mode = 'hidden';
track.addEventListener('cuechange', () => {
for (const cue of track.activeCues) {
const metadata = {};
metadata[cue.value.key] = cue.value.data;
streamManager.onTimedMetadata(metadata);
}
});
}
});
...
HLS.js
HLS.js는 FRAG_PARSING_METADATA
이벤트를 통해 일괄적으로 ID3 태그를 제공합니다.
샘플 배열로 표시합니다. HLS.js가 바이트 배열의 ID3 데이터를 변환하지 않음
이벤트를 해당 PTS로 오프셋하지 않습니다. 아닙니다.
샘플 데이터를 바이트 배열에서 문자열로 디코딩하거나
IMA DAI SDK가 이 디코딩 및 필터링을 수행하기 때문에
자동으로 확장 및 축소할 수 있습니다
예를 들면 다음과 같습니다.
hls.on(Hls.Events.FRAG_PARSING_METADATA, (e, data) => {
if (streamManager && data) {
data.samples.forEach((sample) => {
streamManager.processMetadata('ID3', sample.data, sample.pts);
});
}
});
...
HLS CMAF 스트림
CMAF (Common Media Application Framework) 패스를 사용하는 선형 DAI HLS 스트림 ID3~ CMAF 표준이 있습니다. 이러한 eMSG 상자는 각 미디어 세그먼트의 시작 부분에 삽입되며, 각 ID3 eMSG에는 스트림의 마지막 중단 시점을 기준으로 한 PTS입니다.
HLS.js의 1.2.0 버전을 기준으로, 제안된 두 플레이어는 모두 ID3을 전달합니다. 마치 ID3 태그인 것처럼 CMAF를 통해 사용자에게 전달됩니다. 따라서 다음 예는 HLS MPEG2TS 스트림의 경우와 동일합니다. 그러나 모든 플레이어에게 적용되는 것은 아니므로 HLS CMAF 지원을 구현하면 스트림은 eMSG를 통해 ID3을 파싱하기 위해 고유 코드가 필요할 수 있습니다.
Safari에서 재생
Safari는 eMSG 메타데이터를 통한 ID3을 의사 ID3 이벤트로 취급하여 숨겨진 트랙으로 자동 배치하여 cuechange 이벤트 각 메타데이터를 처리하기 위해 올바른 시간에 실행되어야 합니다. 타이밍 관련 여부에 관계없이 모든 메타데이터를 IMA DAI SDK에 전달해야 합니다. 모든 문자 DAI와 관련 없는 메타데이터는 자동으로 필터링됩니다.
예를 들면 다음과 같습니다.
videoElement.textTracks.addEventListener('addtrack', (e) => {
const track = e.track;
if (track.kind === 'metadata') {
track.mode = 'hidden';
track.addEventListener('cuechange', () => {
for (const cue of track.activeCues) {
const metadata = {};
metadata[cue.value.key] = cue.value.data;
streamManager.onTimedMetadata(metadata);
}
});
}
});
...
HLS.js
버전 1.2.0부터 HLS.js는 eMSG 메타데이터를 통해 ID3을 의사 ID3으로 취급합니다.
FRAG_PARSING_METADATA
이벤트를 통해 일괄적으로 제공합니다.
샘플 배열로 표시합니다. HLS.js가 바이트 배열의 ID3 데이터를 변환하지 않음
이벤트를 해당 PTS로 오프셋하지 않습니다. 아닙니다.
디코딩하는 데 필요합니다.
예를 들면 다음과 같습니다.
hls.on(Hls.Events.FRAG_PARSING_METADATA, (e, data) => {
if (streamManager && data) {
data.samples.forEach((sample) => {
streamManager.processMetadata('ID3', sample.data, sample.pts);
});
}
});
...
DASH 스트림
선형 DAI DASH 스트림은
맞춤 schemeIdUri
값 urn:google:dai:2018
입니다. 이러한
텍스트 페이로드와 PTS가 포함됩니다.
DASH.js
Dash.js는 각 스키마의 schemaIdUri 값에 따라 이름이 지정된 맞춤 이벤트 핸들러를 제공합니다.
이벤트 스트림 이러한 커스텀 핸들러는 일괄적으로 실행되므로
PTS 값을 처리하여 이벤트 시간을 적절히 조정합니다. IMA DAI SDK는
StreamManager 메서드 processMetadata()
를 사용하여 이 작업을 수행합니다.
예를 들면 다음과 같습니다.
const dash = dashjs.MediaPlayer().create();
dash.on('urn:google:dai:2018', (payload) => {
const mediaId = payload.event.messageData;
const pts = payload.event.calculatedPresentationTime;
streamManager.processMetadata('urn:google:dai:2018', mediaId, pts);
});
...
샤카 플레이어
Shaka Player는 timelineregionenter
이벤트의 일부로 이벤트를 표시합니다. 기한
Shaka Player와의 형식이 호환되지 않는 경우 메타데이터 값은
세부정보 속성을 통해 원시를 검색함
eventElement.attributes['messageData'].value
예를 들면 다음과 같습니다.
player.addEventListener('timelineregionenter', function(event) {
const detail = event.detail;
if ( detail.eventElement.attributes &&
detail.eventElement.attributes['messageData'] &&
detail.eventElement.attributes['messageData'].value) {
const mediaId = detail.eventElement.attributes['messageData'].value;
const pts = detail.startTime;
streamManager.processMetadata("urn:google:dai:2018", mediaId, pts);
}
});
...
광고 모음 게재
광고 모음 게재의 경우 시간 제한 전달을 위한 다양한 구성이 있습니다. 메타데이터로 표시할 수 있습니다.
- 라이브 또는 VOD 스트림 유형
- HLS 또는 DASH 스트림 형식
- 사용 중인 플레이어의 유형
- 사용 중인 DAI 백엔드 유형입니다.
HLS 스트림 형식 (라이브 및 VOD 스트림, HLS.js 플레이어)
HLS.js 플레이어를 사용하는 경우
HLS.js FRAG_PARSING_METADATA
이벤트를 사용하여 ID3 메타데이터를 가져오고 이를
StreamManager.processMetadata()
가 포함된 SDK.
모든 것이 로드되고 준비된 후 동영상이 자동으로 재생되도록 하려면
HLS.js MANIFEST_PARSED
이벤트를 사용하여 재생을 트리거합니다.
function loadStream(streamID) {
hls.loadSource(url);
hls.attachMedia(videoElement);
// Timed metadata is passed HLS stream events to the streamManager.
hls.on(Hls.Events.FRAG_PARSING_METADATA, parseID3Events);
hls.on(Hls.Events.MANIFEST_PARSED, startPlayback);
}
function parseID3Events(event, data) {
if (streamManager && data) {
// For each ID3 tag in the metadata, pass in the type - ID3, the
// tag data (a byte array), and the presentation timestamp (PTS).
data.samples.forEach((sample) => {
streamManager.processMetadata('ID3', sample.data, sample.pts);
});
}
}
function startPlayback() {
console.log('Video Play');
videoElement.play();
}
DASH.js (DASH 스트림 형식, 라이브 및 VOD 스트림 유형)
DASH.js 플레이어를 사용하는 경우 라이브 또는 VOD의 ID3 메타데이터를 수신 대기하려면 다른 문자열을 사용해야 합니다. 스트림:
- 라이브 스트림:
'https://developer.apple.com/streaming/emsg-id3'
- VOD 스트림:
'urn:google:dai:2018'
StreamManager.processMetadata()
를 사용하여 ID3 메타데이터를 SDK에 전달합니다.
모든 것이 로드되고 준비된 후 동영상 컨트롤을 자동으로 표시하려면
DASH.js MANIFEST_LOADED
이벤트를 수신 대기합니다.
const googleLiveSchema = 'https://developer.apple.com/streaming/emsg-id3';
const googleVodSchema = 'urn:google:dai:2018';
dashPlayer.on(googleLiveSchema, processMetadata);
dashPlayer.on(googleVodSchema, processMetadata);
dashPlayer.on(dashjs.MediaPlayer.events.MANIFEST_LOADED, loadlistener);
function processMetadata(metadataEvent) {
const messageData = metadataEvent.event.messageData;
const timestamp = metadataEvent.event.calculatedPresentationTime;
// Use StreamManager.processMetadata() if your video player provides raw
// ID3 tags, as with dash.js.
streamManager.processMetadata('ID3', messageData, timestamp);
}
function loadlistener() {
showControls();
// This listener must be removed, otherwise it triggers as addional
// manifests are loaded. The manifest is loaded once for the content,
// but additional manifests are loaded for upcoming ad breaks.
dashPlayer.off(dashjs.MediaPlayer.events.MANIFEST_LOADED, loadlistener);
}
라이브 스트림이 포함된 Shaka Player (DASH 스트림 형식)
Shaka 플레이어를 사용하는 경우
라이브 스트림 재생의 경우 'emsg'
문자열을 사용하여 메타데이터 이벤트를 수신 대기합니다.
그런 다음 StreamManager.onTimedMetadata()
호출에 이벤트 메시지 데이터를 사용합니다.
shakaPlayer.addEventListener('emsg', (event) => onEmsgEvent(event));
function onEmsgEvent(metadataEvent) {
// Use StreamManager.onTimedMetadata() if your video player provides
// processed metadata, as with Shaka player livestreams.
streamManager.onTimedMetadata({'TXXX': metadataEvent.detail.messageData});
}
VOD 스트림이 있는 Shaka Player (DASH 스트림 형식)
Shaka 플레이어를 사용하는 경우
VOD 스트림 재생, 'timelineregionenter'
문자열을 사용하여 들을 수 있습니다.
메타데이터 이벤트입니다. 그런 다음
StreamManager.processMetadata()
드림
'urn:google:dai:2018'
문자열로 바꿉니다.
shakaPlayer.addEventListener('timelineregionenter', (event) => onTimelineEvent(event));
function onTimelineEvent(metadataEvent) {
const detail = metadataEvent.detail;
if ( detail.eventElement.attributes &&
detail.eventElement.attributes['messageData'] &&
detail.eventElement.attributes['messageData'].value ) {
const mediaId = detail.eventElement.attributes['messageData'].value;
const pts = detail.startTime;
// Use StreamManager.processMetadata() if your video player provides raw
// ID3 tags, as with Shaka player VOD streams.
streamManager.processMetadata('urn:google:dai:2018', mediaId, pts);
}
}