이 페이지는 Cloud Translation API를 통해 번역되었습니다.

광고 시점

개요

웹 수신기 SDK는 지정된 미디어 스트림 내의 광고 시점 및 컴패니언 광고를 기본적으로 지원합니다. 광고 시점 및 관련 광고 시간 클립의 광고 위치, 광고 소스, 동작을 설정하는 API를 제공합니다. 이 가이드에서 Break는 하나 이상의 광고 또는 범퍼를 포함하는 재생 간격을 나타내며, 각 광고 또는 범퍼를 BreakClip라고 합니다. 이러한 광고 시점은 로드 또는 재생 중인 미디어와 연결되어 있습니다.

광고 유형

웹 수신기 SDK는 클라이언트 측 광고 삽입 (CSAI) 및 서버 병합 광고 삽입 (SSAI)을 지원합니다. 클라이언트 결합 광고는 애플리케이션에서 수동으로 설정하거나 VAST 및 VMAP 템플릿 파일에서 추출할 수 있습니다. 서버 병합 광고는 콘텐츠를 삽입된 광고로 로드하기 전에 수동으로 지정하거나 콘텐츠 재생 중에 삽입된 확장 광고로 동적으로 지정해야 합니다. 이러한 각 광고 유형의 구현은 아래에 자세히 설명되어 있습니다.

수동 고객 병합

클라이언트가 병합하는 수동 광고 시점은 클라이언트가 함께 연결하고 SDK API를 사용하여 애플리케이션에서 수동으로 지정하는 광고 시점 유형입니다. 이 광고 유형은 기본 콘텐츠의 스트림에 삽입되지 않았습니다. BreakClip는 광고 콘텐츠를 가리키는 URL인 contentId, 광고 콘텐츠의 형식을 설명하는 contentType, title를 제공해야 합니다.

Break에서 isEmbedded 및 expanded를 기본값 false로 설정해야 합니다. position는 프리롤, 미드롤 또는 포스트롤 광고 시점으로 설정할 수 있습니다 (자세한 내용은 광고 시점 위치 섹션에서 참고). 재생할 광고를 준비할 때 웹 수신기 SDK는 광고 콘텐츠를 로드하고 재생할 또 다른 플레이어 인스턴스를 생성합니다. 이러한 광고 시점은 stitched timeline가 필요하며 정적으로 추가되어야 합니다 (자세한 내용은 광고 삽입 섹션 참고). 아래 샘플은 수동 클라이언트 연결 광고의 기본 구현을 보여줍니다.

// Create the BreakClip.
let clipClient = new cast.framework.messages.BreakClip('bc_client');
clipClient.title = 'The Ad Title to be displayed during playback';
clipClient.contentId = 'https://example.com/ad.m3u8';
clipClient.contentType = 'application/vnd.apple.mpegurl';

// Optional: Used when HLS ad container formats differ from the main content's.
clipClient.hlsSegmentFormat = cast.framework.messages.HlsSegmentFormat.FMP4;

// Create the Break using the BreakClip id above.
let breakPostrollClient = new cast.framework.messages.Break(
    'break_postroll_client', ['bc_client'], -1);
breakPostrollClient.isEmbedded = false; // Optional: default is false.
breakPostrollClient.expanded = false; // Optional: default is false.

VAST

웹 수신기 SDK는 IAB 표준 VAST (동영상 광고 게재 템플릿) 광고 추가를 지원합니다. 제공되는 경우 XML 템플릿은 중단이 시작될 때 후속 클라이언트 병합 중단 클립을 생성하도록 파싱됩니다.

VAST 광고를 만들려면 수신기 앱에서 VastAdsRequest를 만들고 BreakClip vastAdsRequest 속성에서 지정해야 합니다. VastAdsRequest 객체에는 정의된 adsResponse (XML 템플릿 자체의 문자열 표현) 또는 adTagUrl (XML 템플릿이 호스팅되는 URL) 속성이 정의되어 있어야 합니다. URL이 지정되면 SDK가 템플릿 가져오기를 처리합니다. Break를 캡슐화하는 것은 클라이언트 결합 광고 규칙을 따릅니다. 이러한 광고는 다른 수동 연결 광고와 함께 같은 광고 시점에 추가하거나 동일한 콘텐츠에 대해 별도의 광고 시점에 추가할 수 있습니다. 아래 샘플은 VAST 광고의 기본 구현을 보여줍니다.

