Inizia
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
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.
-
Installa il plugin
Finestra del terminale bun add @capgo/capacitor-privacy-screen -
Sincronizza piattaforme native
Finestra del terminale bunx cap sync -
Revisiona il comportamento della piattaforma
- Leggi il note per iOS per il comportamento dello switcher dell'applicazione.
- Leggi il Note per Android per il comportamento di screenshot e registrazione dello schermo.
Comportamento predefinito
Sezione intitolata “Comportamento predefinito”Il plugin abilita la protezione della privacy automaticamente quando l'implementazione nativa viene caricata.
- Su Android, il modo sicuro blocca screenshot, registrazione dello schermo e anteprima delle applicazioni recenti.
- Su iOS, il plugin nasconde l'app durante la generazione della snapshot dell'app switcher.
- Su Web, il plugin mantiene un flag abilitato in memoria solo per API parità.
Utilizzo base
Sezione intitolata “Utilizzo base”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);Quando disabilitarlo temporaneamente
Sezione intitolata “Quando disabilitarla temporaneamente”Usa disable() solo quando la schermata corrente deve rimanere visibile nelle anteprime del sistema o essere catturabile dall'utente, ad esempio:
- passaggi di verifica dell'account che richiedono screenshot per il supporto
- flussi di pagamento o provider di identità che richiedono una anteprima di un app switcher visibile
- sessioni di debug controllate su dispositivi affidabili
Ripristina la protezione immediatamente dopo con enable().