Per iniziare

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.

Installazione

Puoi usare il nostro setup assistito dall'IA per installare il plugin. Aggiungi le skill Capgo al tuo strumento di IA usando il seguente comando:

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

Poi usa il seguente prompt:

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

Se preferisci la configurazione manuale, installa il plugin eseguendo questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:

Installa il plugin
Finestra del terminale
```
bun add @capgo/capacitor-privacy-screen
```
Sincronizza le piattaforme native
Finestra del terminale
```
bunx cap sync
```
Verifica il comportamento della piattaforma
- Leggi la Note per iOS per il comportamento dell'app switcher.
- Leggi la Note per Android per il comportamento di screenshot e registrazione.

Comportamento predefinito

Il plugin abilita automaticamente la protezione della privacy al caricamento dell'implementazione nativa.

Su Android, la secure mode blocca screenshot, registrazione dello schermo e l'anteprima delle app recenti.
Su iOS, il plugin nasconde l'app durante la generazione dello snapshot dell'app switcher.
Sul Web, il plugin mantiene un flag enabled in memoria solo per parità con API.

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

Errori comuni

Disattivazione temporanea: riattivazione immediata dopo i flussi di supporto o di pagamento che richiedono screenshot.
Overlay Android: il comportamento dell'overlay di oscuramento è configurabile; leggi la documentazione Android prima di modificare i default.
Parità Web: isEnabled() sul web riflette solo il flag in memoria, non la protezione a livello di OS.

Quando disattivarlo temporaneamente

Usa disable() solo quando la schermata corrente deve rimanere visibile nelle anteprime di sistema o essere catturabile dall'utente, ad esempio:

passaggi di verifica dell'account che richiedono screenshot per il supporto
flussi di pagamento o identity provider che richiedono l'anteprima dell'app switcher
sessioni di debugging controllate su dispositivi fidati

Ripristina la protezione immediatamente dopo con enable().

Continua da Getting Started

Se stai usando Per iniziare per pianificare sicurezza e compliance, collegalo a Usare @capgo/capacitor-privacy-screen per la funzionalità nativa in Using @capgo/capacitor-privacy-screen, Crittografia per i dettagli di implementazione della crittografia, Conformità per i dettagli di implementazione in Compliance, Security Scanner di Capgo per il workflow di prodotto in Capgo Security Scanner, e Sicurezza Capgo per il workflow di prodotto in Capgo Security.