实时三环数据
======

#### 场景介绍

实时三环数据，包括实时步数，活动热量，锻炼时长，活动小时数以及目标类数据。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8/v3/Q5gqKiugR_mYoAOh0bi0dQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132622Z&HW-CC-Expire=86400&HW-CC-Sign=18C9A88A036A985CE1530DB005679581822B97477EE5D8CDECEC874057731818)

此接口使用日常活动数据类型读权限，参考[权限说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-permission-description)。

#### 约束与限制

从5.1.1(19) Release版本开始支持。

#### OAuth权限

联盟卡片申请的权限名称：日常活动 > 日常活动数据（读）

#### 接口说明

| 接口名 | 描述 |
| :-- | :-- |
| [readActivityReport](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/health-api-healthservice#workoutreadactivityreport)(): Promise<[ActivityReport](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/health-api-healthservice#activityreport)\> | 读取实时三环数据。 |

#### 开发前检查

*   完成[申请运动健康服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-apply)与[配置Client ID](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-configuration-client-id)。
    
*   接口首次调用前，需先使用[init](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/health-api-healthstore#healthstoreinit)方法进行初始化。
    
*   需先通过[用户授权](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-add-permissions#用户授权)接口引导用户授权，用户授权日常活动数据类型读权限（参考[权限说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-permission-description)）后，才有权限读取实时三环数据。
    
*   错误码请参考[ArkTS API错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-healthservice)，常见问题请参考[Health Service Kit常见问题](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-faqs)。
    

#### 开发步骤

1.  导入运动健康服务功能模块及相关公共模块。
    
    import { healthService } from '@kit.HealthServiceKit';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    
2.  调用[readActivityReport](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/health-api-healthservice#workoutreadactivityreport)方法读取实时三环数据，并处理返回结果。
    
    try {
      const result: healthService.workout.ActivityReport = await healthService.workout.readActivityReport();
      
      hilog.info(0x0000, 'testTag', 'Succeeded in reading ActivityReport');
      Object.keys(result).forEach(key => {
        hilog.info(0x0000, 'testTag', \`the ${key} is ${result\[key\]}\`);
      });
    } catch (err) {
      hilog.error(0x0000, 'testTag', \`Failed to read ActivityReport. Code: ${err.code}, message: ${err.message}\`);
    }