// Create the VastAdsRequest.
let vastTemplate = new cast.framework.messages.VastAdsRequest();
vastTemplate.adTagUrl = 'https://example.com/ads.xml'

// Create the BreakClip.
let clipVast = new cast.framework.messages.BreakClip('bc_vast');
clipVast.vastAdsRequest = vastTemplate;

// Create the Break using the BreakClip id above.
let breakPostrollVast = new cast.framework.messages.Break(
    'break_postroll_vast', ['bc_vast'], -1);
breakPostrollVast.isEmbedded = false; // Optional: default is false.
breakPostrollVast.expanded = false; // Optional: default is false.

VAST BreakClip가 포함된 Break를 입력하면 웹 수신기 SDK가 선택적으로 가져온 후 템플릿을 파싱합니다. 파싱하는 동안 SDK는 새 BreakClip를 생성하고 contentId, contentType, title, duration, whenSkippable, clickThroughUrl와 같은 템플릿에서 추출된 값으로 이를 채웁니다. 생성된 광고 시점 클립의 id는 GENERATED:N로 설정됩니다. 여기서 N는 0부터 생성된 새로운 VAST 광고 시간 클립마다 1씩 증가하는 정수입니다. 생성된 광고는 BreakClip 배열에 추가됩니다. 그러면 현재 Break에 있는 각 VAST 브레이크 클립의 id가 이에 상응하는 생성된 시점 클립의 id로 대체됩니다. 아래 스니펫은 이러한 광고 시점 전후의 광고와 관련된 MEDIA_STATUS 메시지의 변경사항을 보여줍니다.

VAST 광고와 함께 광고 시간을 시작하기 전에 Break 및 BreakClip 정보를 제공해야 합니다.

"breaks": [
  {
    "id": "break_postroll_vast",
    "breakClipIds": [
      "bc_vast"
    ],
    "position": 0,
    "isWatched": false
  }
],
"breakClips": [
  {
    "id": "bc_vast"
  }
]

VAST 광고와 함께 광고 시점을 입력한 후 Break 및 BreakClip 정보

"breaks": [
  {
    "id": "break_postroll_vast",
    "breakClipIds": [
      "GENERATED:0"
    ],
    "position": 0,
    "isWatched": true
  }
],
"breakClips": [
  {
    "id": "bc_vast"
  },
  {
    "id": "GENERATED:0",
    "contentId": "https://example.com/break-clip-1.mpd",
    "contentType": "application/dash+xml",
    "title": "Ad Title Extracted from Template",
    "duration": 10,
    "whenSkippable": 5,
    "clickThroughUrl": "https://example.com/ad-target"
  }
]

VMAP

웹 수신기 SDK는 IAB VMAP (동영상 다중 광고 재생목록) 표준을 지원합니다. VMAP가 제공되면 웹 수신기 SDK는 VMAP 응답을 파싱하고 응답의 <AdBreak> 항목에 관해 클라이언트 결합 Break 객체를 생성합니다. 또한 VMAP에 제공된 각 <AdSource> 항목의 vastAdsRequest 객체로 적절한 BreakClips를 생성합니다. 콘텐츠에 광고를 삽입할 수 있도록 VMAP를 사용 설정하려면 애플리케이션에서 VastAdsRequest 객체를 만들어 LoadRequestData에서 MediaInformation의 vmapAdsRequest 속성에 할당해야 합니다. 이러한 광고는 정적으로 삽입해야 합니다 (자세한 내용은 광고 삽입 섹션 참고). 아래는 VMAP 요청 생성 과정을 간략히 설명한 스니펫입니다.

// Create the VastAdsRequest.
let vastTemplate = new cast.framework.messages.VastAdsRequest();
vastTemplate.adTagUrl = 'https://example.com/vmap.xml'

// Add it to the MediaInformation of the LoadRequest.
loadRequestData.media.vmapAdsRequest = vastTemplate;

삽입됨

