开始教程

复制一个包含安装步骤和完整 Markdown 指南的配置提示。

        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.

安装

您可以使用我们的 AI 助手设置来安装插件。使用以下命令将 Capgo 技能添加到您的 AI 工具中：

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

然后使用以下提示：

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

如果您更喜欢手动设置，请运行以下命令安装插件，并按照以下平台特定的说明进行操作：

安装插件
终端窗口
```
bun add @capgo/capacitor-privacy-screen
```
同步本机平台
终端窗口
```
bunx cap sync
```
查看平台行为
- 阅读 iOS注意事项关于应用切换行为的说明。
- 阅读 Android注意事项用于截屏和录屏行为的。

默认行为

插件在原生实现加载时自动启用隐私保护。

在Android上，安全模式阻止截屏、屏幕录屏捕获和最近应用预览。
在iOS上，插件在应用切换快照生成时隐藏您的应用。
在Web上，插件仅在API对齐时为内存启用标志。

基本使用

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

何时临时禁用它

仅在以下情况下使用： disable() 例如：

需要用户截图以获取支持的账户验证步骤
需要可见的应用切换预览的支付或身份提供商流程
在信任的设备上进行受控的调试会话

然后立即恢复保护 enable().

继续从 Getting Started

如果您正在使用 Getting Started 来规划安全性和合规性，连接它使用 @capgo/capacitor-privacy-screen 使用 @capgo/capacitor-privacy-screen 加密加密合规合规 Capgo 安全扫描器 Capgo 安全 Capgo Security for the product workflow in Capgo Security.