@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 (error) {
  console.error('set surface id failed, error = ' + error);
}