开始使用

复制一个带有安装步骤和完整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
```
查看平台行为
- 阅读"{__CAPGO_KEEP_0__}" iOS注意事项用于应用切换行为。
- 阅读 context:HTML文本片段来自更长的Capgo UI字符串（父键`read_the_style_guide`）。页面/区域：Capgo营销网站。角色：网站副本句子。见于：contributing.astro页面。消息键`read_the_style_guide`（阅读风格指南）。 Android注意事项

用于截图和录屏行为。

标题：默认行为

插件在原生实现加载时自动启用隐私保护。
在Android上，安全模式阻止截图、屏幕录制捕获和最近应用预览。
On Web, the plugin keeps an in-memory enabled flag only for API parity.

在Web上，插件仅在__CAPGO_KEEP_0__平衡时保持内存中启用标志。

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-隐私屏幕 for the native capability in Using @capgo/capacitor-privacy-screen, 用于实现细节的用于实现细节的 __CAPGO_KEEP_0__安全扫描器用于产品工作流程的__CAPGO_KEEP_0__安全扫描器，并且 Capgo安全 for the product workflow in Capgo Security Scanner, and Capgo 为Capgo安全产品工作流程。