삽입된 광고 시점은 서버 측에서 기본 콘텐츠 스트림에 병합되는 광고 시점 유형입니다. Break의 재생 시간은 미디어 시간을 계산할 때 기본 콘텐츠의 재생 시간에서 차감됩니다.

BreakClip는 광고 콘텐츠의 duration와 title를 제공해야 합니다. Break에서 isEmbedded는 true로, expanded는 false로 설정해야 합니다. position은 프리롤 또는 미드롤 광고 시점으로 설정할 수 있습니다. 포스트롤 광고 시점은 정확하게 양수인 position 값으로 지원됩니다. 자세한 내용은 광고 시점 위치 섹션을 참고하세요. 광고가 재생되도록 트리거되면 광고 세그먼트가 삽입되어 있으므로 웹 수신기 SDK에서 스트림을 계속 재생합니다. 이 광고 유형을 위한 추가 로드 메커니즘은 없습니다. 플레이헤드가 광고 시간 범위 내에 있으면 관련 광고 메타데이터가 사용자에게 표시됩니다. 이러한 광고 시점은 embedded timeline가 필요하며 정적으로 추가되어야 합니다 (자세한 내용은 광고 삽입 섹션 참고). 아래의 샘플은 embedded 광고의 기본 구현을 보여줍니다.

// Create the BreakClip.
let clipEmbedded = new cast.framework.messages.BreakClip('bc_embedded');
clipEmbedded.title = 'The Ad Title to be displayed during playback';
clipEmbedded.duration = 15;

// Create the Break using the BreakClip id above.
let breakPrerollEmbedded = new cast.framework.messages.Break(
    'break_preroll_embedded', ['bc_embedded'], 0);
breakPrerollEmbedded.isEmbedded = true;
breakPrerollEmbedded.expanded = false; // Optional: default is false.

삽입됨 펼쳐짐

삽입된 확장형 광고 시점은 서버 측에서 기본 콘텐츠의 스트림에 병합되는 광고 시점 유형입니다. Break의 재생 시간은 미디어 시간을 계산할 때 기본 콘텐츠의 재생 시간에 포함됩니다.

BreakClip는 광고 콘텐츠의 duration와 title를 제공해야 합니다. Break에서 isEmbedded는 true로, expanded는 true로 설정해야 합니다. position은 프리롤 또는 미드롤 광고 시점으로 설정할 수 있습니다. 포스트롤 광고 시점은 양수의 position 값으로 지원됩니다. 자세한 내용은 광고 시점 위치 섹션을 참고하세요. 광고가 재생되도록 트리거되면 광고 세그먼트가 삽입되어 있으므로 웹 수신기 SDK에서 스트림을 계속 재생합니다. 이 광고 유형을 위한 추가 로드 메커니즘은 없습니다. 플레이헤드가 광고 시간 범위 내에 있으면 관련 광고 메타데이터가 사용자에게 표시됩니다. 이러한 광고 시점은 embedded timeline가 필요하며 정적으로 또는 동적으로 추가할 수 있습니다 (자세한 내용은 광고 삽입 섹션 참고). 아래 샘플은 embedded expanded 광고의 기본 구현을 보여줍니다.

// Create the BreakClip.
let clipEmbeddedExpanded =
    new cast.framework.messages.BreakClip('bc_embedded_expanded');
clipEmbeddedExpanded.title = 'The Ad Title to be displayed during playback';
clipEmbeddedExpanded.duration = 15;

// Create the Break using the BreakClip id above.
let breakPrerollEmbeddedExpanded = new cast.framework.messages.Break(
    'break_preroll_embedded_expanded', ['bc_embedded_expanded'], 0);
breakPrerollEmbeddedExpanded.isEmbedded = true;
breakPrerollEmbeddedExpanded.expanded = true;

플레이어 타임라인 유형

