설치

VPE TV SDK를 설치하고 프로젝트를 설정하는 방법을 안내합니다.

패키지 설치

yarn add @sgrsoft/vpe-reactnative-tv-sdk

peerDependencies 설치

yarn add react @sgrsoft/react-native-video @sgrsoft/vpe-core-sdk \
  @sgrsoft/vpe-react-native-ui @react-native-async-storage/async-storage

react-native-tvos 설정

react-native는 반드시 react-native-tvos로 alias되어야 합니다. 일반 react-native와 동시 사용이 불가합니다.

package.json에 아래와 같이 설정합니다.

{
  "react-native": "npm:react-native-tvos@0.83.0-0"
}

선택적 의존성

캡처 방지 기능을 사용하려면 추가 패키지가 필요합니다.

yarn add react-native-capture-protection

tvOS 사전 설정

tvOS 빌드를 위해 CocoaPods 의존성을 설치합니다.

cd ios && pod install

Android TV 사전 설정

IMA 광고를 사용하는 경우 android/gradle.properties에 아래 설정을 추가합니다.

RNVideo_useExoplayerIMA=true

공공 / 민간 클라우드 설정

Naver Cloud Platform 환경에 따라 platform prop을 설정합니다.

환경	platform 값	설명
민간 클라우드	`"pub"`	Naver Cloud Platform 민간 환경 (기본값)
공공 클라우드	`"gov"`	Naver Cloud Platform 공공 환경

// 민간 클라우드 (기본값)
<VpePlayer accessKey="YOUR_ACCESS_KEY" platform="pub" ... />

// 공공 클라우드
<VpePlayer accessKey="YOUR_ACCESS_KEY" platform="gov" ... />

플랫폼별 해상도

플랫폼	보고 해상도	스케일	실제 해상도
Apple TV	1920 x 1080	1x	1920 x 1080
Android TV	960 x 540	2x	1920 x 1080

Android TV는 960x540 dp로 보고됩니다. SDK가 내부적으로 자동 스케일 보정을 적용합니다.