开始

复制一个设置提示，包含安装步骤和该插件的完整 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().

继续从开始

如果您正在使用 开始使用 为计划安全性和合规性而连接使用@capgo/capacitor-隐私屏幕为@capgo/capacitor-隐私屏幕中的本机功能加密为加密中的实现细节合规为合规中的实现细节 Capgo 安全扫描器为Capgo 安全扫描器中的产品工作流程 Capgo 安全为Capgo 安全中的产品工作流程