harmony 鸿蒙@ohos.userIAM.faceAuth (Facial Authentication)

2022-10-28
浏览 (443)

@ohos.userIAM.faceAuth (Facial Authentication)

The userIAM.faceAuth module provides APIs for face enrollment.

NOTE

The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.

The APIs provided by this module are system APIs.

Modules to Import

import userIAM_faceAuth from '@ohos.userIAM.faceAuth';

FaceAuthManager

Provides APIs for facial authentication management.

constructor

constructor()

A constructor used to create a FaceAuthManager object.

System capability: SystemCapability.UserIAM.UserAuth.FaceAuth

System API: This is a system API.

Return value

Type	Description
FaceAuthManager	FaceAuthManager object.

Example

import userIAM_faceAuth from '@ohos.userIAM.faceAuth';

let faceAuthManager = new userIAM_faceAuth.FaceAuthManager();

setSurfaceId

setSurfaceId(surfaceId: string): void;

Sets an XComponent surface ID for the face preview page in the face enrollment process. This API must be used with AddCredential.

System capability: SystemCapability.UserIAM.UserAuth.FaceAuth

System API: This is a system API.

Required permissions: ohos.permission.MANAGE_USER_IDM

Parameters

Name	Type	Mandatory	Description
surfaceId	string	Yes	ID of the surface held by the XComponent.

For details about the following error codes, see User Authentication Error Codes.

Error codes

ID	Error Message
201	Permission verification failed.
202	The caller is not a system application.
12700001	The operation is failed.

Example

import userIAM_faceAuth from '@ohos.userIAM.faceAuth';

// The surfaceId is obtained from the XComponent control. The surfaceId here is only an example.
let surfaceId = '123456';
let manager = new userIAM_faceAuth.FaceAuthManager();
try {
  manager.setSurfaceId(surfaceId);
  console.info('set surface id success');
} catch (e) {
  console.error('set surface id failed, error = ' + e);
}