跳到主要内容
版本：v8

@capacitor/privacy-screen

Privacy Screen 插件提供防止敏感信息在应用切换器和离开应用时可见的功能。

注意： 此插件仅支持 Android 和 iOS 平台，不适用于 Web 平台。

安装​

npm install @capacitor/privacy-screen
npx cap sync

平台说明​

Android​

FLAG_SECURE 行为​

当启用 privacy screen 时，插件会自动将 Android 的 FLAG_SECURE 标志应用到窗口。这提供了全面的内容保护：

  • 截图防护：阻止用户截取或录制您的应用的屏幕内容
  • 应用切换器/最近应用：当应用出现在最近应用视图中时，FLAG_SECURE 会使系统显示黑屏或在应用 FLAG_SECURE 之前捕获的最后一帧（通常为空白）
  • 非安全显示保护：防止窗口内容出现在非安全显示器上，如电视、投影仪或投屏到不受信任的设备
  • 实时视图保护：在 FLAG_SECURE 无法完全保护内容的情况下（例如手势导航或可持续数分钟的实时视图片段），插件会显示一个临时的隐私屏幕覆盖层。此覆盖层可通过 dimBackground 配置（显示变暗覆盖层），或默认显示启动画面。
导航方式差异​

隐私屏幕的行为因用户离开应用的方式而异：

  • 最近应用按钮/手势：查看应用切换器时，按配置显示隐私对话框
  • 主页按钮：FLAG_SECURE 确保应用切换器快照中的内容受到保护
  • Activity 后台事件：通过 privacyModeOnActivityHidden 单独控制，适用于生物识别提示等场景

使用​

基本用法​

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

// 使用默认设置启用隐私屏幕
await PrivacyScreen.enable();

// 使用特定平台配置启用
await PrivacyScreen.enable({
  android: {
    dimBackground: true,
    privacyModeOnActivityHidden: 'splash'
  },
  ios: {
    blurEffect: 'dark'
  }
});

// 禁用隐私屏幕
await PrivacyScreen.disable();

// 检查隐私屏幕是否已启用
const { enabled } = await PrivacyScreen.isEnabled();

按屏幕保护​

您可以通过在进入某个屏幕时调用 enable() 并在离开时调用 disable() 来在特定屏幕上启用和禁用隐私屏幕。注意：在屏幕之间导航时，包括使用返回导航时，请确保调用适当的方法。

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

// 导航到安全屏幕时启用隐私屏幕
async function navigateToSecureScreen() {
  await PrivacyScreen.enable({
    android: { dimBackground: true },
    ios: { blurEffect: 'dark' }
  });
  // 导航到您的安全屏幕
}

// 导航到非安全屏幕时禁用
async function navigateToPublicScreen() {
  await PrivacyScreen.disable();
  // 导航到您的公共屏幕
}

API​

enable(...)​

enable(config?: PrivacyScreenConfig | undefined) => Promise<{ success: boolean; }>

启用隐私屏幕保护

参数类型描述
config
PrivacyScreenConfig
可选的平台特定行为配置

返回： Promise<{ success: boolean; }>

disable()​

disable() => Promise<{ success: boolean; }>

禁用隐私屏幕保护

返回： Promise<{ success: boolean; }>

isEnabled()​

isEnabled() => Promise<{ enabled: boolean; }>

检查隐私屏幕当前是否已启用

返回： Promise<{ enabled: boolean; }>

接口​

PrivacyScreenConfig​

属性类型
android{ dimBackground?: boolean; preventScreenshots?: boolean; privacyModeOnActivityHidden?: 'none' | 'dim' | 'splash'; }
ios{ blurEffect?: 'none' | 'light' | 'dark'; }

Contents

编辑此页