캡쳐 및 화면녹화 방지

이 페이지에서는 플레이어 캡쳐/녹화 방지를 설정하는 가이드를 설명합니다.

screenRecordingPrevention

화면 스크린캡쳐 or 화면 녹화를 방지합니다.

• iOS는 캡쳐 결과물이 블랙스크린 처리됩니다.
• Android는 "캡쳐를 할 수 없습니다." 토스트와 함께 캡쳐가 방지됩니다.

const playerRef = useRef(null);

return (
    <VpePlayer
        ...
        ref={playerRef}
        options={{
            playlist: [
                {
                    file: 'https://CDN도메인/example_video_01.mp4'
                },
            ],
            screenRecordingPrevention: true, //화면 캡쳐 방지
        }}
        ...
    />
)

의존성 설치

화면 캡쳐 방지는 react-native-capture-protection 네이티브 모듈로 동작합니다. SDK 의존성에 포함되어 있으며, 직접 설치 시 아래와 같습니다.

npm install react-native-capture-protection

iOS 설정

네이티브 모듈은 autolinking 으로 연결됩니다. 설치 후 pod install 및 앱 재빌드가 필요합니다.

cd ios && pod install && cd ..

Android 설정

Android는 별도 수동 링크 없이 autolinking 으로 연결됩니다. 설치 후 앱을 다시 빌드하면screenRecordingPrevention 옵션이 적용됩니다.