输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
指南
指南应用服务Health Service Kit（运动健康服务）开发接入Phone/Tablet应用开发管理运动健康数据运动健康采样数据

运动健康采样数据

更新时间: 2026-04-20 06:34
本文导读
展开章节

场景介绍

运动健康采样数据(SamplePoint)，表示在某时刻（或一段时间）采集到的特定数据类型的样本，由时间、样本值及采样的数据源组成，支持保存、读取和删除等操作。

接口说明

展开
接口名 描述
saveData(sampleData: SamplePoint[] | SamplePoint): Promise<void> 保存运动健康采样数据，入参为单个SamplePoint或SamplePoint数组。
readData<T extends SamplePoint>(request: SamplePointReadRequest): Promise<T[]> 查询运动健康采样数据，通过SamplePointReadRequest设置查询条件，可按数据类型，字段、时间范围等条件查询。
deleteData(samplePoint: SamplePoint | SamplePoint[]): Promise<void> 删除运动健康采样数据，按入参删除指定的采样数据，可传入单个SamplePoint或SamplePoint数组。
deleteData(request: SamplePointDeleteRequest | SamplePointDeleteRequest[]): Promise<void> 删除运动健康采样数据，按SamplePointDeleteRequest条件删除，可设置数据类型、时间范围、数据源等删除条件。
aggregateData<T extends AggregateResult>(request: AggregateRequest | AggregateRequest[]): Promise<T[]> 聚合查询运动健康采样数据，通过AggregateRequest设置查询的数据类型、聚合策略。
说明

aggregateData接口读取今日日常活动数据，数据上报存在延时，读取实时日常活动数据建议使用读取实时三环数据接口。

开发前检查

开发步骤

保存用户的运动健康数据

  1. 导入运动健康服务功能模块及相关公共模块。

    收起
    自动换行
    深色代码主题
    复制
    1. import { healthStore } from '@kit.HealthServiceKit';
    2. import { hilog } from '@kit.PerformanceAnalysisKit';

  2. 获取dataSourceId，参考管理数据源，插入一个新的数据源或读取已有数据源。

  3. 创建运动健康采样数据。

    收起
    自动换行
    深色代码主题
    复制
    1. let samplePoint: healthStore.samplePointHelper.bodyTemperature.Model = {
    2.   dataType: healthStore.samplePointHelper.bodyTemperature.DATA_TYPE,
    3.   startTime: 1698633801000,
    4.   endTime: 1698633801000,
    5.   localDate: '10/30/2023',
    6.   timeZone: '+0800',
    7.   modifiedTime: 1698633801000,
    8.   // insertDataSource插入数据源接口返回的dataSourceId，或读取已有数据源的dataSourceId
    9.   dataSourceId: 'xxx',
    10.   fields: {
    11.     bodyTemperature: 39
    12.   }
    13. }

  4. 调用saveData方法执行保存数据请求，并处理返回结果。

    收起
    自动换行
    深色代码主题
    复制
    1. try {
    2.   await healthStore.saveData(samplePoint);
    3.   hilog.info(0x0000, 'testTag', 'Succeeded in saving data.');
    4. } catch (err) {
    5.   hilog.error(0x0000, 'testTag', `Failed to save data. Code: ${err.code}, message: ${err.message}`);
    6. }

读取用户的运动健康数据

  1. 导入运动健康服务功能模块及相关公共模块。

    收起
    自动换行
    深色代码主题
    复制
    1. import { healthStore } from '@kit.HealthServiceKit';
    2. import { hilog } from '@kit.PerformanceAnalysisKit';

  2. 创建查询请求。

    收起
    自动换行
    深色代码主题
    复制
    1. let samplePointReadRequest: healthStore.SamplePointReadRequest = {
    2.   samplePointDataType: healthStore.samplePointHelper.bodyTemperature.DATA_TYPE,
    3.   startTime: 1698633801000,
    4.   endTime: 1698633801000,
    5.   fields: {
    6.     bodyTemperature: 39
    7.   }
    8. }

  3. 调用readData方法执行查询请求，并处理返回结果。

    收起
    自动换行
    深色代码主题
    复制
    1. try {
    2.   let samplePoints = await healthStore.readData(samplePointReadRequest);
    3.   samplePoints.forEach((samplePoint) => {
    4.     hilog.info(0x0000, 'testTag', `Succeeded in reading data, the bodyTemperature is ${samplePoint.fields.bodyTemperature}.`);
    5.   });
    6. } catch (err) {
    7.   hilog.error(0x0000, 'testTag', `Failed to read data. Code: ${err.code}, message: ${err.message}`);
    8. }

