#HarmonyOS NEXT体验官#梅科尔工作室HOS-用户认证服务：面部识别

引入

欢迎来到未来的世界，在这里，你的脸不仅仅用来吃饭，更是解锁一切的钥匙！

想象一下，早晨醒来，你的咖啡机一看到你那迷人的笑容就开始自动冲泡咖啡；当你走进办公室，门禁系统立刻认出你，甚至还会说一句：“早上好，帅气/美丽的程序员！”这一切听起来像是科幻电影里的场景？不，朋友，这已经不再是梦想——随着HarmonyOS面部识别技术的发展，这些都变得触手可及。

在这篇文章中，我们将一起探索如何利用HarmonyOS的强大功能，让你的应用程序学会识别和验证用户的脸部特征。准备好迎接这场“刷脸”之旅了吗？

介绍

User Authentication Kit（用户认证服务）提供了基于用户在设备本地注册的人脸和指纹来认证用户身份的能力。

用户向应用/系统服务请求访问某些个人数据或执行某些敏感操作时，应用/系统服务将调用系统用户身份认证控件对用户身份进行认证，认证通过后，才响应用户对于数据或敏感操作的执行请求。

用户身份认证可用于各种鉴权场景，如应用内账号登录、支付认证等。

效果预览

开发准备

1.在开发具备用户身份认证的应用前，需要先申请权限ohos.permission.ACCESS_BIOMETRIC，应用才能使用生物特征识别能力（如人脸、指纹）进行身份认证。

该权限授权方式为system_grant（系统授权），开发者只需要在module.json5配置文件的requestPermissions标签中声明权限，即可获取系统授权。

2.设备管理器中的虚拟机不支持指纹和人脸识别，验证开发效果需要烧录到真机(本试验效果预览用的是华为mate60)上进行测试。

3.由于目前HarmonyOS系统不支持第三方录入指纹和人脸，需要在烧录的真机的手机设置里面自行录入指纹和人脸。

实现思路

@ohos.userIAM.userAuthIcon (嵌入式用户身份认证控件)

主要功能：a.提供嵌入式的人脸、指纹认证控件图标，可被应用集成。
b.支持自定义图标的颜色和大小，但图标样式不可变更。

首先导入指纹、人脸认证控件模块；

接着通过AuthParam定义挑战值、认证类型列表、认证信任等级等用户认证参数；

定义之后在UserAuthIcon进行调用，同时可以在UserAuthIcon里的authParam调用用户认证参数， widgetParam定义用户认证的标题，iconHeight定义人脸/指纹控件图标的大小， iconColor定义人脸/指纹控件图标的颜色，onIconClick定义用户点击icon回调接口，onAuthResult用户认证结果信息回调接口。 需要权限： ohos.permission.ACCESS_BIOMETRIC

    import { userAuth, UserAuthIcon } from '@kit.UserAuthenticationKit';//导入模块
    @Entry
    @Component
    struct Index {
    
    authParamzhiwen: userAuth.AuthParam = {
            challenge: new Uint8Array([49, 49, 49, 49, 49, 49]),//挑战值。最大长度为32字节，可传Uint8Array([])。
            authType: [userAuth.UserAuthType.FACE, userAuth.UserAuthType.PIN],//认证类型列表：人脸认证和口令认证
            authTrustLevel: userAuth.AuthTrustLevel.ATL3//认证信任等级。
    };
    widgetParam: userAuth.WidgetParam = {
            title: '请进行身份认证'
    };
    
    build() {
        Row({space:20}){
            Column({space:15}){
                UserAuthIcon({
                    authParam: this.authParamzhiwen,//前面配置的
                    widgetParam: this.widgetParam,
                    iconHeight: 70,//图标高度，可自定义
                    iconColor: Color.Blue,//图标颜色，可自定义
                    onIconClick: () => {
                    console.info('The user clicked the icon.');
                        },  // 需要调用UserAuthInstance的start()接口，启动认证后，才能通过onResult获取到认证结果。
                    onAuthResult: (result: userAuth.UserAuthResult) => {
                    console.info('Get user auth result, result = ' + JSON.stringify(result));
                     }
                })
                 }
                }
            }
        }
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.

