说起来，

拒绝社死！旁边有人偷瞄，手把手教你给App加上鸿蒙程序级“防窥”黑科技！说起来，

大家好，我是青蓝逐码的云杰。

在鸿蒙程序中，官方为开发者提供了强大的 DeviceSecurityKit其中就包含了一项非常实用的功能：防窥保护。

今天我就以我的应用「取件伙伴」为例。手把手教大家如何优雅地在应用中接入防窥保护功能，并在被旁人窥视时自动拉起程序级的蒙灰层遮盖敏感内容。

先来看看最终在「取件伙伴」中的达到效果：

简单当设备开启了人脸识别并打开了防窥保护开关后程序会通过传感器智能判断当前注视屏幕的人是否是“机主”。

• 如果只有机主在看，屏幕正常显示。
• 如果检测到机主和非机主同时注视屏幕程序就会触发“被窥视”状态。

对开发者来说，可以订阅这个状态。并在被窥视时调用程序 API 拉起一个程序级的蒙层从而保护使用者的隐私数据不被泄露。

二、接入防窥保护的完整流程

很多使用者反映：一旦有陌生人在身边，就担心自己的聊天记录或支付密码被偷窥；但大多数App都没有这类保护功能，让他们无从下手。现在

1. 权限申请: 获取防窥状态所需的程序权限。
2. 前置条件校验: 检查设备是否支持人脸识别，使用者是否已录入人脸数据。
3. 状态检查与引导: 检查程序级防窥开关是否打开；若未打开则引导使用者去设置中开启。
4. 功能开启与事件订阅: 开启应用内开关。并订阅防窥状态变化，在被偷窥时拉起蒙层。
5. 生命周期同步: 处理使用者在程序设置中撤销权限或关闭开关情况，确保应用内状态同步。

当你想要快速启动 App 时却因为忘记授权或者硬件不支持导致无法使用该功能，这会让你产生挫败感。我们下面一步步实现时会特别留意这些细节，让你的 App 更友好、更可靠。不过，

1. 声明必要的权限

在项目中的 module.json5 文件声明获取防窥状态所需权限：

{
"module": {
"requestPermissions":。"when": "inuse"
}
}
]
}
}

别忘了在 string.json 中配置对应理由文案，例如：“用于在检测到非机主偷窥屏幕时保护您的隐私数据”。这一步很关键，否则程序会提示错误并阻止授权成功！

2. 前置条件校验：人脸识别与程序开关

当使用者点击 App 内 “开启防偷窥” 开关时我们不能直接去申请权限，而是先检查设备硬件能力和当前设置状态。下面示例演示如何使用 @kit.UserAunticationKit `userAuth` 来检查人脸识别录入情况：

import { dlpAntiPeep } from '@kit.DeviceSecurityKit';import { userAuth } from '@kit.UserAunticationKit';不过，import { BusinessError } from '@kit.BasicServicesKit';import { abilityAccessCtrl } from '@kit.AbilityKit';import { window } from '@kit.ArkUI';...
// 在 Toggle 的 onChange 中
try {
// 检查设备是否支持并已录入人脸
userAuth.getAvailableStatus(userAuth.UserAuthType.FACE,userAuth.AuthTrustLevel.ATL1);} catch {
const err = error as BusinessError;if {
this.getUIContext.showAlertDialog({
title的观点是。'提示',message: '请先在程序设置中录入人脸，再开启防偷窥。',})，不过，this.isDlpAntiPeepEnabled = false;
return，}
if {
this.getUIContext.showAlertDialog({
title的观点是。'提示',message: '当前设备不支持人脸识别。',})，this.isDlpAntiPeepEnabled = false;return，}
}
...

ArkTS 捕获错误需断言为 BusinessError ,否则无法读取错误码；直接用普通 Error 会导致编译报错！这往往是新手常见坑点之一。

3. 申请权限与引导至程序设置

通过前置校验后再正式申请 ohos.permission.DLP_GET_HIDE_STATUS . 若成功。还要确认 “设置‑隐私与安全‑防偷窥” 已开启，否则弹窗引导去设置：

const context = this.getUIContext.getHostContext as common.UIAbilityContext;const permissionManager = abilityAccessCtrl.createAtManager;try {
const grantStatus =
await permissionManager.requestPermissionsFromUser(context,);if {
// 检查程序级开关
const isSysSwitchOn = await dlpAntiPeep.isDlpAntiPeepSwitchOn;if {
this.getUIContext.showAlertDialog({
title这方面。'开启防偷窥',message:
'请前往 “设置‑隐私与安全‑防偷窥” 并开启该功能。',buttons:
});return，}
// 一切准备就绪
this.isDlpAntiPeepEnabled=true;this.registerAntiPeepListener;}else{
this.isDlpAntiPeepEnabled=false;// 权限拒绝
}
} catch{
const e=err as BusinessError;if{
this.getUIContext.showAlertDialog({
title这方面。'提示',message:'当前设备不支持此功能'
});}
this.isDlpAntiPeepEnabled=false;}
...

4. 主要：订阅状态并拉起程序级蒙层

一切准备好后需要监听 防偷窥 状态。当检测到 “被偷窥” 时通过 WindowId 调用接口拉起蒙层：

private registerAntiPeepListener{
try{
dlpAntiPeep.on=>{
console.log;if{
// 获取 WindowId
const windowStage=
AppStorage.get;const winId=windowStage?.getMainWindowSync
.getWindowProperties.id;if{
dlpAntiPeep.setAntiPeepMaskLayer
.n=>console.info)
.catch);}
}
})
}catch{console.error;}
}
...

获取 WindowId 必须借助 WindowStage；建议将它保存在全局存储，例如在 EntryAbility 的 onWindowStageCreate 生命周期里保存一次：

EntryAbility.onWindowStageCreate{
AppStorage.setOrCreate;}
...

5. 完善生命周期：处理外部变更

•     每次回到前台后检查授权 & 程序开关同步，以免出现 UI 与实际状态不同步的问题。再看比如，你把手机交给朋友，他/她关闭了手机里的 防偷窥 功能，却没通知你。你回来后却看到 UI 上仍然显示为 “已开启”，这会让你产生误解。通过以下代码可及时纠正：