@ohos.userIAM.userAuth (用户认证)(系统接口)

提供用户认证能力，可应用于设备解锁、支付、应用登录等身份认证场景。

说明：

• 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
• 当前页面仅包含本模块的系统接口，其他公开接口参见@ohos.userIAM.userAuth (用户认证)。

导入模块

import userIAM_userAuth from '@ohos.userIAM.userAuth';

WindowModeType¹⁰⁺

用户认证界面的显示类型。

系统能力：SystemCapability.UserIAM.UserAuth.Core

系统接口: 此接口为系统接口。

WidgetParam¹⁰⁺

用户认证界面配置相关参数。

系统能力：SystemCapability.UserIAM.UserAuth.Core

NoticeType¹⁰⁺

用户身份认证的通知类型。

系统能力：SystemCapability.UserIAM.UserAuth.Core

系统接口: 此接口为系统接口。

userAuth.sendNotice¹⁰⁺

sendNotice(noticeType: NoticeType, eventData: string): void

在使用统一身份认证控件进行用户身份认证时，用于接收来自统一身份认证控件的通知。

需要权限：ohos.permission.SUPPORT_USER_AUTH

系统能力：SystemCapability.UserIAM.UserAuth.Core

系统接口: 此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见用户认证错误码。

示例：

import userAuth from '@ohos.userIAM.userAuth';

interface  EventData {
  widgetContextId: number;
  event: string;
  version: string;
  payload: PayLoad;
}
interface PayLoad {
  type: Object[];
}
try {
  const eventData : EventData = {
    widgetContextId: 123456,
    event: 'EVENT_AUTH_TYPE_READY',
    version: '1',
    payload: {
      type: ['pin']
    } as PayLoad,
  };
  const jsonEventData = JSON.stringify(eventData);
  let noticeType = userAuth.NoticeType.WIDGET_NOTICE;
  userAuth.sendNotice(noticeType, jsonEventData);
  console.log('sendNotice success');
} catch (error) {
  console.error('sendNotice catch error: ' + JSON.stringify(error));
}

UserAuthWidgetMgr¹⁰⁺

组件管理接口，可将用身份认证控件注册到UserAuthWidgetMgr中，由UserAuthWidgetMgr进行管理、调度。

on¹⁰⁺

on(type: 'command', callback: IAuthWidgetCallback): void

身份认证控件订阅来自用户认证框架的命令。

系统能力：SystemCapability.UserIAM.UserAuth.Core

系统接口: 此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见用户认证错误码。

示例：

import userAuth from '@ohos.userIAM.userAuth';

const userAuthWidgetMgrVersion = 1;
try {
  let userAuthWidgetMgr = userAuth.getUserAuthWidgetMgr(userAuthWidgetMgrVersion);
  console.log('get userAuthWidgetMgr instance success');
  userAuthWidgetMgr.on('command', {
    sendCommand(cmdData) {
      console.log('The cmdData is ' + cmdData);
    }
  })
  console.log('subscribe authentication event success');
} catch (error) {
  console.error('userAuth widgetMgr catch error: ' + JSON.stringify(error));
}

off¹⁰⁺

off(type: 'command', callback?: IAuthWidgetCallback): void

身份认证控件取消订阅来自用户认证框架的命令。

系统能力：SystemCapability.UserIAM.UserAuth.Core

系统接口: 此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见用户认证错误码。

示例：

import userAuth from '@ohos.userIAM.userAuth';

const userAuthWidgetMgrVersion = 1;
try {
  let userAuthWidgetMgr = userAuth.getUserAuthWidgetMgr(userAuthWidgetMgrVersion);
  console.log('get userAuthWidgetMgr instance success');
  userAuthWidgetMgr.off('command', {
    sendCommand(cmdData) {
      console.log('The cmdData is ' + cmdData);
    }
  })
  console.log('cancel subscribe authentication event success');
} catch (error) {
  console.error('userAuth widgetMgr catch error: ' + JSON.stringify(error));
}

userAuth.getUserAuthWidgetMgr¹⁰⁺

getUserAuthWidgetMgr(version: number): UserAuthWidgetMgr

获取UserAuthWidgetMgr对象，用于执行用户身份认证。

说明： 每个UserAuthInstance只能进行一次认证，若需要再次进行认证则需重新获取UserAuthInstance。

需要权限：ohos.permission.SUPPORT_USER_AUTH

系统能力：SystemCapability.UserIAM.UserAuth.Core

系统接口: 此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见用户认证错误码。

示例：

import userAuth from '@ohos.userIAM.userAuth';

let userAuthWidgetMgrVersion = 1;
try {
  let userAuthWidgetMgr = userAuth.getUserAuthWidgetMgr(userAuthWidgetMgrVersion);
  console.log('get userAuthWidgetMgr instance success');
} catch (error) {
  console.error('userAuth widgetMgr catch error: ' + JSON.stringify(error));
}

IAuthWidgetCallback¹⁰⁺

认证组件通过该回调获取用户认证框架发送的命令。

sendCommand¹⁰⁺

sendCommand(cmdData: string): void

回调函数，用于用户认证框架向组件发送命令。

系统能力：SystemCapability.UserIAM.UserAuth.Core

系统接口: 此接口为系统接口。

参数：

示例：

import userAuth from '@ohos.userIAM.userAuth';

const userAuthWidgetMgrVersion = 1;
try {
  let userAuthWidgetMgr = userAuth.getUserAuthWidgetMgr(userAuthWidgetMgrVersion);
  console.log('get userAuthWidgetMgr instance success');
  userAuthWidgetMgr.on('command', {
    sendCommand(cmdData) {
      console.log('The cmdData is ' + cmdData);
    }
  })
  console.log('subscribe authentication event success');
} catch (error) {
  console.error('userAuth widgetMgr catch error: ' + JSON.stringify(error));
}