发起认证

1.申请权限：ohos.permission.ACCESS_BIOMETRIC。

2.指定用户认证相关参数AuthParam（包括挑战值、认证类型UserAuthType列表和认证等级AuthTrustLevel）、配置认证控件界面WidgetParam，调用getUserAuthInstance获取认证对象。

3.调用UserAuthInstance.on接口订阅认证结果。

4.调用UserAuthInstance.start接口发起认证，通过IAuthCallback回调返回认证结果UserAuthResult。

当认证成功时返回认证通过类型（UserAuthType）和令牌信息（AuthToken）。

        import { BusinessError } from '@kit.BasicServicesKit';
        import { userAuth } from '@kit.UserAuthenticationKit';
        
        // 设置认证参数
        const authParam: userAuth.AuthParam = {
            challenge: new Uint8Array([49, 49, 49, 49, 49, 49]),
            authType: [userAuth.UserAuthType.PIN, userAuth.UserAuthType.FACE],
            authTrustLevel: userAuth.AuthTrustLevel.ATL3,
        };
        // 配置认证界面
        const widgetParam: userAuth.WidgetParam = {
            title: '请进行身份认证',
        };
        try {
        // 获取认证对象
        let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam);
        console.info('get userAuth instance success');
        // 订阅认证结果
        userAuthInstance.on('result', {
            onResult(result) {
                console.info(`userAuthInstance callback result: ${JSON.stringify(result)}`);
        // 可在认证结束或其他业务需要场景，取消订阅认证结果
        userAuthInstance.off('result');
        }
        });
        console.info('auth on success');
        userAuthInstance.start();
        console.info('auth start success');
        } catch (error) {
            const err: BusinessError = error as BusinessError;
            console.error(`auth catch error. Code is ${err?.code}, message is ${err?.message}`);
        }
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.

认证过程中取消认证

1.申请权限：ohos.permission.ACCESS_BIOMETRIC。

2.指定用户认证相关参数AuthParam（包括挑战值、认证类型UserAuthType列表和认证等级AuthTrustLevel），获取认证对象UserAuthInstance，并调用UserAuthInstance.start发起认证。

3.通过使用已经成功发起认证的UserAuthInstance对象调用UserAuthInstance.cancel接口取消本次认证。

        import { BusinessError } from  '@kit.BasicServicesKit';
        import { userAuth } from '@kit.UserAuthenticationKit';
        
        const authParam: userAuth.AuthParam = {
            challenge: new Uint8Array([49, 49, 49, 49, 49, 49]),
            authType: [userAuth.UserAuthType.PIN, userAuth.UserAuthType.FACE],
            authTrustLevel: userAuth.AuthTrustLevel.ATL3,
        };
        const widgetParam: userAuth.WidgetParam = {
            title: '请进行身份认证',
        };
        try {
        // 获取认证对象
        let userAuthInstance = userAuth.getUserAuthInstance(authParam, widgetParam);
        console.log('get userAuth instance success');
        // 开始认证
        userAuthInstance.start();
        console.log('auth start success');
        // 取消认证
        userAuthInstance.cancel();
        console.log('auth cancel success');
        } catch (error) {
        const err: BusinessError = error as BusinessError;
        console.error(`auth catch error. Code is ${err?.code}, message is ${err?.message}`);
        }
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.