플레이어 인스턴스를 생성할 때 Web Receiver SDK는 콘텐츠 재생 중 광고 재생을 지원하는 타임라인 유형을 선택합니다. 각 타임라인을 통해 특정 광고 시점 유형을 추가할 수 있습니다. 타임라인 유형은 로드 시간 동안 LoadRequestData의 MediaInformation에 있는 광고 유형에 따라 결정됩니다. 삽입된 광고 시점이 있는 경우 embedded 타임라인이 선택됩니다. 클라이언트가 병합된 광고 시점이 있으면 stitched 타임라인이 선택됩니다. 광고가 없는 경우 SDK는 기본적으로 embedded 타임라인을 사용합니다. 타임라인을 선택하면 현재 미디어 항목의 타임라인을 변경할 수 없습니다. 아래 표에는 각 타임라인에 대한 자세한 설명이 나와 있습니다.

타임라인 유형	설명
삽입된 타임라인	기본 콘텐츠(삽입된 및 삽입된 확장 광고 시점)에 삽입된 광고를 지원하는 미디어 시간을 나타냅니다. 확장되지 않은 광고 시간이 있는 경우 콘텐츠의 총 재생 시간에서 재생 시간을 뺍니다. 반면 펼쳐진 광고 시점이 있는 경우 해당 시간은 기본 콘텐츠의 일부로 간주됩니다.
연결된 타임라인	외부 미디어 파일(수동 클라이언트 병합, VAST, VMAP 광고 시점)에서 가져온 광고를 지원하는 미디어 시간을 나타냅니다. 추가할 경우 광고 시점의 재생 시간은 기본 콘텐츠 재생 시간의 일부가 아닙니다.

아래의 그림 1~3은 다양한 광고 유형과 각 타임라인 값을 사용한 일부 콘텐츠를 보여줍니다. 콘텐츠는 2개의 광고 시점 클립이 포함된 프리롤 시점과 하나의 광고 시점 클립이 포함된 미드롤 및 포스트롤 시점으로 구성됩니다. 콘텐츠 재생 시작 후의 실제 경과 시간, 기본 콘텐츠의 미디어 시간, 현재 재생 중인 광고 시점 클립의 시간이 각 그림 아래에 정렬되어 있습니다.

고객 병합 광고의 타임라인 — **그림 1:** 일부 콘텐츠와 **고객이 병합한** 3개의 광고 시점을 보여주는 타임라인

서버 병합된 삽입 광고의 타임라인 — **그림 2:** 일부 콘텐츠와 **서버에서 병합된 삽입** 광고 시점 3개를 보여주는 타임라인

서버에서 병합된 삽입 광고의 타임라인 — **그림 3:** 일부 콘텐츠와 3개의 **서버로 병합된 삽입 확장** 광고 시점을 보여주는 타임라인

중단 위치 지정

웹 수신기 SDK를 사용하면 개발자가 Break의 position 속성을 설정하여 광고 시점을 배치할 위치를 지정할 수 있습니다. 이 값은 기본 콘텐츠의 미디어 시간에 해당하며 pre-roll, mid-roll, post-roll 광고 시점을 만드는 데 사용할 수 있습니다. 이는 다음과 같이 정의됩니다.

브레이크 위치	설명
프리롤	기본 콘텐츠 전에 재생되는 광고 시점입니다. 이는 `breakPosition`를 `0`로 설정하여 나타냅니다.
미드롤	콘텐츠 중간에 재생되는 광고 시점입니다. 이는 `breakPosition`를 광고 시점의 시작이 기본 콘텐츠의 시작보다 크고 광고 시점의 종료 시간이 기본 콘텐츠의 종료 시간보다 짧은 시간으로 설정하여 나타냅니다.
포스트롤	기본 콘텐츠 다음에 재생되는 광고 시점입니다. 이는 연결된 타임라인의 `breakPosition`를 `-1`로 설정하는 것으로 표시됩니다. 삽입된 타임라인의 경우 `breakPosition`는 기본 콘텐츠의 길이에서 광고 시간을 뺀 값으로 설정해야 합니다. 라이브 콘텐츠에는 지원되지 않습니다.

상호 운용성 매트릭스

빠른 참조로 표 1에는 광고 유형 및 광고 관련 기능과의 호환성이 간략하게 나와 있습니다.

