Getting Started

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 utilizzare la nostra configurazione assistita da AI per installare il plugin. Aggiungi le Capgo competenze al tuo strumento AI utilizzando il seguente comando:

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

Poi utilizza 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 i seguenti comandi e segui le istruzioni specifiche del tuo platform:

Installare 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 dello screenshot e della registrazione.

Comportamento predefinito

La plugin abilita la protezione della privacy automaticamente quando l'implementazione nativa viene caricata.

Sul sistema Android, il modo sicuro blocca le immagini di schermo, la registrazione della schermata e la anteprima delle applicazioni recenti.
Sul sistema iOS, la plugin nasconde l'app durante la generazione della snapshot dell'app switcher.
Sul Web, la plugin mantiene un flag abilitato in memoria solo per API parità.

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

Usa disable() solamente quando la schermata corrente dovrebbe 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 del visualizzatore di app visibile
sessioni di debug controllate su dispositivi affidabili

Ripristina la protezione immediatamente dopo con enable().

Continua da Inizia con

Se stai utilizzando Inizia con per pianificare la sicurezza e la conformità, connettilo con Utilizzando @capgo/capacitor-schermo-di-privacy per la capacità nativa in Utilizzando @capgo/capacitor-schermo-di-privacy, Crittografia per i dettagli di implementazione in Encryption, Compliance per i dettagli di implementazione in Compliance, Capgo Scanner di Sicurezza per il flusso di lavoro del prodotto in Capgo Scanner di Sicurezza, e Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza.