본문으로 건너뛰기

SDK 생명주기

이 페이지의 함수들은 SDK 자체와 광고 세션의 생명주기를 관리합니다. 모두 패키지 루트에서 import합니다:

import {
  initialize,
  play,
  notifyContentEnded,
  stop,
  release,
} from '@anypoint/flower-sdk-react-native';

모든 세션 함수는 첫 번째 인자로 nativeId를 받습니다 — 해당 세션이 속한 <Video>의 nativeID prop입니다.

메서드​

initialize​

function initialize(logLevel?: LogLevel): Promise<string>;

SDK를 초기화합니다. 내부에서 동작하는 네이티브 SDK의 버전 문자열을 반환합니다.

파라미터타입설명
logLevelLogLevel(선택) 로그 레벨. 기본값 'Info'
const version = await initialize('Verbose');

play​

function play(nativeId: string): Promise<void>;

준비된 광고 브레이크를 재생합니다. VOD와 인라인 브레이크는 이 호출을 기다리며, Linear TV 브레이크는 스트림의 큐(cue)에 따라 예약되어 자동으로 재생됩니다.

파라미터타입설명
nativeIdstring세션이 속한 <Video>의 nativeID

해당 nativeId로 채널·VOD·인라인 요청이 시작된 적이 없으면 reject됩니다.

notifyContentEnded​

function notifyContentEnded(nativeId: string): Promise<void>;

VOD 콘텐츠가 끝까지 재생되었음을 SDK에 알려 post-roll이 재생될 수 있게 합니다. <Video> 컴포넌트의 onEnd prop에 연결하세요.

파라미터타입설명
nativeIdstring세션이 속한 <Video>의 nativeID

해당 nativeId로 채널·VOD·인라인 요청이 시작된 적이 없으면 reject됩니다.

stop​

function stop(nativeId: string): Promise<void>;

현재 광고 브레이크를 중단합니다. 콘텐츠 재생은 계속되고 세션도 유지됩니다.

파라미터타입설명
nativeIdstring세션이 속한 <Video>의 nativeID

등록되지 않은 nativeId는 reject하지 않고 무시하므로, 세션이 시작된 적이 있는지 추적하지 않고 정리 경로에서 호출할 수 있습니다.

release​

function release(nativeId: string): Promise<void>;

해당 <Video>에서 SDK를 분리합니다. 비디오가 unmount될 때 호출하세요 — 네이티브 측이 광고 오버레이를 보유하므로, 호출하지 않으면 누수됩니다.

파라미터타입설명
nativeIdstring세션이 속한 <Video>의 nativeID

release()는 SDK 내부 리스너를 제거하고 진행 중인 브레이크도 중단하므로, 필요한 정리 호출은 이것 하나입니다. addAdEventListener() 또는 addAdEventListenerFor()로 앱이 직접 만든 구독은 별개이며 직접 제거해야 합니다.

타입​

LogLevel​

type LogLevel = 'Verbose' | 'Debug' | 'Info' | 'Warn' | 'Error' | 'Off';

로그 레벨 설정을 참고하세요.

StringMap​

type StringMap = {[key: string]: string};

타게팅 정보와 HTTP 헤더는 일반 {key: value} 객체입니다. extraParams 정의를 참고하세요.

PlayerType​

type PlayerType = 'react-native-video' | 'bitmovin';

nativeId가 가리키는 뷰를 어떤 플레이어 라이브러리가 소유하는지 지정합니다. 'react-native-video'가 기본값이며 추가 패키지가 필요 없습니다. 'bitmovin'은 앱에 bitmovin-player-react-native가 설치되어 있어야 합니다. Bitmovin 플레이어 사용하기를 참고하세요.

관련 API​