*표 1: Google Ads 상호 운용성 매트릭스*
기능 지원	고객이 병합한 수동 광고	VAST	VMAP	삽입된 광고	삽입된 펼쳐진 광고
호환 가능	VAST	수동 고객 병합	N/A	삽입됨 펼쳐짐	삽입됨
타임라인	스티치	스티치	스티치	삽입됨	삽입됨
광고 삽입	정적	정적	정적	정적	정적, 동적
광고 삭제
프리롤 광고
미드롤 광고
포스트롤 광고
광고 건너뛰기
브레이크 탐색 인터셉터
클립 로드 인터셉터 중단

이벤트

키 중단 이벤트가 발생하면 Cast SDK는 BreaksEvent 유형의 이벤트를 전달합니다. 수신 앱은 PlayerManager addEventListener API를 사용하여 수신 대기할 수 있습니다.

이러한 이벤트는 분석과 광고 재생 추적에 사용할 수 있습니다. VMAP(동영상 다중 광고 재생목록) 및 VAST (동영상 광고 게재 템플릿) 광고를 사용하면 SDK가 응답에 제공된 모든 표준 추적 이벤트를 자동으로 전달합니다.

이벤트 유형은 표 2에 각 유형이 실행되는 시점에 대한 자세한 설명과 함께 나열되어 있습니다.

중단 이벤트 수명 주기 — **그림 4**: 광고 시점 이벤트 수명 주기

*표 2: 광고 시점 이벤트 및 설명*
휴식 시간	설명
`BREAK_STARTED`	기본 콘텐츠의 현재 미디어 시간이 시청하지 않은 광고의 `position`와 같으면 실행됩니다.
`BREAK_CLIP_LOADING`	스티치된 타임라인 광고 시점 클립이 로드되기 시작할 때만 실행됩니다.
`BREAK_CLIP_STARTED`	휴식 클립 재생이 시작되면 실행됩니다.
`BREAK_CLIP_ENDED`	휴식 클립이 끝나면 실행됩니다. 다음과 같은 경우 `endedReason` 이 채워집니다. 스티치된 타임라인 브레이크 클립이 완전히 재생됩니다. 스티치된 타임라인 브레이크 클립이 다른 브레이크 클립으로 전환됩니다. 휴식 시간 클립은 건너뜁니다. 마지막 광고 시간 클립이 포스트롤 삽입된 광고 시간에서 완전히 재생되었습니다. 오류가 발생했습니다.
`BREAK_ENDED`	광고 시점의 마지막 광고 시점 클립이 종료되면 실행됩니다.

광고 삽입

Cast SDK를 사용하면 애플리케이션에서 전송 세션의 다양한 순간에 광고를 삽입하고 삭제할 수 있습니다. 광고 삽입의 두 가지 유형은 정적 및 동적입니다. 정적 광고 삽입을 사용하려면 플레이어를 만들기 전에 LoadRequestData에 광고를 지정해야 합니다. 동적 광고 삽입은 BreakManager addBreak API를 활용하여 이미 로드된 콘텐츠에 광고 시점을 삽입합니다. 각 삽입 방법 유형은 특정 광고 유형과 호환됩니다. 호환성 개요는 상호 운용성 매트릭스에서 제공됩니다.

정적 광고 삽입

정적 광고 삽입의 특징은 플레이어를 만들기 전에 관련 광고 메타데이터를 추가하는 것입니다. 이 정보는 LoadRequestData의 MediaInformation에서 제공됩니다. 예를 들어 연결된 발신자의 원래 로드 요청에서 설정하거나 LOAD 요청을 가로채서 Web Receiver 애플리케이션에서 삽입할 수 있습니다. LoadRequestData가 처리를 위해 웹 수신기 SDK로 반환되면 플레이어가 생성됩니다. 미디어 로드에 관해 자세히 알아보세요. 아래 샘플은 LOAD 요청 인터셉터에 추가되는 수동 클라이언트 연결 광고를 보여줍니다.

const context = cast.framework.CastReceiverContext.getInstance();
const playerManager = context.getPlayerManager();

