Primeros pasos

Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este 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.

Instalación

Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:

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

Luego usa el siguiente prompt:

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

Si prefieres la configuración manual, instala el plugin ejecutando estos comandos y sigue las instrucciones de cada plataforma:

Instalar el plugin
Ventana de terminal
```
bun add @capgo/capacitor-privacy-screen
```
Sincronizar plataformas nativas
Ventana de terminal
```
bunx cap sync
```
Revisar el comportamiento de la plataforma
- Lee la Notas de iOS sobre el comportamiento del app switcher.
- Lee la Notas de Android sobre el comportamiento de capturas y grabaciones.

Comportamiento por defecto

El plugin activa la protección de privacidad automáticamente al cargar la implementación nativa.

En Android, el modo seguro bloquea capturas de pantalla, grabaciones de pantalla y la vista previa de apps recientes.
En iOS, el plugin oculta tu app durante la generación de la captura del app switcher.
En Web, el plugin mantiene un flag en memoria solo para paridad con API.

Uso básico

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

Errores comunes

Desactivación temporal: reactivación inmediata tras flujos de soporte o pago que requieran capturas de pantalla.
Overlays en AndroidEl comportamiento del overlay dim es configurable; consulta la documentación de Android antes de cambiar los valores por defecto.
Paridad en Web: isEnabled() en web solo refleja el flag en memoria, no la protección a nivel de OS.

Cuándo desactivarlo temporalmente

Usa disable() solo cuando la pantalla actual deba seguir siendo visible en las vistas previas del sistema o sea capturable por el usuario, por ejemplo:

pasos de verificación de cuenta que requieran capturas de pantalla para soporte
flujos de pago o de proveedores de identidad que requieren una vista previa del selector de apps
sesiones de depuración controladas en dispositivos de confianza

Restaurar la protección inmediatamente después con enable().

Continúa desde Getting Started

Si estás usando Primeros pasos para planificar la seguridad y el cumplimiento, conéctalo con Usando @capgo/capacitor-privacy-screen para la capacidad nativa en Usando @capgo/capacitor-privacy-screen, Cifrado para los detalles de implementación en Cifrado, Cumplimiento para los detalles de implementación en Cumplimiento, Escáner de seguridad de Capgo para el flujo de trabajo del producto en Capgo Security Scanner, y Seguridad de Capgo para el flujo de trabajo del producto en Capgo Security.