diff --git a/zh-cn/application-dev/reference/apis/js-apis-useriam-faceauth.md b/zh-cn/application-dev/reference/apis/js-apis-useriam-faceauth.md index 5c691506b9bc0e198a9596751e015cc7a697c834..c26124dda4987c523dce6dcf364b7e38821e2b1b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-useriam-faceauth.md +++ b/zh-cn/application-dev/reference/apis/js-apis-useriam-faceauth.md @@ -72,12 +72,12 @@ setSurfaceId(surfaceId: string): void; import userIAM_faceAuth from '@ohos.userIAM.faceAuth'; // 该surfaceId应该从XComponent控件获取，此处仅用作示例。 -let surfaceId = "123456"; +let surfaceId = '123456'; let manager = new userIAM_faceAuth.FaceAuthManager(); try { - manager.setSurfaceId(surfaceId); - console.info("set surface id success"); + manager.setSurfaceId(surfaceId); + console.info('set surface id success'); } catch (e) { - console.error("set surface id failed, error = " + e); + console.error('set surface id failed, error = ' + e); } ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-useriam-userauth.md b/zh-cn/application-dev/reference/apis/js-apis-useriam-userauth.md index 4106e897eb6616072d750f8ff924651f3ecdb922..98cf0d0e691c52d4169fafb07bc790c23d4876d4 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-useriam-userauth.md +++ b/zh-cn/application-dev/reference/apis/js-apis-useriam-userauth.md @@ -31,11 +31,11 @@ import userIAM_userAuth from '@ohos.userIAM.userAuth'; **系统能力**：SystemCapability.UserIAM.UserAuth.Core -| 名称 | 类型 | 必填 | 说明 | -| -------------- | ---------------------------------- | ---- | ------------------------------------------------------ | -| challenge | Uint8Array | 是 | 挑战值，用来防重放攻击。最大长度为32字节，可以填null。 | -| authType | [UserAuthType](#userauthtype8)[] | 是 | 认证类型列表，用来指定用户认证界面提供的认证方法。 | -| authTrustLevel | [AuthTrustLevel](#authtrustlevel8) | 是 | 认证信任等级。 | +| 名称 | 类型 | 必填 | 说明 | +| -------------- | ---------------------------------- | ---- | ------------------------------------------------------------ | +| challenge | Uint8Array | 是 | 挑战值，用来防重放攻击。最大长度为32字节，可传Uint8Array([])。 | +| authType | [UserAuthType](#userauthtype8)[] | 是 | 认证类型列表，用来指定用户认证界面提供的认证方法。 | +| authTrustLevel | [AuthTrustLevel](#authtrustlevel8) | 是 | 认证信任等级。 | ## WidgetParam10+ @@ -93,19 +93,18 @@ const authParam : userAuth.AuthParam = { const widgetParam :userAuth.WidgetParam = { title: '请输入密码', navigationButtonText: '返回', - windowMode: userAuth.WindowModeType.DIALOG_BOX, }; try { - let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); - console.log('get userAuth instance success'); - userAuthInstance.on('result', { - onResult (result) { - console.log('userAuthInstance callback result = ' + JSON.stringify(result)); - } - }); - console.log('auth on success'); + let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); + console.log('get userAuth instance success'); + userAuthInstance.on('result', { + onResult (result) { + console.log('userAuthInstance callback result = ' + JSON.stringify(result)); + } + }); + console.log('auth on success'); } catch (error) { - console.log('auth catch error: ' + JSON.stringify(error)); + console.log('auth catch error: ' + JSON.stringify(error)); } ``` @@ -151,19 +150,18 @@ const authParam : userAuth.AuthParam = { const widgetParam :userAuth.WidgetParam = { title: '请输入密码', navigationButtonText: '返回', - windowMode: userAuth.WindowModeType.DIALOG_BOX, }; try { - let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); - console.log('get userAuth instance success'); - userAuthInstance.on('result', { - onResult (result) { - console.log('userAuthInstance callback result = ' + JSON.stringify(result)); - } - }); - console.log('auth on success'); + let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); + console.log('get userAuth instance success'); + userAuthInstance.on('result', { + onResult (result) { + console.log('userAuthInstance callback result = ' + JSON.stringify(result)); + } + }); + console.log('auth on success'); } catch (error) { - console.log('auth catch error: ' + JSON.stringify(error)); + console.log('auth catch error: ' + JSON.stringify(error)); } ``` @@ -206,19 +204,18 @@ const authParam : userAuth.AuthParam = { const widgetParam :userAuth.WidgetParam = { title: '请输入密码', navigationButtonText: '返回', - windowMode: userAuth.WindowModeType.DIALOG_BOX, }; try { - let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); - console.log('get userAuth instance success'); - userAuthInstance.off('result', { - onResult (result) { - console.log('auth off result: ' + JSON.stringify(result)); - } - }); - console.log('auth off success'); + let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); + console.log('get userAuth instance success'); + userAuthInstance.off('result', { + onResult (result) { + console.log('auth off result: ' + JSON.stringify(result)); + } + }); + console.log('auth off success'); } catch (error) { - console.log('auth catch error: ' + JSON.stringify(error)); + console.log('auth catch error: ' + JSON.stringify(error)); } ``` @@ -264,15 +261,14 @@ const authParam : userAuth.AuthParam = { const widgetParam :userAuth.WidgetParam = { title: '请输入密码', navigationButtonText: '返回', - windowMode: userAuth.WindowModeType.DIALOG_BOX, }; try { - let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); - console.log('get userAuth instance success'); - userAuthInstance.start(); - console.log('auth start success'); + let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); + console.log('get userAuth instance success'); + userAuthInstance.start(); + console.log('auth start success'); } catch (error) { - console.log('auth catch error: ' + JSON.stringify(error)); + console.log('auth catch error: ' + JSON.stringify(error)); } ``` @@ -309,15 +305,14 @@ const authParam : userAuth.AuthParam = { const widgetParam :userAuth.WidgetParam = { title: '请输入密码', navigationButtonText: '返回', - windowMode: userAuth.WindowModeType.DIALOG_BOX, }; try { - let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); - console.log('get userAuth instance success'); - userAuthInstance.cancel(); - console.log('auth cancel success'); + let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); + console.log('get userAuth instance success'); + userAuthInstance.cancel(); + console.log('auth cancel success'); } catch (error) { - console.log('auth catch error: ' + JSON.stringify(error)); + console.log('auth catch error: ' + JSON.stringify(error)); } ``` @@ -369,13 +364,12 @@ const authParam : userAuth.AuthParam = { const widgetParam :userAuth.WidgetParam = { title: '请输入密码', navigationButtonText: '返回', - windowMode: userAuth.WindowModeType.DIALOG_BOX, }; try { - let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); - console.log('get userAuth instance success'); + let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam); + console.log('get userAuth instance success'); } catch (error) { - console.log('auth catch error: ' + JSON.stringify(error)); + console.log('auth catch error: ' + JSON.stringify(error)); } ``` @@ -426,14 +420,14 @@ sendNotice(noticeType: NoticeType, eventData: string): void ```js import userAuth from '@ohos.userIAM.userAuth'; -class EventData { - widgetContextId: number = 0; - event: string = ""; - version: string = ""; - payload: PayLoad = { type: ['pin'] }; +interface EventData { + widgetContextId: number; + event: string; + version: string; + payload: PayLoad; } -class PayLoad { - type:Object[] = []; +interface PayLoad { + type: Object[]; } try { const eventData : EventData = { @@ -490,16 +484,16 @@ 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'); + 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.log('userAuth widgetMgr catch error: ' + JSON.stringify(error)); + console.log('userAuth widgetMgr catch error: ' + JSON.stringify(error)); } ``` @@ -536,16 +530,16 @@ 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'); + 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.log('userAuth widgetMgr catch error: ' + JSON.stringify(error)); + console.log('userAuth widgetMgr catch error: ' + JSON.stringify(error)); } ``` @@ -594,10 +588,10 @@ import userAuth from '@ohos.userIAM.userAuth'; let userAuthWidgetMgrVersion = 1; try { - let userAuthWidgetMgr = userAuth.getUserAuthWidgetMgr(userAuthWidgetMgrVersion); - console.log('get userAuthWidgetMgr instance success'); + let userAuthWidgetMgr = userAuth.getUserAuthWidgetMgr(userAuthWidgetMgrVersion); + console.log('get userAuthWidgetMgr instance success'); } catch (error) { - console.log('userAuth widgetMgr catch error: ' + JSON.stringify(error)); + console.log('userAuth widgetMgr catch error: ' + JSON.stringify(error)); } ``` @@ -628,16 +622,16 @@ 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'); + 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.log('userAuth widgetMgr catch error: ' + JSON.stringify(error)); + console.log('userAuth widgetMgr catch error: ' + JSON.stringify(error)); } ``` @@ -716,39 +710,39 @@ let authTrustLevel = userIAM_userAuth.AuthTrustLevel.ATL1; // 通过callback获取认证结果 try { let auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); - auth.on("result", { + auth.on('result', { callback: (result: userIAM_userAuth.AuthResultInfo) => { - console.log("authV9 result " + result.result); - console.log("authV9 token " + result.token); - console.log("authV9 remainAttempts " + result.remainAttempts); - console.log("authV9 lockoutDuration " + result.lockoutDuration); + console.log('authV9 result ' + result.result); + console.log('authV9 token ' + result.token); + console.log('authV9 remainAttempts ' + result.remainAttempts); + console.log('authV9 lockoutDuration ' + result.lockoutDuration); } } as userIAM_userAuth.AuthEvent); auth.start(); - console.log("authV9 start success"); + console.log('authV9 start success'); } catch (error) { - console.log("authV9 error = " + error); + console.log('authV9 error = ' + error); // do error } // 通过callback获取认证过程中的提示信息 try { let auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); - auth.on("tip", { + auth.on('tip', { callback : (result : userIAM_userAuth.TipInfo) => { switch (result.tip) { case userIAM_userAuth.FaceTips.FACE_AUTH_TIP_TOO_BRIGHT: - // do something; + // do something; case userIAM_userAuth.FaceTips.FACE_AUTH_TIP_TOO_DARK: - // do something; + // do something; default: - // do others + // do others } } } as userIAM_userAuth.AuthEvent); auth.start(); - console.log("authV9 start success"); + console.log('authV9 start success'); } catch (error) { - console.log("authV9 error = " + error); + console.log('authV9 error = ' + error); // do error } ``` @@ -799,34 +793,34 @@ let challenge = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]); let authType = userIAM_userAuth.UserAuthType.FACE; let authTrustLevel = userIAM_userAuth.AuthTrustLevel.ATL1; try { - let auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); - // 订阅认证结果 - auth.on("result", { - callback: (result: userIAM_userAuth.AuthResultInfo) => { - console.log("authV9 result " + result.result); - console.log("authV9 token " + result.token); - console.log("authV9 remainAttempts " + result.remainAttempts); - console.log("authV9 lockoutDuration " + result.lockoutDuration); - } - }); - // 订阅认证过程中的提示信息 - auth.on("tip", { - callback : (result : userIAM_userAuth.TipInfo) => { - switch (result.tip) { - case userIAM_userAuth.FaceTips.FACE_AUTH_TIP_TOO_BRIGHT: - // do something; - case userIAM_userAuth.FaceTips.FACE_AUTH_TIP_TOO_DARK: - // do something; - default: - // do others - } - } - }); - auth.start(); - console.log("authV9 start success"); + let auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); + // 订阅认证结果 + auth.on('result', { + callback: (result: userIAM_userAuth.AuthResultInfo) => { + console.log('authV9 result ' + result.result); + console.log('authV9 token ' + result.token); + console.log('authV9 remainAttempts ' + result.remainAttempts); + console.log('authV9 lockoutDuration ' + result.lockoutDuration); + } + }); + // 订阅认证过程中的提示信息 + auth.on('tip', { + callback : (result : userIAM_userAuth.TipInfo) => { + switch (result.tip) { + case userIAM_userAuth.FaceTips.FACE_AUTH_TIP_TOO_BRIGHT: + // do something; + case userIAM_userAuth.FaceTips.FACE_AUTH_TIP_TOO_DARK: + // do something; + default: + // do others + } + } + } as userIAM_userAuth.AuthEvent); + auth.start(); + console.log('authV9 start success'); } catch (error) { - console.log("authV9 error = " + error); - // do error + console.log('authV9 error = ' + error); + // do error } ``` @@ -865,34 +859,23 @@ import userIAM_userAuth from '@ohos.userIAM.userAuth'; let challenge = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]); let authType = userIAM_userAuth.UserAuthType.FACE; let authTrustLevel = userIAM_userAuth.AuthTrustLevel.ATL1; -let auth; try { - auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); - console.log("get auth instance success"); -} catch (error) { - console.log("get auth instance failed" + error); -} - -try { - // 订阅认证结果 - auth.on("result", { - callback: (result: userIAM_userAuth.AuthResultInfo) => { - console.log("authV9 result " + result.result); - console.log("authV9 token " + result.token); - console.log("authV9 remainAttempts " + result.remainAttempts); - console.log("authV9 lockoutDuration " + result.lockoutDuration); - } - }); - console.log("subscribe authentication event success"); -} catch (error) { - console.log("subscribe authentication event failed " + error); -} -// 取消订阅认证结果 -try { - auth.off("result"); - console.info("cancel subscribe authentication event success"); + let auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); + // 订阅认证结果 + auth.on('result', { + callback: (result: userIAM_userAuth.AuthResultInfo) => { + console.log('authV9 result ' + result.result); + console.log('authV9 token ' + result.token); + console.log('authV9 remainAttempts ' + result.remainAttempts); + console.log('authV9 lockoutDuration ' + result.lockoutDuration); + } + }); + // 取消订阅结果 + auth.off('result'); + console.info('cancel subscribe authentication event success'); } catch (error) { - console.info("cancel subscribe authentication event failed, error = " + error); + console.info('cancel subscribe authentication event failed, error =' + error); + // do error } ``` @@ -940,11 +923,11 @@ let authType = userIAM_userAuth.UserAuthType.FACE; let authTrustLevel = userIAM_userAuth.AuthTrustLevel.ATL1; try { - let auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); - auth.start(); - console.info("authV9 start auth success"); + let auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); + auth.start(); + console.info('authV9 start auth success'); } catch (error) { - console.info("authV9 start auth failed, error = " + error); + console.info('authV9 start auth failed, error = ' + error); } ``` @@ -984,11 +967,11 @@ let authType = userIAM_userAuth.UserAuthType.FACE; let authTrustLevel = userIAM_userAuth.AuthTrustLevel.ATL1; try { - let auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); - auth.cancel(); - console.info("cancel auth success"); + let auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); + auth.cancel(); + console.info('cancel auth success'); } catch (error) { - console.info("cancel auth failed, error = " + error); + console.info('cancel auth failed, error = ' + error); } ``` @@ -1010,7 +993,7 @@ getAuthInstance(challenge : Uint8Array, authType : UserAuthType, authTrustLevel | 参数名 | 类型 | 必填 | 说明 | | -------------- | ---------------------------------------- | ---- | ------------------------ | -| challenge | Uint8Array | 是 | 挑战值，最大长度为32字节，可以填null。 | +| challenge | Uint8Array | 是 | 挑战值，最大长度为32字节，可以传Uint8Array([])。 | | authType | [UserAuthType](#userauthtype8) | 是 | 认证类型，当前支持FACE。 | | authTrustLevel | [AuthTrustLevel](#authtrustlevel8) | 是 | 认证信任等级。 | @@ -1041,10 +1024,10 @@ let authType = userIAM_userAuth.UserAuthType.FACE; let authTrustLevel = userIAM_userAuth.AuthTrustLevel.ATL1; try { - let auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); - console.info("get auth instance success"); + let auth = userIAM_userAuth.getAuthInstance(challenge, authType, authTrustLevel); + console.info('let auth instance success'); } catch (error) { - console.info("get auth instance success failed, error = " + error); + console.info('get auth instance success failed, error = ' + error); } ``` @@ -1084,10 +1067,10 @@ getAvailableStatus(authType : UserAuthType, authTrustLevel : AuthTrustLevel): vo import userIAM_userAuth from '@ohos.userIAM.userAuth'; try { - userIAM_userAuth.getAvailableStatus(userIAM_userAuth.UserAuthType.FACE, userIAM_userAuth.AuthTrustLevel.ATL1); - console.info("current auth trust level is supported"); + userIAM_userAuth.getAvailableStatus(userIAM_userAuth.UserAuthType.FACE, userIAM_userAuth.AuthTrustLevel.ATL1); + console.info('current auth trust level is supported'); } catch (error) { - console.info("current auth trust level is not supported, error = " + error); + console.info('current auth trust level is not supported, error = ' + error); } ``` @@ -1166,7 +1149,7 @@ import userIAM_userAuth from '@ohos.userIAM.userAuth'; let auth = new userIAM_userAuth.UserAuth(); let version = auth.getVersion(); -console.info("auth version = " + version); +console.info('auth version = ' + version); ``` ### getAvailableStatus(deprecated) @@ -1203,9 +1186,9 @@ import userIAM_userAuth from '@ohos.userIAM.userAuth'; let auth = new userIAM_userAuth.UserAuth(); let checkCode = auth.getAvailableStatus(userIAM_userAuth.UserAuthType.FACE, userIAM_userAuth.AuthTrustLevel.ATL1); if (checkCode == userIAM_userAuth.ResultCode.SUCCESS) { - console.info("check auth support success"); + console.info('check auth support success'); } else { - console.error("check auth support fail, code = " + checkCode); + console.error('check auth support fail, code = ' + checkCode); } ``` @@ -1226,7 +1209,7 @@ auth(challenge: Uint8Array, authType: UserAuthType, authTrustLevel: AuthTrustLev | 参数名 | 类型 | 必填 | 说明 | | -------------- | ---------------------------------------- | ---- | ------------------------ | -| challenge | Uint8Array | 是 | 挑战值，可以填null。 | +| challenge | Uint8Array | 是 | 挑战值，可以传Uint8Array([])。 | | authType | [UserAuthType](#userauthtype8) | 是 | 认证类型，当前支持FACE。 | | authTrustLevel | [AuthTrustLevel](#authtrustlevel8) | 是 | 认证信任等级。 | | callback | [IUserAuthCallback](#iuserauthcallbackdeprecated) | 是 | 回调函数。 | @@ -1243,20 +1226,21 @@ auth(challenge: Uint8Array, authType: UserAuthType, authTrustLevel: AuthTrustLev import userIAM_userAuth from '@ohos.userIAM.userAuth'; let auth = new userIAM_userAuth.UserAuth(); -auth.auth(null, userIAM_userAuth.UserAuthType.FACE, userIAM_userAuth.AuthTrustLevel.ATL1, { - onResult: (result, extraInfo) => { - try { - console.info("auth onResult result = " + result); - console.info("auth onResult extraInfo = " + JSON.stringify(extraInfo)); - if (result == userIAM_userAuth.ResultCode.SUCCESS) { - // 此处添加认证成功逻辑 - } else { - // 此处添加认证失败逻辑 - } - } catch (e) { - console.info("auth onResult error = " + e); - } +let challenge = new Uint8Array([]); +auth.auth(challenge, userIAM_userAuth.UserAuthType.FACE, userIAM_userAuth.AuthTrustLevel.ATL1, { + onResult: (result, extraInfo) => { + try { + console.info('auth onResult result = ' + result); + console.info('auth onResult extraInfo = ' + JSON.stringify(extraInfo)); + if (result == userIAM_userAuth.ResultCode.SUCCESS) { + // 此处添加认证成功逻辑 + } else { + // 此处添加认证失败逻辑 + } + } catch (e) { + console.info('auth onResult error = ' + e); } + } }); ``` @@ -1295,9 +1279,9 @@ let contextId = new Uint8Array([0, 1, 2, 3, 4, 5, 6, 7]); let auth = new userIAM_userAuth.UserAuth(); let cancelCode = auth.cancelAuth(contextId); if (cancelCode == userIAM_userAuth.ResultCode.SUCCESS) { - console.info("cancel auth success"); + console.info('cancel auth success'); } else { - console.error("cancel auth fail"); + console.error('cancel auth fail'); } ``` @@ -1332,20 +1316,21 @@ onResult: (result : number, extraInfo : AuthResult) => void import userIAM_userAuth from '@ohos.userIAM.userAuth'; let auth = new userIAM_userAuth.UserAuth(); -auth.auth(null, userIAM_userAuth.UserAuthType.FACE, userIAM_userAuth.AuthTrustLevel.ATL1, { - onResult: (result, extraInfo) => { - try { - console.info("auth onResult result = " + result); - console.info("auth onResult extraInfo = " + JSON.stringify(extraInfo)); - if (result == userIAM_userAuth.ResultCode.SUCCESS) { - // 此处添加认证成功逻辑 - } else { - // 此处添加认证失败逻辑 - } - } catch (e) { - console.info("auth onResult error = " + e); - } +let challenge = new Uint8Array([]); +auth.auth(challenge, userIAM_userAuth.UserAuthType.FACE, userIAM_userAuth.AuthTrustLevel.ATL1, { + onResult: (result, extraInfo) => { + try { + console.info('auth onResult result = ' + result); + console.info('auth onResult extraInfo = ' + JSON.stringify(extraInfo)); + if (result == userIAM_userAuth.ResultCode.SUCCESS) { + // 此处添加认证成功逻辑 + } else { + // 此处添加认证失败逻辑 + } + } catch (e) { + console.info('auth onResult error = ' + e); } + } }); ``` @@ -1374,16 +1359,30 @@ onAcquireInfo ?: (module : number, acquire : number, extraInfo : any) => void import userIAM_userAuth from '@ohos.userIAM.userAuth'; let auth = new userIAM_userAuth.UserAuth(); -auth.auth(null, userIAM_userAuth.UserAuthType.FACE, userIAM_userAuth.AuthTrustLevel.ATL1, { - onAcquireInfo: (module, acquire, extraInfo) => { - try { - console.info("auth onAcquireInfo module = " + module); - console.info("auth onAcquireInfo acquire = " + acquire); - console.info("auth onAcquireInfo extraInfo = " + JSON.stringify(extraInfo)); - } catch (e) { - console.info("auth onAcquireInfo error = " + e); - } +let challenge = new Uint8Array([]); +auth.auth(challenge, userIAM_userAuth.UserAuthType.FACE, userIAM_userAuth.AuthTrustLevel.ATL1, { + onResult: (result, extraInfo) => { + try { + console.info('auth onResult result = ' + result); + console.info('auth onResult extraInfo = ' + JSON.stringify(extraInfo)); + if (result == userIAM_userAuth.ResultCode.SUCCESS) { + // 此处添加认证成功逻辑 + } else { + // 此处添加认证失败逻辑 + } + } catch (e) { + console.info('auth onResult error = ' + e); + } + }, + onAcquireInfo: (module, acquire, extraInfo) => { + try { + console.info('auth onAcquireInfo module = ' + module); + console.info('auth onAcquireInfo acquire = ' + acquire); + console.info('auth onAcquireInfo extraInfo = ' + JSON.stringify(extraInfo)); + } catch (e) { + console.info('auth onAcquireInfo error = ' + e); } + } }); ``` @@ -1506,6 +1505,8 @@ getAuthenticator(): Authenticator **示例：** ```js + import userIAM_userAuth from '@ohos.userIAM.userAuth'; + let authenticator = userIAM_userAuth.getAuthenticator(); ``` @@ -1546,13 +1547,15 @@ callback返回值： **示例：** ```js +import userIAM_userAuth from '@ohos.userIAM.userAuth'; + let authenticator = userIAM_userAuth.getAuthenticator(); -authenticator.execute("FACE_ONLY", "S2", (error, code)=>{ - if (code === userIAM_userAuth.ResultCode.SUCCESS) { - console.info("auth success"); - return; - } - console.error("auth fail, code = " + code); +authenticator.execute('FACE_ONLY', 'S2', (error, code)=>{ + if (code === userIAM_userAuth.ResultCode.SUCCESS) { + console.info('auth success'); + return; + } + console.error('auth fail, code = ' + code); }); ``` @@ -1586,11 +1589,13 @@ execute(type : AuthType, level : SecureLevel): Promise<number> **示例：** ```js +import userIAM_userAuth from '@ohos.userIAM.userAuth'; + let authenticator = userIAM_userAuth.getAuthenticator(); -authenticator.execute("FACE_ONLY", "S2").then((code)=>{ - console.info("auth success"); +authenticator.execute('FACE_ONLY', 'S2').then((code)=>{ + console.info('auth success'); }).catch((error)=>{ - console.error("auth fail, code = " + error); + console.error('auth fail, code = ' + error); }); ``` diff --git a/zh-cn/application-dev/security/userauth-guidelines.md b/zh-cn/application-dev/security/userauth-guidelines.md index 2c352952bf4e7ae09a9907c9198d7e9bd2673566..c0d701f5d4f88901656ed3cb05e57b163a8dc380 100644 --- a/zh-cn/application-dev/security/userauth-guidelines.md +++ b/zh-cn/application-dev/security/userauth-guidelines.md @@ -48,9 +48,9 @@ userIAM_userAuth模块提供了用户认证的相关方法，包括查询认证 // 查询认证能力是否支持 try { userIAM_userAuth.getAvailableStatus(userIAM_userAuth.UserAuthType.FACE, userIAM_userAuth.AuthTrustLevel.ATL1); - console.info("current auth trust level is supported"); + console.info('current auth trust level is supported'); } catch (error) { - console.info("current auth trust level is not supported, error = " + error); + console.info('current auth trust level is not supported, error = ' + error); } ``` @@ -79,7 +79,6 @@ userIAM_userAuth模块提供了用户认证的相关方法，包括查询认证 const widgetParam : userIAM_userAuth.WidgetParam = { title: '请输入密码', navigationButtonText: '返回', - windowMode: userIAM_userAuth.WindowModeType.DIALOG_BOX, }; try { //获取认证对象 @@ -129,7 +128,6 @@ userIAM_userAuth模块提供了用户认证的相关方法，包括查询认证 const widgetParam : userIAM_userAuth.WidgetParam = { title: '请输入密码', navigationButtonText: '返回', - windowMode: userIAM_userAuth.WindowModeType.DIALOG_BOX, }; try { //获取认证对象