playerManager.setMessageInterceptor(
    cast.framework.messages.MessageType.LOAD, loadRequestData => {

  // Create the BreakClip.
  let clipClient = new cast.framework.messages.BreakClip('bc_client');
  clipClient.title = 'The Ad Title to be displayed during playback';
  clipClient.contentId = 'https://example.com/ad.mp4';
  clipClient.contentType = 'video/mp4';

  // Create the Break using the BreakClip id above.
  let breakPostrollClient = new cast.framework.messages.Break(
      'break_postroll_client', ['bc_client'], -1);

  // Set the ad information in the load request data.
  let media = loadRequestData.media;
  media.breakClips = [clipClient];
  media.breaks = [breakPostrollClient];

  return loadRequestData;
});

동적 광고 삽입

동적 광고 삽입의 특징은 콘텐츠 재생 중에 광고 시점을 설정하는 것입니다. BreakManager 인스턴스를 가져오고 addBreak API를 호출하면 됩니다. 여기에는 최소한 두 개의 매개변수, 즉 삽입된 확장 Break 매개변수와 BreakClip 배열이 필요합니다. true로 설정된 경우 MediaStatus 브로드캐스트를 통해 연결된 발신자에게 변경사항을 강제로 전송하는 세 번째 속성(선택사항)이 포함됩니다. 브레이크 및 브레이크 클립을 추가할 때 상응하는 ID는 고유해야 합니다. 이러한 광고는 플레이어를 만든 후에만 추가할 수 있습니다. 플레이어가 생성되면 웹 수신기 SDK는 PLAYER_LOADING 이벤트를 실행합니다. 스트림의 ID3 메타데이터 변경에 응답하고 Break 및 BreakClip 객체를 만들어 타임라인에 삽입하는 이벤트 핸들러의 사용법을 보여주는 아래 샘플을 참고하세요.

const context = cast.framework.CastReceiverContext.getInstance();
const playerManager = context.getPlayerManager();
const breakManager = playerManager.getBreakManager();

playerManager.addEventListener(cast.framework.events.EventType.ID3, (event) => {

  // Create the BreakClip.
  let clipEmbeddedExpanded = parseBreakClipFromData(event.segmentData);
  let breakEmbeddedExpanded = parseExpandedBreakFromData(event.segmentData);

  // Add the break and break clip.
  breakManager.addBreak(breakEmbeddedExpanded, [clipEmbeddedExpanded]);
});

동적 광고 삭제

동적 광고 시점을 삭제하려면 애플리케이션에서 재생 중에 removeBreakById를 호출해야 합니다. 이 함수는 타임라인에서 삭제할 광고의 문자열 식별자를 가져옵니다. 지정된 breakId는 삽입된 확장 광고 시점을 가리켜야 합니다. 다른 유형의 광고 시점이 감지되면 광고 시점이 타임라인에 유지됩니다. 줄바꿈을 삭제하는 아래 샘플을 참조하세요.

const context = cast.framework.CastReceiverContext.getInstance();
const playerManager = context.getPlayerManager();
const breakManager = playerManager.getBreakManager();

breakManager.removeBreakById('break_midroll_embedded_expanded');

광고 시점 동작

SDK는 플레이어가 쉬는 시간에 들어가고 나올 때의 기본 동작을 정의하고 BreakManager에 제공된 일부 API를 사용하여 이를 추가로 맞춤설정할 수 있는 방법을 제공합니다.

기본 광고 시점 동작

일반 재생 또는 Break을 탐색하여 Break가 입력되면 SDK는 isWatched 속성을 확인하여 사용자가 이미 보았는지 평가합니다. 생성 시 이 속성의 광고 시점 기본값은 false입니다. 속성이 true이면 시작 시 광고 시점이 재생되지 않으며 기본 콘텐츠는 계속 재생됩니다. 속성이 false인 경우 입력하면 광고 시점이 재생됩니다.

지난 중단을 탐색할 때 기본 구현은 position가 탐색 작업의 seekFrom 및 seekTo 값 사이에 있는 모든 Break 항목을 가져옵니다. 이 광고 시간 목록에서 SDK는 position가 seekTo 값에 가장 가깝고 isWatched 속성이 false로 설정된 Break를 재생합니다. 그러면 이 광고 시점의 isWatched 속성이 true로 설정되고 플레이어가 광고 시점 클립 재생을 시작합니다. 광고 시점이 시청되면 기본 콘텐츠는 seekTo 위치에서 재생을 다시 시작합니다. 이러한 중단이 없으면 중단이 재생되지 않으며 기본 콘텐츠는 seekTo 위치에서 다시 재생됩니다.

