从API版本26.0.1开始,系统支持用户识别。系统持续识别当前使用者。应用可查询最新识别结果或订阅识别结果变化,用于判断当前使用者是否与已登录的系统用户匹配。
具体参数、返回值、错误码等描述,请参考UserRecognitionMgr。
| 接口名称 | 功能描述 |
|---|---|
| getUserRecognitionMgr(): UserRecognitionMgr | null | 获取UserRecognitionMgr实例,用于查询和订阅用户识别结果。 |
| getUserRecognitionResult(): Promise<UserRecognitionResult> | 获取最新的用户识别结果。 |
| onUserRecognitionChange(callback: UserRecognitionResultCallback): void | 订阅用户识别结果变化事件。 |
| offUserRecognitionChange(callback?: UserRecognitionResultCallback): void | 取消订阅用户识别结果变化事件。 |
申请权限:ohos.permission.ACCESS_USER_PASSIVE_RECOGNITION。
该权限授权方式为system_grant,在module.json5中声明即可获取。
调用getUserRecognitionMgr获取实例。
调用getUserRecognitionResult获取最新识别结果,或调用onUserRecognitionChange订阅变化事件。
async obtainingUserRecognitionResult(): Promise<string> {
try {
// 获取实例
let mgr = userAuth.getUserRecognitionMgr();
if (!mgr) {
Logger.error('the device does not support user recognition.');
return 'the device does not support user recognition.';
}
// 获取最新识别结果
let result = await mgr.getUserRecognitionResult();
Logger.info(`status: ${result.status}, userId: ${result.userId}`);
// 订阅识别结果变化
let callback: userAuth.UserRecognitionResultCallback = (recognitionResult: userAuth.UserRecognitionResult) => {
Logger.info(`status: ${recognitionResult.status}, userId: ${recognitionResult.userId}`);
};
mgr.onUserRecognitionChange(callback);
// 取消订阅
mgr.offUserRecognitionChange(callback);
return `status: ${result.status}, userId: ${result.userId}`;
} catch (error) {
const err: BusinessError = error as BusinessError;
const errMessage: string = `getUserRecognitionResult failed, Code: ${err?.code}, message: ${err?.message}`;
Logger.error(errMessage);
return errMessage;
}
}