harmony 鸿蒙@ohos.ability.screenLockFileManager (锁屏敏感数据管理)

2025-06-12
浏览 (175)

@ohos.ability.screenLockFileManager (锁屏敏感数据管理)

敏感数据密钥在锁屏后会触发销毁，销毁后敏感数据无法读写，需解锁屏幕触发恢复敏感数据密钥后方可访问。本模块提供应用锁屏下敏感数据保护的能力，支持申请和释放锁屏下敏感数据访问权限等。

说明： 本模块首批接口从API version 12 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { screenLockFileManager } from '@kit.AbilityKit';

AccessStatus

枚举，锁屏下敏感数据访问权限申请的状态。

系统能力： SystemCapability.Security.ScreenLockFileManager

名称	值	说明
ACCESS_DENIED	-1	拒绝授予锁屏下敏感数据访问。
ACCESS_GRANTED	0	授予锁屏下敏感数据访问。

ReleaseStatus

枚举，锁屏下敏感数据访问权限释放的状态。

系统能力： SystemCapability.Security.ScreenLockFileManager

名称	值	说明
RELEASE_DENIED	-1	拒绝锁屏下敏感数据访问释放。
RELEASE_GRANTED	0	释放锁屏下敏感数据访问。

KeyStatus¹⁸⁺

枚举，锁屏下敏感数据访问权限的状态。

系统能力： SystemCapability.Security.ScreenLockFileManager

名称	值	说明
KEY_NOT_EXIST	-2	应用未开启锁屏敏感数据保护功能。
KEY_RELEASED	-1	锁屏敏感数据访问权限已释放。
KEY_EXIST	0	应用可以访问锁屏敏感数据。

screenLockFileManager.acquireAccess

acquireAccess(): AccessStatus

以同步方法申请锁屏下应用敏感数据访问权限。锁屏后，敏感数据无法被访问，但可通过调用该方法，访问指定类型的敏感数据。

系统能力： SystemCapability.Security.ScreenLockFileManager

返回值：

类型	说明
AccessStatus	锁屏下敏感数据访问权限申请的状态。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.screenLockFileManager错误码。

错误码ID	错误信息
801	The specified SystemCapability name was not found.
29300002	The system ability work abnormally.
29300003	The application is not enabled the data protection under lock screen.
29300004	File access is denied.

示例：

// 申请锁屏下应用敏感数据访问权限
import { screenLockFileManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

try {
    let acquireStatus = screenLockFileManager.acquireAccess();
    if (acquireStatus === screenLockFileManager.AccessStatus.ACCESS_GRANTED) {
        hilog.info(0x0000, 'testTag', 'acquireAccess successfully.');
    }
} catch (err) {
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'acquireAccess failed: %{public}s', message);
}

screenLockFileManager.releaseAccess

releaseAccess(): ReleaseStatus

以同步方法取消锁屏下应用敏感数据访问权限。

系统能力： SystemCapability.Security.ScreenLockFileManager

返回值：

类型	说明
ReleaseStatus	锁屏下敏感数据访问权限释放的状态。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.screenLockFileManager错误码。

错误码ID	错误信息
801	The specified SystemCapability name was not found.
29300002	The system ability work abnormally.
29300003	The application is not enabled the data protection under lock screen.
29300005	File access was not acquired.

示例：

// 释放锁屏下应用敏感数据访问权限
import { screenLockFileManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

try {
    let releaseStatus = screenLockFileManager.releaseAccess();
    if (releaseStatus === screenLockFileManager.ReleaseStatus.RELEASE_GRANTED) {
        hilog.info(0x0000, 'testTag', 'releaseAccess successfully.');
    }
} catch (err) {
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'releaseAccess failed: %{public}s', message);
}

screenLockFileManager.queryAppKeyState¹⁸⁺

queryAppKeyState(): KeyStatus

以同步方法查询锁屏下应用敏感数据访问权限。

系统能力： SystemCapability.Security.ScreenLockFileManager

返回值：

类型	说明
KeyStatus	锁屏下敏感数据访问权限的状态。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.screenLockFileManager错误码。

错误码ID	错误信息
801	The specified SystemCapability name was not found.
29300002	The system ability work abnormally.

示例：

// 查询锁屏下应用敏感数据访问权限
import { screenLockFileManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

try {
    let keyStatus = screenLockFileManager.queryAppKeyState();
    if (keyStatus === screenLockFileManager.KeyStatus.KEY_NOT_EXIST) {
        hilog.info(0x0000, 'testTag', 'Key does not exist.');
    } else if (keyStatus === screenLockFileManager.KeyStatus.KEY_RELEASED) {
        hilog.info(0x0000, 'testTag', 'Key has been released.');
    } else if (keyStatus === screenLockFileManager.KeyStatus.KEY_EXIST) {
        hilog.info(0x0000, 'testTag', 'Key exists.');
    }
} catch (err) {
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryAppKeyState failed: %{public}s', message);
}