중단 재생 중에 SDK는 MediaStatus에서 연결된 발신자 애플리케이션에 관련 업데이트를 브로드캐스트합니다. 이러한 애플리케이션은 브로드캐스트를 사용하여 breakStatus 속성을 읽어 광고 UI를 업데이트합니다. 이 속성은 광고 시점 재생 중에만 정의됩니다.

수신기 애플리케이션은 PlayerManager getBreakClipCurrentTimeSec를 호출하여 표시되는 BreakClip의 현재 시간을 기준으로 플레이헤드의 위치와 관련된 정보를 직접 쿼리할 수도 있습니다. 마찬가지로 애플리케이션은 getBreakClipDurationSec를 호출하여 현재 BreakClip의 지속 시간을 쿼리할 수 있습니다.

맞춤 광고 시간 동작

브레이크 및 브레이크 클립의 기본 동작은 BreakManager에 제공된 setBreakClipLoadInterceptor 및 setBreakSeekInterceptor 메서드를 사용하여 수정할 수 있습니다.

중단 탐색 인터셉터

광고 시점 탐색 인터셉터를 사용하면 앱에서 광고 시점 탐색 동작을 제어할 수 있습니다. 이 함수는 하나 이상의 줄바꿈에서 앞뒤로 탐색하는 탐색 작업이 요청되면 트리거됩니다. 호출하면 BreakSeekData가 매개변수로 콜백 함수에 전달됩니다. BreakSeekData 객체에는 position 속성이 seekFrom로 정의된 플레이헤드 시간과 탐색 대상 시간 seekTo 사이의 숫자로 설정된 Break 객체의 배열이 포함되어 있습니다.

이 인터셉터를 사용하면 각 중단의 Break 객체를 수정할 수 있습니다. 구현된 시점 탐색 인터셉터는 선택적으로 수정된 BreakSeekData 객체를 반환하여 재생할 광고 시점을 지정해야 합니다. 플레이어는 반환 값에 포함된 모든 쉬는 시간을 계속 재생합니다. 값이 null이거나 중단 탐색 인터셉터에서 아무것도 반환되지 않으면 브레이크를 건너뜁니다.

이미 시청한 광고 시점을 제외하고 탐색된 모든 광고 시점을 보기 위해 기본 동작을 재정의하는 인터셉터의 간단한 구현은 아래 샘플을 참고하세요.

const context = cast.framework.CastReceiverContext.getInstance();
const playerManager = context.getPlayerManager();
const breakManager = playerManager.getBreakManager();

breakManager.setBreakSeekInterceptor((breakSeekData) => {

  // Filter the breaks array by removing watched breaks.
  const unwatchedBreaks =
      breakSeekData.breaks.filter(adBreak => !adBreak.isWatched);
  breakSeekData.breaks = unwatchedBreaks;

  return breakSeekData;
});

클립 로드 인터셉터 중단

중단 클립 로드 인터셉터를 사용하면 재생이 시작되기 전에 BreakClip 객체를 수정할 수 있습니다.

중단 클립 로드 인터셉터는 스티치된 타임라인 중단에서만 호출되며 setBreakClipLoadInterceptor를 사용하여 설정할 수 있습니다. Break를 입력하기 전에 이 인터셉터는 해당 브레이크에 정의된 각 개별 BreakClip에 대해 한 번씩 호출됩니다. SDK는 원본 BreakClip 객체를 콜백 함수의 매개변수로 전달합니다. 그러면 애플리케이션은 SDK가 업데이트된 구성으로 중단 클립을 가져와 표시할 수 있도록 이 BreakClip를 수정하고 반환할 수 있습니다. null이거나 아무것도 반환되지 않으면 나누기 클립을 건너뜁니다.

아래에서 BreakClip의 id가 URL에 매핑되는 유틸리티 함수 getUrlFromClipId를 사용하여 광고 시점 클립의 contentUrl를 수정하는 예를 확인하세요.

