一、Health Service Kit简介
Health Service Kit(运动健康服务)是为华为生态应用打造的基于华为账号和用户授权的运动健康数据开放平台。在获取用户授权后,开发者可以使用 Health Service Kit 提供的开放能力获取运动健康数据,基于多种类型数据构建运动健康领域应用与服务,为用户打造丰富、便捷、专业的运动健康场景体验。
(一)业务介绍
(二)应用服务
优质应用服务联合三方设备,结合 Health Service Kit 提供的运动健康数据服务,共同打造“智能运动健康设备+华为终端+应用服务”生态,为用户带来安全、智慧、便捷的运动健康体验。
服务包含华为应用及生态应用:
华为应用:华为运动健康 App 为您提供专业的运动记录与减脂塑形等训练课程,结合科学睡眠及健康服务,让您跑得更快更远,变得更健康。
生态应用:运动&健身、医疗研究、保险等生态应用基于华为智能运动健康设备+华为运动健康数据平台,更易构建专业的场景化用户体验。
(三)运动健康服务
如上图所示,华为运动健康开放平台提供了多种形式的开放能力,支持应用生态开放能力和设备接入开放能力。提供丰富的运动健康类的API,支持多种运动类型和健康数据的数据开放,如步数、心率等。
数据开放:作为运动健康数据平台,支持丰富的健康数据类型和专业运动数据类型。
服务开放:运动联动服务开放能力支持穿戴设备和生态设备的运动联动与实时数据回传。功能待后续支持,敬请期待。
模型开放:在基础运动健康数据之上,进行最大摄氧量、训练负荷等数据分析的模型开放能力。功能待后续支持,敬请期待。
数据平台:提供数据平台,助力开发者存储运动和健康类的数据。
数据安全隐私合规:遵从适用的法律法规,对隐私进行管理。参考 GAPP 等业界优秀实践,进行个人数据全生命周期管理。
(四)约束与限制
支持的设备:本 Kit 仅适用于 Phone、Tablet、Wearable、Lite Wearable 。
支持的国家/地区:仅支持中国境内(中国香港特别行政区、中国澳门特别行政区、中国台湾除外)。
(五)模拟器支持情况
从 6.0.2(22) 版本开始,本 Kit 支持模拟器开发,但与真机存在部分能力差异,具体差异如下。
通用差异:请参见“模拟器与真机的差异”。
??模拟器与真机的差异(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-specification
不支持 Wearable 应用开发。
不支持运动健康联动服务、实时三环数据、手动同步数据,以及运动健康 App 相关能力。
默认开启隐私授权。
二、接入流程
??接入流程:(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-application-access
说明
开发者可实名认证为个人开发者或者企业开发者,认证前,请先了解二者的权益区别。
??权益区别(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/start/dbiae-0000001336403980
提交运动健康服务测试权限申请前,请先查阅开发者申请资质说明和申请被驳回的常见问题。
??开发者申请资质说明(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-application-qualifications
??申请被驳回的常见问题(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-apply# 申请被驳回的常见问题
运动健康服务测试阶段有 100 位用户数量的限制,申请验证并通过后将解除该限制。
开发者等级(是否为优质/重点/战略合作伙伴)将根据实际项目合作情况而定。
三、应用开发者申请资质说明
(一)个人开发者接入资质审核要求
个人开发者应用需上架至华为应用市场。个人开发者应用未上架华为应用市场,暂不开放 Health Service Kit 数据。
申请访问开放等级为基础的用户数据,个人开发者不得有个人信用不良记录。开放等级为高阶的用户数据暂不向个人开发者开放。数据开放等级请参见数据开放总览。
??数据开放总览(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-data-overview
(二)企业、事业单位/政府机构、社会团体开发者接入资质审核要求
企业申请资质要求:企业以实缴注册资本为准,申请访问开放等级为基础的用户数据,企业实缴注册资本不低于 50 万元;申请访问开放等级为高阶的用户数据,企业实缴注册资本不低于 500 万元。申请主体存续且成立时间需 1 年以上;
事业单位/政府机构申请资质要求:如果申请主体为事业单位或政府机构,可免除资金和成立年限要求。事业单位或政府机构委托的企业,需遵循企业申请资质要求。
社会团体申请资质要求:社会团体以活动资金(注册资本)为准,申请访问开放等级为基础的用户数据,活动资金不低于 50 万元;申请访问开放等级为高阶的用户数据,活动资金不低于 500 万元。申请主体存续且成立时间需 1 年以上。
说明
以上企业实缴注册资本数据以国家企业信用信息公示系统中最新年报数据为准。
??国家企业信用信息公示系统(可复制链接至网页跳转)
https://shiming.gsxt.gov.cn/socialuser-use-rllogin.html
若企业实缴注册资本与社会团体活动资金不符合要求,请参见对应解决方案。
??解决方案(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-apply#企业事业单位政府机构社会团体实缴注册资本不符合审核要求
数据开放等级请参见数据开放总览。
??数据开放总览(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-data-overview
(三)申请材料准备
为保障用户隐私和数据安全,运动健康服务需要开发者提交相关材料和信息,以确保应用向用户请求数据权限是合理的。请根据提交应用信息页面中的开发者申请材料清单样例,准备并准确填写相应内容。
说明
请在提交材料前先阅读申请被驳回的常见问题,以避免在您的申请材料中出现同类问题。
??申请被驳回的常见问题(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-apply# 申请被驳回的常见问题
若您的应用需要申请应用转移,运动健康服务需要对转入方开发者资质进行审核,确保新的应用主体符合资质要求。请将上述申请资料清单以及您的应用 ID 、应用名称、应用转入开发者 ID 、更新后的应用隐私政策发送到 hihealth@huawei.com 邮箱,相关资质评审通过后,方可进行应用转移。
??应用转移(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/app/agc-help-maintain-transfer-0000002236494390
四、开发接入
数据开放总览
开发准备
Phone/Tablet 应用开发
Wearable 应用开发
LiteWearable 应用开发
数据类型
申请验证获取正式权限
个人数据处理说明
ArkTS API
healthStore (运动健康数据服务)
healthService (运动健康联动服务)
healthStore (运动健康数据服务)(Lite)
healthService (运动健康联动服务)(Lite)
运动健康数据类型常量及模型定义
??可跳转至链接了解详细信息(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-harmonyos
五、Health Service Kit 常见问题
(一)读取今天的日常活动数据统计,与运动健康 App 页面数据不一致
聚合查询接口读取今日日常活动数据,数据上报存在延时,读取实时日常活动数据建议使用读取实时三环数据接口。
??聚合查询(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-samplepoint-manage#聚合查询
??读取实时三环数据(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-three-ring-read
(二)授权后仍然没有数据类型权限
鉴权时使用的权限是用户授权的权限与应用申请的权限的交集,需确认:
1. 应用已申请了对应的数据类型权限,申请步骤请参考申请运动健康服务,数据类型对应的权限参考权限说明。
??申请运动健康服务(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-apply
??权限说明(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-permission-description
2. 用户授权已勾选对应的权限。
(三)在授权时上报 1001502003 错误
参考配置 Client ID ,请登录 AppGallery Connect 平台,确认代码中配置的包名与 client ID 是匹配的。若问题仍未解决,请通过在线提单提交问题,华为支持人员会及时处理。
??配置 Client ID (可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-configuration-client-id
??AppGallery Connect(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/service/josp/agc/index.html
??在线提单(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/support/feedback/#/
更多错误码请参考 ArkTS API 错误码。
??ArkTS API 错误码(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-healthservice
(四)在授权时上报 1001502014 错误
确保授权请求参数中的数据类型已经在 Health Service Kit 卡片中申请相应的权限,申请步骤请参考申请运动健康服务,数据类型对应的权限参考权限说明。
??申请运动健康服务(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-apply
??权限说明(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/health-permission-description
更多错误码请参考 ArkTS API 错误码。
??ArkTS API 错误码(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-healthservice
(五)用户隐私未同意,如何引导用户打开运动健康 App
接口响应错误码 1002703001 ,可通过以下方式引导用户打开运动健康 App ,同意隐私授权:
调用 canOpenLink 判断运动健康 App 是否安装。运动健康 App Scheme :huaweischeme://healthapp/home/main。
App 已安装,调用 openLink 接口拉起运动健康 App 。运动健康 App Scheme :huaweischeme://healthapp/home/main。
App 未安装,调用应用市场推荐接口,引导用户下载运动健康 App ,运动健康 App 包名:com.huawei.hmos.health。
??canOpenLink(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundlemanagercanopenlink12
??openLink(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-uiabilitycontext#openlink12
??应用市场推荐(可复制链接至网页跳转)
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/appgallery-productview-loadproduct
*广告往期回顾 | HarmonyOSHarmonyOS 穿戴设备应用开发入门关注公众号,获取更多 HarmonyOS 技术内容
点击,了解更多Health Service Kit的信息吧!
股票
板块
用户
资讯
评论 (0)