智能表数据获取

在部分智能表款型上，Health Service Kit支持直接获取智能表上的数据，支持的数据范围如下所示：

说明

目前支持WATCH 3/4系列智能表，且系统是HarmonyOS 3.0.0及以上版本。

数据分类

数据开放类型

开放说明

API接口

OAuth权限

原子采样数据-日常活动

步数

支持查询智能表当日的步数统计，不支持查询历史数据。

readTodaySummation

Scopes.HEALTHKIT_STEP_READ

距离

支持查询智能表当日的距离统计，不支持查询历史数据。

readTodaySummation

Scopes.HEALTHKIT_DISTANCE_READ

卡路里

支持查询智能表当日的卡路里统计，不支持查询历史数据。

readTodaySummation

Scopes.HEALTHKIT_CALORIES_READ

原子采样数据-健康采样

心率

若运动健康App健康监测开启连续测量心率，支持查询心率最新数据；若未开启，只支持查询手动测量的历史数据。

read/readLatest

Scopes.HEALTHKIT_HEARTRATE_READ

血氧

若运动健康App健康监测开启血氧自动检测，支持查询血氧最新数据和手动测量的历史数据；若未开启，只支持查询手动测量的历史数据。

read/readLatest

Scopes.HEALTHKIT_OXYGEN_SATURATION_READ

压力

若运动健康App健康监测开启压力自动检测，支持查询压力最新数据和历史数据。

read/readLatest

Scopes.HEALTHKIT_STRESS_READ

体温

支持查询单次测量的体温历史数据查询。

read

Scopes.HEALTHKIT_BODYTEMPERATURE_READ

皮肤体温

支持查询单次测量的皮肤体温历史数据查询。

read

Scopes.HEALTHKIT_BODYTEMPERATURE_READ

健康记录

睡眠记录

支持查询睡眠记录历史数据。

getHealthRecord

Scopes.HEALTHKIT_SLEEP_READ

运动记录

跑步机、室内骑行

支持查询智能表与生态设备联动产生的运动记录数据，目前支持跑步机和动感单车（室内骑行）。

getActivityRecord

Scopes.HEALTHKIT_ACTIVITY_RECORD_READ

说明

读取智能表上数据除了需要申请相应数据类型的权限外，还需申请智能表数据开放权限：HMSHealthKitScope.HEALTHKIT_HUAWEIHEALTH_LINK。

原子采样数据

日常活动

支持获取智能表上的日常活动数据：步数、距离、卡路里。当前只支持的查询当日的统计数据（当日0点到当前时间的总数），不支持查询历史统计数据。

若要查询距离、卡路里的当日统计数据，可将查询类型指定为：DT_CONTINUOUS_DISTANCE_DELTA，DT_CONTINUOUS_CALORIES_BURNT。

健康采样

支持在智能表上获取健康采样数据：心率、静息心率、血氧、压力、体温、皮肤体温。用户在运动健康APP健康监测开启状态不同，会影响接口调用结果。

图1 运动健康App健康监测开关

图2 智能表上手动测量血氧和体温

健康记录

支持在智能表上获取睡眠记录数据，数据字段仅支持：入睡时间（fall_asleep_time），出睡时间（wake_up_time），全部睡眠时长（all_sleep_time）；且不支持查询关联的睡眠状态采样数据。

健康记录查询接口请参考：查询健康记录，查询用户的睡眠记录示例代码如下：

运动记录

在智能表上，HealthKit只支持查询手表与南向生态设备联动产生的运动记录，目前支持的设备类型有跑步机和动感单车。

图3 智能表与南向生态设备连接

运动记录查询接口请参考：读取Health Service Kit的运动记录，查询南向的运动记录示例代码如下：