const context = cast.framework.CastReceiverContext.getInstance();
const playerManager = context.getPlayerManager();
const breakManager = playerManager.getBreakManager();

breakManager.setBreakClipLoadInterceptor(
    (breakClip, breakClipLoadInterceptorContext) => {

  // Obtains the URL of a break clip id from a function call.
  breakClip.contentUrl = getUrlFromClipId(breakClip.id);

  return breakClip;
});

광고 건너뛰기

Web Receiver SDK는 광고 시간 내에서 광고 시점과 개별 광고 시점 클립을 건너뛰는 API를 제공합니다. 이 SDK를 사용하면 사용자가 발신기 애플리케이션 또는 스마트 디스플레이 기기와 상호작용하여 선택적으로 광고 시점 클립을 건너뛸 수 있습니다.

사용자가 건너뛸 수 있는 광고 시간 클립

휴식 시간 클립을 건너뛸 수 있도록 설정하면 사용자가 연결된 발신자 애플리케이션 및 스마트 디스플레이 기기와 상호작용하여 현재 재생 중인 휴식 시간 클립의 나머지 부분을 선택적으로 건너뛸 수 있습니다. whenSkippable 속성을 음수가 아닌 시간(초)으로 설정하면 BreakClip 객체에 이 기능이 사용 설정됩니다. 플레이어는 광고 시간 클립이 해당 시간(초) 동안 재생되면 광고 클립을 건너뛸 수 있는 것으로 간주합니다. 이 값을 0로 설정하면 사용자가 광고 시점 클립을 즉시 건너뛸 수 있습니다.

// Create the BreakClip.
let clip = new cast.framework.messages.BreakClip('bc');
clip.title = 'The Ad Title to be displayed during playback';
clip.whenSkippable = 10; // Users can skip the clip after 10 seconds of playback.

이 정보는 발신자의 원래 로드 요청 또는 수신기 앱에서 설정할 수 있습니다. 건너뛰면 스티치된 타임라인 광고 시점의 광고 시점 클립이 현재 광고 시점 클립의 재생을 중지합니다. 플레이어는 다음 광고 시간 클립(있는 경우)을 로드하거나 기본 콘텐츠를 로드합니다. 건너뛰면 삽입된 타임라인 광고 시점의 광고 시점 클립이 광고 시점 클립의 끝을 찾고 이 지점에서 스트림을 계속 재생합니다.

프로그래매틱 방식으로 광고 건너뛰기

사용자 상호작용 없이 광고를 자동으로 건너뛸 수도 있습니다.

재생에서 전체 중단을 건너뛰려면 애플리케이션에서 Break의 isWatched 속성을 true로 설정해야 합니다. 이 작업은 로드 시퀀스 또는 콘텐츠 재생 중에 언제든지 실행할 수 있습니다. isWatched 속성은 기본 콘텐츠의 현재 시간에 광고 시점의 position가 충족될 때 플레이어가 평가합니다. 이 시점에서 플레이어는 브레이크를 입력해야 하는지 여부를 결정합니다. 플레이어가 로드될 때 모든 브레이크를 반복하고 값을 수정하는 아래 샘플을 참고하세요.

const context = cast.framework.CastReceiverContext.getInstance();
const playerManager = context.getPlayerManager();
const breakManager = playerManager.getBreakManager();

playerManager.addEventListener(cast.framework.events.EventType.PLAYER_LOADING,
    (event) => {

  // Obtain the breaks and iterate through each item to skip all ad breaks.
  let breaks = breakManager.getBreaks();
  breaks.forEach((brk) => {
    brk.isWatched = true;
  });
});

특정 시점 클립을 프로그래매틱 방식으로 건너뛰려면 브레이크 클립 로드 인터셉터를 사용해야 합니다. null를 반환하거나 콜백 함수에서 값을 반환하지 않으면 해당 브레이크의 클립을 건너뜁니다.

const context = cast.framework.CastReceiverContext.getInstance();
const playerManager = context.getPlayerManager();
const breakManager = playerManager.getBreakManager();

breakManager.setBreakClipLoadInterceptor(
      (breakClip, breakClipLoadInterceptorContext) => {
  return null;
});

큐

게시됨