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 dall'IA per installare il plugin. Aggiungi le Capgo competenze al tuo strumento di AI utilizzando il seguente comando:

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

Usa poi 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 l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

Installare il plugin
Fenestra del terminale
```
bun add @capgo/capacitor-privacy-screen
```
Sincronizza le piattaforme native
Fenestra del terminale
```
bunx cap sync
```
Verifica il comportamento della piattaforma
- Leggi il context per il comportamento dello switcher di app.
- Leggi il Note per Android for screenshot and recording behavior.

Comportamento predefinito

Il plugin abilita la protezione della privacy automaticamente quando si carica l'implementazione nativa.

Su Android, il modo sicuro blocca screenshot, registrazione della schermata e anteprima delle app recenti.
Su iOS, il plugin nasconde l'app durante la generazione della snapshot dello switcher di app.
Su Web, il plugin mantiene un flag abilitato in memoria solo per la parità di 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);

Quando disabilitarlo temporaneamente

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

passaggi di verifica dell'account che richiedono screenshot per il supporto
flussi di pagamento o di provider di identità che richiedono una anteprima di app switcher visibile
sessioni di debug controllate su dispositivi affidabili

Ripristina la protezione immediatamente dopo con enable().

Keep going from Getting Started

Se stai utilizzando Getting Started per pianificare la sicurezza e la conformità, connettilo con Utilizzo di @capgo/capacitor-schermo-di-privacy per la capacità nativa in Utilizzo di @capgo/capacitor-schermo-di-privacy Crittografia per il dettaglio di implementazione in Crittografia Conformità per il dettaglio di implementazione in Conformità Capgo Scanner di Sicurezza per il workflow del prodotto in Capgo Scanner di Sicurezza, e Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza.