시작하기

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-privacy-screen`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/privacy-screen/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

설치

AI-Assisted Setup으로 플러그인을 설치할 수 있습니다. 다음 명령어로 AI 도구에 Capgo 스킬을 추가하세요:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

그런 다음 아래 프롬프트를 사용하세요:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-privacy-screen` plugin in my project.

수동 설정을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르세요:

플러그인 설치
터미널 창
```
bun add @capgo/capacitor-privacy-screen
```
네이티브 플랫폼 동기화
터미널 창
```
bunx cap sync
```
플랫폼 동작 확인
- 앱 스위처 동작에 대한 iOS 관련 참고 사항을 읽어보세요.
- 앱 스위처 동작에 대한 Android 참고 사항 스크린샷 및 화면 녹화 동작 관련.

기본 동작

네이티브 구현이 로드되면 플러그인이 자동으로 개인정보 보호 기능을 활성화합니다.

Android의 경우, 보안 모드가 스크린샷, 화면 녹화 및 최근 앱 미리보기를 차단합니다.
iOS의 경우, 앱 스위처 스냅샷 생성 시 플러그인이 앱을 숨깁니다.
Web의 경우, API와의 기능 일치를 위해 메모리 내 활성화 플래그만 유지합니다.

기본 사용법

import { PrivacyScreen } from '@capgo/capacitor-privacy-screen';

await PrivacyScreen.disable();

// Run a flow where screenshots or previews are temporarily allowed.

await PrivacyScreen.enable();

const { enabled } = await PrivacyScreen.isEnabled();
console.log('Privacy screen enabled:', enabled);

자주 하는 실수

일시적 비활성화: 스크린샷이 필요한 고객 지원 또는 결제 흐름이 끝나면 즉시 다시 활성화하세요.
Android 오버레이: dim 오버레이 동작은 설정할 수 있으므로, 기본값을 변경하기 전에 Android 문서 페이지를 확인하세요.
웹 동등성: isEnabled() 웹에서는 OS 수준의 보호가 아니라 메모리 내 플래그만 반영됩니다.

일시적으로 비활성화해야 하는 경우

사용 disable() 현재 화면이 시스템 미리보기에 표시되어야 하거나 사용자가 캡처할 수 있어야 하는 경우에만 비활성화하세요. 예시:

고객 지원을 위해 스크린샷이 필요한 계정 인증 단계
앱 전환 미리보기가 필요한 결제 또는 ID 제공업체 인증 흐름
신뢰할 수 있는 기기에서의 제어된 디버깅 세션

Restore protection immediately afterward with enable().

시작하기 다음 단계

사용 중이라면 시작하기 보안 및 컴플라이언스 계획을 세우려면, 다음 항목과 연결하세요: @capgo/capacitor-privacy-screen 사용하기 @capgo/capacitor-privacy-screen 사용하기에서 네이티브 기능은, 암호화 암호화 구현 상세 정보: 컴플라이언스 컴플라이언스 구현 상세 정보: Capgo 보안 스캐너 Capgo Security Scanner에서 제품 워크플로우는, 그리고 Capgo 보안 Capgo Security의 제품 워크플로를 위해.