Prise en main
Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce 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.
-
Installez le plugin
Fenêtre de terminal bun add @capgo/capacitor-privacy-screen -
Synchronisez les plateformes natives
Fenêtre de terminal bunx cap sync -
Examinez le comportement de la plateforme
- Lisez le Notes iOS pour le comportement de l'application de basculement.
- Lisez le Remarques Android pour le comportement de capture d'écran et d'enregistrement.
Comportement par défaut
Section intitulée « Comportement par défaut »Le plugin active automatiquement la protection de la vie privée lorsque la mise en œuvre native est chargée.
- Sur Android, le mode sécurisé bloque la capture d'écran, l'enregistrement de l'écran et la prévisualisation des applications récentes.
- Sur iOS, le plugin cache votre application lors de la génération de la capture d'écran de l'application Switcher.
- Sur Web, le plugin conserve un drapeau activé en mémoire uniquement pour la parité API.
Utilisation de base
Section intitulée « Utilisation de 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);Quand le désactiver temporairement
Lorsque désactiver temporairementUtilisez-le disable() seulement lorsque l'écran actuel doit rester visible dans les aperçus du système ou être capturé par l'utilisateur, par exemple :
- étapes de vérification de compte nécessitant des captures d'écran pour le support
- flux de paiement ou de fournisseur d'identité qui nécessitent un aperçu d'un commutateur d'applications visible
- sessions de débogage contrôlées sur des appareils fiables
Rétablir la protection immédiatement après avec enable().