Health Connect API
Read and write Android Health Connect records from JavaScript — mirrors the WebViewGold HealthKit API on iOS so one web app covers both platforms.
Health Connect API 通过 Android Health Connect 读写健康记录。它镜像了 WebViewGold 的 iOS HealthKit 功能,因此您可以发布一款可在两个平台上访问健康数据的 Web 应用。读取操作始终返回请求的记录类型的今日总量。
读取记录:
<a href="readhealthkit://StepsRecord" onclick="setTimeout(show, 300)">
My steps today
</a>
<script>
function show() {
// Injected variable name matches the sanitized record name.
alert(StepsRecord); // e.g. "8421.0 steps"
}
</script>
写入记录:
格式:writehealthkit://<RecordName>//<value>
<a href="writehealthkit://StepsRecord//1000">Log 1000 steps</a>
成功时,应用会注入 <RecordName> = "WRITE_SUCCESS"。失败时,则注入错误文本。
支持的记录: 您的应用已申请权限的任何 Health Connect 记录类型。常见的有:
StepsRecordHeartRateRecordWeightRecordSleepSessionRecordHydrationRecordActiveCaloriesBurnedRecordDistanceRecord
设置:
- 在设备上安装 Health Connect(在 Android 14+ 上预装)。
- 首次使用时,应用会打开 Health Connect 权限对话框;用户会为请求的记录类型授予读取和/或写入权限。
- 如果不支持 Health Connect,则注入的值会回退为字符串
"Health Connect not supported"。
说明: 值以 "<number> <unit>" 形式返回(例如 "75.4 kg")。需要 Android 8.0(API 26)或更高版本。
SDK 风格的实现说明
将此功能视为向 Web 层公开的原生能力:将生产网站或 PWA 作为唯一可信来源,然后使用文档中的 WebViewGold 配置标志、URL 命令和 JavaScript 桥接调用,仅在能够带来价值的地方启用原生 Android 行为。这种方式让代码库易于维护,因为同一个 Web 应用只需极少的条件逻辑即可同时服务于浏览器、WebViewGold for Android 以及其他 WebViewGold 平台。
为获得可靠的结果,建议优先使用 HTTPS 端点、稳定的路由名称、在界面中明确的成功/错误状态,以及封装原生调用的小型 JavaScript 辅助函数。例如,使用 jQuery Mobile、Lovable、Base44、Bolt、WordPress、Bubble、自定义 React/Vue/Angular 技术栈或静态 HTML 构建的 Web 应用,可以提供单个按钮或事件处理程序来触发原生 WebViewGold API,同时仍为浏览器提供优雅的回退方案。
- 推荐的集成模式:检测应用上下文,调用 WebViewGold API,然后在原生回调或路由变更后更新 Web 界面。
- 测试清单:在真机或打包构建上验证该功能,检查权限和商店审核文案,并确认仅使用浏览器的用户仍能获得有用的回退方案。
- SEO 优势:让功能页面、路由标题和结构化内容在您的网站上保持可被索引,同时由 WebViewGold 为 Android 用户提供原生应用外壳。