본문으로 건너뛰기

VOD

메서드​

requestVodAd​

function requestVodAd(nativeId: string, params: VodAdParams): Promise<void>;

<Video nativeID={nativeId}>에서 재생 중인 VOD 콘텐츠의 광고 브레이크를 요청합니다.

여기서는 아무것도 재작성되지 않습니다 — 콘텐츠는 원래 URL로 계속 재생되고, 각 브레이크는 prepare 이벤트로 전달됩니다. 앱은 그 시점에 콘텐츠를 일시정지하고 play를 호출하며, 브레이크는 completed로 끝나고 그때 콘텐츠를 재개합니다.

changeChannelUrl과 동일한 조건이 적용됩니다 — <Video>의 플레이어가 이미 존재해야 합니다.

파라미터타입설명
nativeIdstring콘텐츠를 재생 중인 <Video>의 nativeID
paramsVodAdParams콘텐츠 및 광고 설정

VodAdParams​

필드타입설명
adTagUrlstring광고 서버에서 발급한 광고 태그 URL
contentIdstring콘텐츠 ID
FLOWER 백엔드 시스템에 등록되어 있어야 합니다
durationMsnumberVOD 콘텐츠의 총 재생 시간(밀리초). SDK가 이 값을 기준으로 브레이크를 배치합니다
playerTypePlayerType(선택) 뷰를 소유한 플레이어 라이브러리. 기본값 'react-native-video'
extraParamsStringMap(선택) 타게팅을 위해 사전 협의된 추가 정보
adTagHeadersStringMap(선택) 광고 요청에 추가할 HTTP 헤더
export type VodAdParams = {
  adTagUrl: string;
  contentId: string;
  durationMs: number;
  playerType?: PlayerType;
  extraParams?: StringMap;
  adTagHeaders?: StringMap;
};

해당 nativeID를 가진 뷰가 없거나, 뷰의 플레이어가 아직 생성되지 않았으면 reject됩니다.

notifyContentEnded​

콘텐츠가 끝까지 재생되었음을 SDK에 알려 post-roll이 재생될 수 있게 합니다. notifyContentEnded를 참고하세요.

play​

준비된 브레이크를 시작합니다. play를 참고하세요.

stop​

현재 브레이크를 종료합니다. stop을 참고하세요.

작업 절차​

  1. 콘텐츠 URL로 <Video nativeID="…">를 마운트합니다. VOD에서는 URL이 재작성되지 않습니다.
  2. addAdEventListenerFor로 광고 이벤트를 구독합니다.
  3. onLoad가 발생하면 해당 nativeID로 requestVodAd()를 호출합니다.
  4. prepare에서 콘텐츠를 일시정지하고 play를 호출합니다. completed에서 재개합니다.
  5. post-roll이 재생될 수 있도록 <Video> 컴포넌트의 onEnd prop에서 notifyContentEnded를 호출합니다.
  6. <Video>가 unmount될 때 release를 호출합니다.
// arg0: nativeId, 콘텐츠를 재생 중인 <Video>의 nativeID
// params.adTagUrl:      flower 시스템에서 발급된 URL
//                       adTagUrl은 Anypoint Media에 요청하여 발급받아야 합니다.
// params.contentId:     서비스 내 고유 콘텐츠 ID
// params.durationMs:    VOD 콘텐츠의 재생 시간(밀리초)
// params.extraParams:   (선택) 타게팅용으로 전달할 값
// params.adTagHeaders:  (선택) 광고 요청 헤더에 포함할 값
await requestVodAd('vod-1', {
  adTagUrl: 'https://ad_request',
  contentId: '100',
  durationMs: 3600000,
  extraParams: {genre: 'horror'},
  adTagHeaders: {'custom-ad-header': 'custom-ad-header-value'},
});
주의

durationMs는 콘텐츠의 실제 총 재생 시간이어야 합니다. SDK가 이 값을 기준으로 브레이크 위치를 배치하므로, 값이 잘못되면 mid-roll이 엉뚱한 위치에 삽입됩니다.

관련 API​