用户状态感知开发指导

UserStatus（用户状态感知）模块提供用户感知能力，可以感知到操作者特定状态，例如：检测用户年龄组。

详细的接口介绍请参考@ohos.multimodalAwareness.userStatus (用户状态感知)。

说明：

本模块首批接口从API version 20开始支持，从API version 24废弃。

感知用户年龄组开发指导

场景介绍

当应用需要获取用户年龄分类时，可以调用userStatus模块，例如判断设备具体操作者是儿童还是成年人。

从API version 20开始，支持获取用户年龄组。

接口说明

接口名	描述
on(type:'userAgeGroupDetected',callback:Callback<UserClassification>):void;	订阅年龄群组检测功能，检测结果通过callback返回。
off(type: 'userAgeGroupDetected', callback?: Callback<UserClassification>): void;	取消年龄群组检测功能。

约束与限制

• 此功能如果设备不支持，将返回801错误码。

开发步骤

1. 导入模块。

   import { userStatus } from '@kit.MultimodalAwarenessKit';
   import { BusinessError } from '@kit.BasicServicesKit';
   

   Index.ets

2. 定义回调函数，监听年龄群组检测结果变化。

   let callback : Callback<userStatus.UserClassification> = (data : userStatus.UserClassification) => {
     console.info('callback succeeded, ageGroup:' + data.ageGroup + ", confidence:" + data.confidence);
   };
   

   Index.ets

3. 订阅年龄群组检测功能。

   try {
      userStatus.on('userAgeGroupDetected', callback);  
      console.info("on succeeded");
   } catch (err) {
      let error = err as BusinessError;
      console.error("Failed on and err code is " + error.code);
   }
   

   Index.ets

4. 取消订阅年龄群组检测功能。

   try {
      userStatus.off('userAgeGroupDetected');
      console.info("off succeeded");
   } catch (err) {
      let error = err as BusinessError;
      console.error("Failed off and err code is " + error.code);
   }
   

   Index.ets