Panduan Memulai

Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.

        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.

Instalasi

Anda bisa menggunakan AI-Assisted Setup kami untuk menginstal plugin ini. Tambahkan skill Capgo ke tool AI Anda dengan command berikut:

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

Lalu gunakan prompt berikut:

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

Jika Anda lebih memilih Manual Setup, instal plugin dengan menjalankan perintah berikut dan ikuti petunjuk khusus platform di bawah ini:

Install plugin
Jendela terminal
```
bun add @capgo/capacitor-privacy-screen
```
Sinkronisasi platform native
Jendela terminal
```
bunx cap sync
```
Tinjau perilaku platform
- Baca Catatan iOS untuk perilaku app switcher.
- Baca Catatan Android untuk perilaku screenshot dan perekaman layar.

Perilaku default

Plugin ini mengaktifkan proteksi privasi secara otomatis saat implementasi native dimuat.

Di Android, secure mode memblokir screenshot, perekaman layar, dan preview recent apps.
Di iOS, plugin ini menyembunyikan aplikasi Anda saat pembuatan snapshot app switcher.
Di Web, plugin ini hanya menyimpan flag enabled di memori demi paritas API.

Penggunaan dasar

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);

Kesalahan umum

Nonaktifkan sementara: aktifkan kembali segera setelah alur support atau pembayaran yang memerlukan screenshot.
Overlay Android: perilaku dim overlay bisa dikonfigurasi, baca halaman dokumentasi Android sebelum mengubah default.
Paritas Web: isEnabled() di web hanya mencerminkan flag in-memory, bukan proteksi tingkat OS.

Kapan harus menonaktifkannya sementara

Gunakan disable() hanya jika layar saat ini harus tetap terlihat di preview sistem atau dapat di-screenshot oleh user, contohnya:

langkah verifikasi akun yang memerlukan screenshot untuk keperluan support
alur pembayaran atau penyedia identitas yang butuh preview app switcher yang terlihat
sesi debugging terkontrol pada perangkat terpercaya

Pulihkan proteksi segera setelahnya dengan enable().

Lanjutkan dari Getting Started

Jika Anda menggunakan Panduan Memulai untuk merencanakan keamanan dan kepatuhan, hubungkan dengan Menggunakan @capgo/capacitor-privacy-screen untuk kapabilitas native saat Menggunakan @capgo/capacitor-privacy-screen, Enkripsi untuk detail implementasi pada Encryption, Kepatuhan untuk detail implementasi pada Compliance, Capgo Pemindai Keamanan untuk alur kerja produk di Capgo Security Scanner, dan Keamanan Capgo untuk alur kerja produk di Capgo Security.