指纹识别开发整体代码

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

        @Entry
        @Component
        struct FingerLoginPage {
        @State isOn:boolean = false
        build() {
            Column() {
                Row(){
                 Text(`指纹登录-${this.isOn?'开启':'未开启'}`)
                 Toggle({ type: ToggleType.Switch, isOn: this.isOn })
                 .selectedColor('#007DFF')
                 .switchPointColor('#FFFFFF')
                 .onChange((isOn: boolean) => {
                    let that = this
                    this.isOn = isOn
                    if(isOn){
                        if(canIUse('SystemCapability.UserIAM.UserAuth.Core')){
                        console.error('设备支持指纹')
                        /**
                        * 获取认证对象
                        */
                        let challenge = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]);
                        let authType = userIAM.userAuth.UserAuthType.FACE;
                        let authTrustLevel = userIAM.AuthTrustLevel.ATL1;
                        let authParam: userIAM.AuthParam = {
                            challenge: challenge,
                            authType: [authType],
                            authTrustLevel: authTrustLevel,
                        };
                        let widgetParam:userIAM.WidgetParam = {
                            title:'请验证指纹'
                        }
                        let auth:userIAM.UserAuthInstance
                        try {
                            auth = userIAM.getUserAuthInstance(authParam,widgetParam)
                            console.error("获取认证对象成功");
                            /**
                              * 订阅认证结果
                              */
                              try {
                              auth.on('result',{
                              onResult(result){
                                console.error('订阅认证结果result = ' + JSON.stringify(result));
                                let resultNum:number = result.result
                                if(resultNum === 12500000){// 认证成功
                                    console.error("指纹认证成功");
                                    that.isOn = true
                                    }
                                else if(resultNum === 12500001){// 认证失败
                                    console.error("指纹认证失败");
                                    that.isOn = false
                                    }
                                else if(resultNum === 12500003){// 认证取消
                                    console.error("指纹认证取消");
                                    that.isOn = false
                                    }
                              else if(resultNum === 12500010){// 用户未录入指纹
                                    console.error("用户未录入指纹");
                                    that.isOn = false
                                    }else{
                                    that.isOn = false
                                    console.error('认证错误')
                                    }
                              // 取消订阅认证结果
                              try {
                                    auth.off("result");
                                    console.error("取消订阅认证结果成功");
                              } catch (error) {
                                    that.isOn = false
                                    console.error("取消订阅认证结果失败, error = " + error);
                                     }
                                    }
                                });
                              console.error("订阅认证结果成功");
                                  /**
                                  * 开始认证
                                  */
                              try {
                                  auth.start();
                                  console.error("开始认证");
                              } catch (error) {
                                  console.error("开始认证失败:" + error);
                                  that.isOn = false
                                }
                              } catch (error) {
                                  that.isOn = false
                                  console.error("订阅认证结果失败 " + error);
                              }
                                  } catch (error) {
                                    that.isOn = false
                                    promptAction.showToast({
                                      message: '获取认证对象失败',
                                      duration: 1500
                                    });
                                    console.error("获取认证对象失败--" + error);
                                  }
                                }else{
                                  that.isOn = false
                                  promptAction.showToast({
                                    message: '设备不支持指纹识别。。。',
                                    duration: 1500
                                  });
                                }
                              }
                            })
                        }
                        .width('100%')
                        .height(50)
                        .margin({top:100})
                        .justifyContent(FlexAlign.SpaceBetween)
                      }
                      .width('100%')
                      .height('100%')
                      .padding(10)
                    }
                     }
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.
97.
98.
99.
100.
101.
102.
103.
104.
105.
106.
107.
108.
109.
110.
111.
112.
113.
114.
115.
116.
117.
118.

总结

经过一番努力，你现在已经是面部识别界的“武林高手”了！你不仅学会了如何让应用认出你的“盛世美颜”，还知道了如何优雅地处理那些想“蒙混过关”的脸庞。

想象一下，下次当你的朋友们惊讶地看着你的应用通过面部识别解锁时，你就可以自豪地说：“看，这就是我的‘刷脸’技术！”（别忘了提醒他们，这可不是普通的刷脸，而是高科技版的哦！）

好了，各位未来的“面部认证大师”，是时候展现你们真正的技术了！拿起你的键盘，开始你的表演吧！