@capacitor-community/privacy-screen

中文文档
8.0.0发布于 2026/04/28MITTypeScriptESM + CJS零依赖近 30 天下载 8.7万

保护您的应用程序在最近屏幕/App Switcher中显示截图的电容插件 .

中文使用文档
文档目录19 节
  1. 隐私屏幕
  2. 导言
  3. 使用相机插件
  4. 维护者
  5. 安装
  6. 配置
  7. 实例
  8. 演示
  9. 使用量
  10. API 密码
  11. 启用( )
  12. 禁用( c)
  13. 添加聆听器( “ 屏幕记录启动 ” ,...)
  14. 添加倾听器( “ 屏幕记录已停止 ),...)
  15. 添加倾听器( “ 屏幕截图 ” ,...)
  16. 删除所有收听器( )
  17. 接口
  18. 更改日志
  19. 许可证

[尖叫声] 此插件在 维护模式。它只接收关键错误修正和安全更新。 不添加新特性 。 请考虑使用官方 电容隐私屏幕插件 相反,这是自Capacitor 7.


隐私屏幕

@capacitor-community/privacy-screen

电容隐私屏幕插件


导言

⚡️ 电容 保护您的应用程序不显示截图的插件 最近屏幕编号 :应用程序切换器。 。 。 .

打开 机器人,此插件设置 (法语) 将窗口内容视为安全,防止其在截图中出现或在非安全显示上查看.
打开 iOS系统,此插件在应用程序不再活动并失去焦点时隐藏了网页视图窗口(用户界面应用来显示灰色屏幕。 它还能防止截图(会捕捉出黑幕).

使用相机插件

已失效的截图可以像相机插件一样干扰隐藏WebView的插件. 为了避免问题 disable 在使用插件之前,然后 enable 在你完成之后.

维护者

维护者GitHub 图像社会
罗宾·根兹抢劫@robin genz (中文(简体) )

安装

npm install @capacitor-community/privacy-screen
npx cap sync

配置

这些配置值是可用的 :

Prop类型说明默认自兹
enableboolean配置插件是否从启动开始启用 。 仅供Android和iOS使用.true
imageNamestring配置插件是否应该从资产显示自定义图像, 而不是隐私屏幕的默认背景灰色 。 仅供iOS使用.""
contentMode'center' | 'scaleToFill' | 'scaleAspectFit' | 'scaleAspectFill'配置显示图像的内容模式 。 仅供iOS使用."center"
preventScreenshotsboolean配置插件是否在启用时防止截图 。 仅供iOS使用.true5.2.0 (中文(简体) )

实例

单位 capacitor.config.json数字 :

{
  "plugins": {
    "PrivacyScreen": {
      "enable": true,
      "imageName": "Splashscreen",
      "contentMode": "scaleAspectFit",
      "preventScreenshots": false
    }
  }
}

单位 capacitor.config.ts数字 :

/// <reference types="@capacitor-community/privacy-screen" />

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    PrivacyScreen: {
      enable: true,
      imageName: "Splashscreen",
      contentMode: "scaleAspectFit",
      preventScreenshots: false,
    },
  },
};

export default config;

演示

这里有一个实例: robingenz/电容器-插管-demo

使用量

只需要安装插件 。 默认启用保护 .
但是,您可以选择启用/取消保护:

import { PrivacyScreen } from '@capacitor-community/privacy-screen';

const enable = async () => {
  await PrivacyScreen.enable();
};

const disable = async () => {
  await PrivacyScreen.disable();
};

API 密码

启用( )

enable() => Promise<void>

启用隐私屏幕保护 .

仅供Android和iOS使用.

自: 1.1.0 国家


禁用( c)

disable() => Promise<void>

禁用隐私屏幕保护 .

仅供Android和iOS使用.

自: 1.1.0 国家


添加聆听器( “ 屏幕记录启动 ” ,...)

addListener(eventName: 'screenRecordingStarted', listenerFunc: () => void) => Promise<PluginListenerHandle>

屏幕录音开始后调用 .

现在只能在iOS上使用.

参数类型
eventName'screenRecordingStarted'
listenerFunc() => void

回返情况: Promise<PluginListenerHandle>

自: 3.0.2 国家


添加倾听器( “ 屏幕记录已停止 ),...)

addListener(eventName: 'screenRecordingStopped', listenerFunc: () => void) => Promise<PluginListenerHandle>

屏幕录音停止时调用 .

现在只能在iOS上使用.

参数类型
eventName'screenRecordingStopped'
listenerFunc() => void

回返情况: Promise<PluginListenerHandle>

自: 3.0.2 国家


添加倾听器( “ 屏幕截图 ” ,...)

addListener(eventName: 'screenshotTaken', listenerFunc: () => void) => Promise<PluginListenerHandle>

抓取截图时调用.

现在只能在iOS上使用.

参数类型
eventName'screenshotTaken'
listenerFunc() => void

回返情况: Promise<PluginListenerHandle>

自: 3.2.0 (中文(简体) )


删除所有收听器( )

removeAllListeners() => Promise<void>

删除此插件的所有听众 .

自: 3.0.2 国家


接口

插件听筒

Prop类型
remove() => Promise<void>

更改日志

见 变动情况。 。 。 .

许可证

见 自由主义。 。 。 .

版本与发布记录

@capacitor-community/privacy-screen 共发布 41 个版本,首次发布于 2021/01/22;过去 12 个月发布了 2 个版本。

版本发布日期距今
8.0.0latest2026/04/286 个月前
6.1.02026/04/087 个月前
6.0.02025/01/291.8 年前
5.2.1-dev.11d7af3.1738003749dev2025/01/281.8 年前
5.2.12024/08/162 年前
5.2.02024/08/122 年前

关于 @capacitor-community/privacy-screen 的常见问题

@capacitor-community/privacy-screen 是什么?

保护您的应用程序在最近屏幕/App Switcher中显示截图的电容插件 .

如何安装 @capacitor-community/privacy-screen?

在项目目录运行 npm install @capacitor-community/privacy-screen,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capacitor-community/privacy-screen 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capacitor-community/privacy-screen 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capacitor-community/privacy-screen 可以商用吗?

@capacitor-community/privacy-screen 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@capacitor-community/privacy-screen 的下载量有多少?

根据 npm 官方下载统计,@capacitor-community/privacy-screen 在 2026/10/09 – 2026/11/07 这 30 天内被下载 86,960 次,日均约 2,899 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capacitor-community/privacy-screen 还在维护吗?

最新版本 8.0.0 发布于 2026/04/28(6 个月前);至今共发布 41 个版本,其中过去 12 个月发布了 2 个;首次发布于 2021/01/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。