# @devmaxime/capacitor-health-connect 中文文档规范地址：https://npmcn.com/package/%40devmaxime/capacitor-health-connect/ 版本：1\.1\.0 npm 元数据更新时间：2025-10-26T16:32:18.809Z 中文译文更新时间：2026-11-12T03:37:44.246Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。原始 npm 页面：https://www.npmjs.com/package/%40devmaxime/capacitor-health-connect 原文对照：https://npmcn.com/package/%40devmaxime/capacitor-health-connect/?lang=original 项目主页：https://github.com/devmaxime/capacitor-health-connect#readme 源码仓库：https://github.com/devmaxime/capacitor-health-connect ## 关键信息（来自 npm 元数据） - 包体积（解压后）：87.4 kB，22 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：0 个 - peer 依赖：@capacitor/core \>=7\.0\.0 - 首次发布：2025-09-26T19:14:47.147Z - 最新版本发布：2025-10-26T16:32:18.606Z - 近 30 天下载量：4311（2026-10-12 至 2026-11-10，npm 官方下载统计） - 已发布版本数：4（近 12 个月 0 个） ## 中文简介与健康连接交互的电容插件Name ## 安装 ```sh npm install @devmaxime/capacitor-health-connect ``` 也可以使用：`pnpm add @devmaxime/capacitor-health-connect`、`yarn add @devmaxime/capacitor-health-connect`、`bun add @devmaxime/capacitor-health-connect` ## README 与Android Health Connect互动的电容插件. ## 安装 ```bash npm install @devmaxime/capacitor-health-connect npx cap sync ``` 在您的应用程序中添加以下内容 `AndroidManifest.xml`数字 : ```xml ``` 把这个加进你的 `AndroidManifest.xml`数字 : ```xml ... ...

... ``` ### 权限您还需要在 AndroidManifest.xml 上添加您想要读取和/或写入的记录的权限。可以找到一份完整的可用记录和相应的权限清单 [这里](https://developer.android.com/health-and-fitness/guides/health-connect/plan/data-types#permissions)。。。 . ```xml