删除指定的运动健康采样数据

  1. 导入运动健康服务功能模块及相关公共模块。

    收起
    自动换行
    深色代码主题
    复制
    1. import { healthStore } from '@kit.HealthServiceKit';
    2. import { hilog } from '@kit.PerformanceAnalysisKit';

  2. 查询待删除的运动健康采样数据。

    收起
    自动换行
    深色代码主题
    复制
    1. let samplePointReadRequest: healthStore.SamplePointReadRequest = {
    2.   samplePointDataType: healthStore.samplePointHelper.bodyTemperature.DATA_TYPE,
    3.   startTime: 1698633801000,
    4.   endTime: 1698633801000
    5. }
    6. let samplePoints: healthStore.SamplePoint[] = await healthStore.readData(samplePointReadRequest);

  3. 调用deleteData方法执行删除请求，并处理返回结果。

    收起
    自动换行
    深色代码主题
    复制
    1. try {
    2.   for (let index = 0; index < samplePoints.length; index++) {
    3.     const samplePoint = samplePoints[index];
    4.     await healthStore.deleteData(samplePoint);
    5.   }
    6.   hilog.info(0x0000, 'testTag', 'Succeeded in deleting data.');
    7. } catch (err) {
    8.   hilog.error(0x0000, 'testTag', `Failed to delete data. Code: ${err.code}, message: ${err.message}`);
    9. }

根据请求删除用户运动健康数据

  1. 导入运动健康服务功能模块及相关公共模块。

    收起
    自动换行
    深色代码主题
    复制
    1. import { healthStore } from '@kit.HealthServiceKit';
    2. import { hilog } from '@kit.PerformanceAnalysisKit';

  2. 创建删除请求。

    收起
    自动换行
    深色代码主题
    复制
    1. let samplePointDeleteRequest: healthStore.SamplePointDeleteRequest = {
    2.   dataType: healthStore.samplePointHelper.bodyTemperature.DATA_TYPE,
    3.   startTime: 1698633801000,
    4.   endTime: 1698633801000
    5. }

  3. 调用deleteData方法执行删除请求，并处理返回结果。

    收起
    自动换行
    深色代码主题
    复制
    1. try {
    2.   await healthStore.deleteData(samplePointDeleteRequest);
    3.   hilog.info(0x0000, 'testTag', 'Succeeded in deleting data.');
    4. } catch (err) {
    5.   hilog.error(0x0000, 'testTag', `Failed to delete data. Code: ${err.code}, message: ${err.message}`);
    6. }

聚合查询

  1. 导入运动健康服务功能模块及相关公共模块。

    收起
    自动换行
    深色代码主题
    复制
    1. import { healthStore } from '@kit.HealthServiceKit';
    2. import { hilog } from '@kit.PerformanceAnalysisKit';

  2. 创建聚合查询请求。

    收起
    自动换行
    深色代码主题
    复制
    1. let aggregateRequest: healthStore.AggregateRequest<healthStore.samplePointHelper.dailyActivities.AggregateFields> = {
    2.   dataType: healthStore.samplePointHelper.dailyActivities.DATA_TYPE,
    3.   metrics: {
    4.     step: ['sum'],
    5.     calorie: ['sum'],
    6.     distance: ['sum'],
    7.     climbHighAltitude:['sum'],
    8.     isIntensity: ['sum'],
    9.     isStand: ['sum']
    10.  },
    11.   groupBy: {
    12.     unitType: healthStore.GroupUnitType.DAY
    13.   },
    14.   startLocalDate: '10/30/2023',
    15.   endLocalDate: '10/30/2023'
    16. }

  3. 调用aggregateData方法执行查询请求，并处理返回结果。

    收起
    自动换行
    深色代码主题
    复制
    1. try {
    2.   const aggregateResults = await healthStore.aggregateData<healthStore.samplePointHelper.dailyActivities.AggregateResult>(aggregateRequest);
    3.   hilog.info(0x0000, 'testTag', 'Succeeded in reading data.');
    4.   aggregateResults.forEach((aggregateResult) => {
    5.     hilog.info(0x0000, 'testTag', `the start time is ${aggregateResult.startTime}.`);
    6.     hilog.info(0x0000, 'testTag', `the end time is ${aggregateResult.endTime}.`);
    7.     Object.keys(aggregateResult.fields).forEach((fieldName) => {
    8.       hilog.info(0x0000, 'testTag', `the sum of ${fieldName} is ${aggregateResult.fields[fieldName].sum}.`);
    9.     });
    10.   });
    11. } catch (err) {
    12.   hilog.error(0x0000, 'testTag', `Failed to read data. Code: ${err.code}, message: ${err.message}`);
    13. }
管理运动健康数据
锻炼记录
相关推荐
文档读取运动健康采样数据
文档聚合查询运动健康采样数据
文档健康记录
文档锻炼记录
文档读取锻炼记录
文档读取健康记录
文档读取实时三环数据
文档管理数据源
文档实时三环数据
文档概要
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词