본문으로 건너뛰기

Linear Channels / FAST

메서드​

changeChannelUrl​

function changeChannelUrl(nativeId: string, params: ChannelParams): Promise<string>;

<Video nativeID={nativeId}>의 플레이어를 SDK에 인계하고, params.videoUrl 대신 재생할 로컬 프록시 URL을 반환합니다.

<Video>는 이미 원본 URL로 마운트되어 있어야 합니다. react-native-video는 소스가 설정된 뒤에야 플레이어를 만들고, SDK는 어댑터를 선택하기 위해 그 인스턴스가 필요하기 때문입니다. onLoad를 기다리는 것이 확실한 신호입니다.

파라미터타입설명
nativeIdstring인계할 <Video>의 nativeID
paramsChannelParams채널 및 광고 설정

ChannelParams​

필드타입설명
videoUrlstring원본 재생 URL
adTagUrlstring광고 서버에서 발급한 광고 태그 URL
channelIdstring채널 ID
FLOWER 백엔드 시스템에 등록된 채널 ID여야 합니다
playerTypePlayerType(선택) 뷰를 소유한 플레이어 라이브러리. 기본값 'react-native-video'
extraParamsStringMap(선택) 타게팅을 위해 사전 협의된 추가 정보
adTagHeadersStringMap(선택) 광고 요청에 추가할 HTTP 헤더
channelStreamHeadersStringMap(선택) 원본 스트림 요청에 추가할 HTTP 헤더
prerollAdTagUrlstring(선택) 채널 재생 전에 삽입할 pre-roll 광고 태그 URL
export type ChannelParams = {
  videoUrl: string;
  adTagUrl: string;
  channelId: string;
  playerType?: PlayerType;
  extraParams?: StringMap;
  adTagHeaders?: StringMap;
  channelStreamHeaders?: StringMap;
  prerollAdTagUrl?: string;
};

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

stop​

해당 채널의 현재 광고 브레이크를 중단합니다. 콘텐츠 재생은 계속됩니다. stop을 참고하세요.

작업 절차​

  1. react-native-video가 플레이어를 만들도록 원본 스트림 URL로 <Video nativeID="…">를 마운트합니다.
  2. 광고 재생에 반응해야 한다면 addAdEventListenerFor로 광고 이벤트를 구독합니다.
  3. onLoad가 발생하면 해당 nativeID로 changeChannelUrl()을 호출합니다.
  4. <Video>의 소스를 반환된 프록시 URL로 교체합니다. 플레이어는 재생성되지 않고 재사용됩니다.
  5. <Video>가 unmount될 때 release를 호출합니다.
// arg0: nativeId, 인계할 <Video>의 nativeID
// params.videoUrl:              Linear TV 원본 스트림 URL
// params.adTagUrl:              flower 시스템에서 발급된 URL
//                               adTagUrl은 Anypoint Media에 요청하여 발급받아야 합니다.
// params.channelId:             서비스 내 고유 채널 ID
// params.extraParams:           (선택) 타게팅용으로 전달할 값
// params.adTagHeaders:          (선택) 광고 요청 헤더에 포함할 값
// params.channelStreamHeaders:  (선택) 채널 스트림 요청 헤더에 포함할 값
// params.prerollAdTagUrl:       (선택) pre-roll 광고 태그 URL
const proxyUrl = await changeChannelUrl('channel-1', {
  videoUrl: 'https://XXX',
  adTagUrl: 'https://ad_request',
  channelId: '100',
  extraParams: {genre: 'horror'},
  adTagHeaders: {'custom-ad-header': 'custom-ad-header-value'},
  channelStreamHeaders: {'custom-stream-header': 'custom-stream-header-value'},
  prerollAdTagUrl: 'https://preroll_ad_request',
});

setSourceUri(proxyUrl);

관련 API​