``` ## API 密码 - [`checkAvailability()`](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-checkavailability) - [`requestPermissions(...)`](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-requestpermissions) - [`getGrantedPermissions()`](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-getgrantedpermissions) - [`revokePermissions()`](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-revokepermissions) - [`readRecords(...)`](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-readrecords) - [`aggregateRecords(...)`](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-aggregaterecords) - [接口](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-interfaces) - [类型异名](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-type-aliases) ### 检查可用性( ) ```typescript checkAvailability() => Promise<{ availability: HealthConnectAvailability; }> ``` **回返情况:** `Promise<{ availability: [HealthConnectAvailability](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-healthconnectavailability); }>` * * * ### 请求(...) ```typescript requestPermissions(options: { read: RecordType[]; write: RecordType[]; }) => Promise ``` | 参数 | 类型 | | --- | --- | | **`options`** | `{ read: RecordType[]; write: RecordType[]; }` | **回返情况:** `Promise<[PermissionsResponse](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-permissionsresponse)>` * * * ### 获得授权的许可( C) ```typescript getGrantedPermissions() => Promise ``` **回返情况:** `Promise<[PermissionsResponse](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-permissionsresponse)>` * * * ### 撤销( ) ```typescript revokePermissions() => Promise ``` * * * ### 读取记录(...) ```typescript readRecords(options: { start: string; end: string; type: RecordType; pageSize?: number; pageToken?: string; }) => Promise ``` 在一个时间范围内读取指定类型的记录. 未提供页面时, 将使用自动页码检索所有记录在指定的时间范围内。大型数据集可能需要更长的时间,但要确保完全数据检索. 在提供页面时,使用手动页码,只使用一个单页结果与下一个PageToken一起返回,以检索随后的页面. | 参数 | 类型 | | --- | --- | | **`options`** | `{ start: string; end: string; type: [RecordType](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-recordtype); pageSize?: number; pageToken?: string; }` | **回返情况:** `Promise<[ReadRecordsResponse](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-readrecordsresponse)>` * * * ### 汇总记录(...) ```typescript aggregateRecords(options: { start: string; end: string; type: AggregateRecordType; groupBy?: AggregateGroupBy; }) => Promise ``` 在一个时间范围内汇总指定类型的记录. 返回按规定时间段分组的汇总数据(例如每日总数). | 参数 | 类型 | | --- | --- | | **`options`** | `{ start: string; end: string; type: [AggregateRecordType](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-aggregaterecordtype); groupBy?: [AggregateGroupBy](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-aggregategroupby); }` | **回返情况:** `Promise<[AggregateResponse](https://npmcn.com/package/%40devmaxime/capacitor-health-connect/#readme-aggregateresponse)>` * * * ### 接口 #### 权限响应 | Prop | 类型 | | --- | --- | | **`read`** | `RecordType[]` | | **`write`** | `RecordType[]` | #### 读取记录回复阅读健康记录后的反应. 当使用自动页标( 未提供页面Token) 时, 所有记录都会返回下一个PageToken将被取消定义. 当使用手动 pagination (pageToken 提供) 时, 下一个 PageToken 将包含下页的符号,如果这是最后一页,则未定义. | Prop | 类型 | | --- | --- | | **`records`** | `any[]` | | **`nextPageToken`** | `string` | #### 总体反应健康记录汇总的答复. 载有按时间段分类的汇总数据. | Prop | 类型 | | --- | --- | | **`aggregates`** | `AggregateData[]` | #### 汇总数据特定时期的汇总数据. | Prop | 类型 | | --- | --- | | **`startTime`** | `string` | | **`endTime`** | `string` | | **`value`** | `number` | | **`unit`** | `string` | ### 类型异名 #### 健康连通性 `'Available' | 'NotSupported' | 'NotInstalled'` #### 记录类型 `'Steps' | 'Weight' | 'ActivitySession' | 'SleepSession' | 'RestingHeartRate'` #### 总计记录 `'Steps' | 'Distance' | 'TotalCaloriesBurned' | 'ActiveCaloriesBurned' | 'HeartRate'` #### 组合By `'day' | 'hour' | 'week' | 'month'` ## Android Health Connect TODO中的现有记录:将此添加到文档中. ActiveCalories Burned - > Class androidx.health.connect.client.records. ActiveCalories Burned Records (英语). ActiveCalories Burned Record (英语) 活动会话 - > 类与roidx.health.connect.client.records. 练习会话记录 BasalBodyTemperature - > 类与roidx.health.connect.client.records.BasalBodyTemperature 互联网档案馆的存檔,存档日期2013-12-02 BasalMetabolicRate - > 类与roidx.health.connect.client.records.BasalMetabolicRate Records 血葡萄糖 - > 类和roidx.health.connect.client.records. Blood 葡萄糖记录血压 - > 类和roidx.health.connect.client.records. BloodPressure Records BodyFat - > 类和roidx.health.connect.client.records.BodyFat Record (英语) BodyTemperature - > 类与roidx.health.connect.client.records.BodyTemperature Records (英语) BodyWaterMass - > Class androidx.health.connect.client.records.BodyWaterMass Record (英语) BoneMass - > Class androidx.health.connect.client.records.BoneMass Record 互联网档案馆的存檔,存档日期2014-12-02 子宫颈穆克斯 - > 类与roidx.health.connect.client.records. Cervical穆克斯记录 CyclingPedalingCadenceSeries - > 类与roidx.health.connect.client.client.records. CyclingPedalingCadence Record (英语) 距离 - > 类和roidx.health.connect.client.records. 远程记录 ElevationGained - > 类和roidx.health.connect.client.records.elevationGained Records FloorsClimbed - > Class androidx.health.connect.client.records.floorsClimbed Records (英语) HeartRateSeries - > 类和roidx.health.connect.client.client.records. 心脏记录 HeartRateVariabilityRmsd - > Class androidx.health.connect.client.client.records. HeartRateVariabilityRmsd Record (中文(中国大陆) ) 高度 - > 类和roidx.health.connect.client.records.Height Records 水分 - > 类和roidx.health.connect.client.records. 水分记录 LeanBodyMass - > Class androidx.health.connect.client.records. LeanBodyMass Record 互联网档案馆的存檔,存档日期2013-12-22 月经 - > 类与roidx.health.connect.client.records.Menstruation FlowRecord 互联网档案馆的存檔,存档日期2013-12-21 月经Period - > 类与roidx.health.connect.client.records.MenstruationPeriod Records 营养 - > 类与roidx.health.connect.client.records. 营养记录排出测试 - > Class androidx.health.connect.client.records.Ovulate Testrecord 互联网档案馆的存檔,存档日期2013-12-22 氧饱和 - > 类和roidx.health.connect.client.records.oxygen饱和记录 PowerSeries - > 类和roidx.health.connect.client.records. 权力记录呼吸道 - > 类与roidx.health.connect.client.records. 呼吸道记录恢复心电图 - > Class androidx.health.connect.client.records.Resting HeartRate Record 互联网档案馆的存檔,存档日期2013-12-21 性活性 - > 类和roidx.health.connect.client.records. Sexual Activity Records SkinTemperature - > Class androidx.health.connect.client.records. SkinTemperature Records (英语). SkinTemperature Record (英语) 睡眠会话 - > 类和roidx.health.connect.client.records. sleeps.records. 睡眠会话记录速度串 - > 类和roidx.health.connect.client.records.peed Records Intermenstrual Bleeding - > Class androidx.health.connect.client.client.records. Intermenstrual Bleeding Record 互联网档案馆的存檔,存档日期2013-12-02 Steps - > Class androidx.health.connect.client.records.Steps 记录系统存档副本步骤CadenceSeries - > 类和roidx.health.connect.client.records.StepsCadence Records TotalCalories Burned - > Class androidx.health.connect.client.records. TotalCalories Burned Records (中文(中国大陆) ) Vo2Max - > 类和roidx.health.connect.client.records.Vo2Max记录轮椅 Pushes - > 类与roidx.health.connect.client.records.Wheelfair Pushes Record (英语) 重量 - > 类和roidx.health.connect.client.records.weight Records 最初从 [@sprintwerk/ 电容- 机器人- 健康连接](https://github.com/sprintwerk/capacitor-android-health-connect) ## 常见问题 ### @devmaxime/capacitor-health-connect 是什么？与健康连接交互的电容插件Name ### 如何安装 @devmaxime/capacitor-health-connect？在项目目录运行 npm install @devmaxime/capacitor-health-connect，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=7\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @devmaxime/capacitor-health-connect 支持 TypeScript 吗？支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @devmaxime/capacitor-health-connect 支持 ESM 还是 CommonJS？同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @devmaxime/capacitor-health-connect 可以商用吗？ @devmaxime/capacitor-health-connect 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @devmaxime/capacitor-health-connect 的下载量有多少？根据 npm 官方下载统计，@devmaxime/capacitor-health-connect 在 2026/10/12 – 2026/11/10 这 30 天内被下载 4,311 次，日均约 144 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @devmaxime/capacitor-health-connect 还在维护吗？最新版本 1\.1\.0 发布于 2025/10/27（1 年前）；至今共发布 4 个版本，其中过去 12 个月发布了 0 个；首次发布于 2025/09/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。