Erste Schritte

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses 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.

Installation

Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge die Capgo Skills mit dem folgenden Befehl deinem KI-Tool hinzu:

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

Nutze dann diesen Prompt:

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

Wenn du ein manuelles Setup bevorzugst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:

Plugin installieren
Terminalfenster
```
bun add @capgo/capacitor-privacy-screen
```
Native Plattformen synchronisieren
Terminalfenster
```
bunx cap sync
```
Plattformverhalten prüfen
- Lies die iOS-Hinweise für das Verhalten im App-Switcher.
- Lies die Android-Hinweise für Screenshots und Screen-Recording-Verhalten.

Standardverhalten

Das Plugin aktiviert den Datenschutz automatisch, sobald die native Implementierung geladen wird.

Unter Android blockiert der Sicherheitsmodus Screenshots, Bildschirmaufnahmen und die Vorschau in der Übersicht der zuletzt verwendeten Apps.
Unter iOS blendet das Plugin deine App während der Erstellung des App-Switcher-Snapshots aus.
Im Web hält das Plugin lediglich ein In-Memory-Flag für die API Parität bereit.

Basic usage

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

Häufige Stolperfallen

Temporär deaktivieren: sofort wieder aktivieren nach Support- oder Payment-Flows, die Screenshots erfordern.
Android-Overlays: Das Verhalten des Dim-Overlays ist konfigurierbar; lies die Android-Doku, bevor du Defaults änderst.
Web-Parität: isEnabled() Im Web spiegelt sich nur das In-Memory-Flag wider, nicht der Schutz auf OS-Ebene.

Wann man es temporär deaktivieren sollte

Nutzt disable() Nur wenn der aktuelle Screen in System-Vorschauen sichtbar bleiben oder vom User aufgenommen werden soll, zum Beispiel:

Schritte zur Kontoverifizierung, die Screenshots für den Support erfordern
Zahlungs- oder Identity-Provider-Flows, die eine sichtbare App-Switcher-Vorschau benötigen
kontrollierte Debugging-Sessions auf vertrauenswürdigen Geräten

Schutz direkt danach wiederherstellen mit enable().

Weiter geht's nach Getting Started

Wenn du es nutzt Erste Schritte um Sicherheit und Compliance zu planen, verbinden Sie es mit Verwendung von @capgo/capacitor-privacy-screen für die native Funktion bei der Verwendung von @capgo/capacitor-privacy-screen, Verschlüsselung für die Implementierungsdetails in Encryption, Compliance für das Implementierungsdetail in Compliance, Capgo Security-Scanner für den Produkt-Workflow im Capgo Security Scanner, und Capgo Sicherheit für den Produkt-Workflow in Capgo Security.