@devmaxime/capacitor-health-connect

中文文档
1.1.0发布于 2025/10/27MITTypeScriptESM + CJS零依赖近 30 天下载 4311

与健康连接交互的电容插件Name

中文使用文档
文档目录12 节
  1. 安装
  2. 权限
  3. API 密码
  4. 检查可用性( )
  5. 请求(...)
  6. 获得授权的许可( C)
  7. 撤销( )
  8. 读取记录(...)
  9. 汇总记录(...)
  10. 接口
  11. 类型异名
  12. Android Health Connect TODO中的现有记录:将此添加到文档中.

与Android Health Connect互动的电容插件.

安装

npm install @devmaxime/capacitor-health-connect
npx cap sync

在您的应用程序中添加以下内容 AndroidManifest.xml数字 :

<queries>
   <package android:name="com.google.android.apps.healthdata" />
</queries>

把这个加进你的 AndroidManifest.xml数字 :

<application>
...
    <activity>
    ...

        <!-- Permission handling for Android 13 and before -->
        <intent-filter>
            <action android:name="androidx.health.ACTION_SHOW_PERMISSIONS_RATIONALE" />
        </intent-filter>

        <!-- Permission handling for Android 14 and later -->
        <intent-filter>
            <action android:name="android.intent.action.VIEW_PERMISSION_USAGE"/>
            <category android:name="android.intent.category.HEALTH_PERMISSIONS"/>
        </intent-filter>

    ...
    </activity>
</application>

权限

您还需要在 AndroidManifest.xml 上添加您想要读取和/或写入的记录的权限 。 可以找到一份完整的可用记录和相应的权限清单 这里。 。 。 .

<!-- Example permissions -->
<uses-permission android:name="android.permission.health.READ_STEPS"/>
<uses-permission android:name="android.permission.health.WRITE_STEPS"/>
<uses-permission android:name="android.permission.health.READ_EXERCISE"/>
<uses-permission android:name="android.permission.health.WRITE_EXERCISE"/>

API 密码

检查可用性( )

checkAvailability() => Promise<{ availability: HealthConnectAvailability; }>

回返情况: Promise<{ availability: HealthConnectAvailability; }>


请求(...)

requestPermissions(options: { read: RecordType[]; write: RecordType[]; }) => Promise<PermissionsResponse>
参数类型
options{ read: RecordType[]; write: RecordType[]; }

回返情况: Promise<PermissionsResponse>


获得授权的许可( C)

getGrantedPermissions() => Promise<PermissionsResponse>

回返情况: Promise<PermissionsResponse>


撤销( )

revokePermissions() => Promise<void>

读取记录(...)

readRecords(options: { start: string; end: string; type: RecordType; pageSize?: number; pageToken?: string; }) => Promise<ReadRecordsResponse>

在一个时间范围内读取指定类型的记录.

未提供页面时, 将使用自动页码检索所有记录 在指定的时间范围内。 大型数据集可能需要更长的时间,但要确保 完全数据检索.

在提供页面时,使用手动页码,只使用一个单页 结果与下一个PageToken一起返回,以检索随后的页面.

参数类型
options{ start: string; end: string; type: RecordType; pageSize?: number; pageToken?: string; }

回返情况: Promise<ReadRecordsResponse>


汇总记录(...)

aggregateRecords(options: { start: string; end: string; type: AggregateRecordType; groupBy?: AggregateGroupBy; }) => Promise<AggregateResponse>

在一个时间范围内汇总指定类型的记录. 返回按规定时间段分组的汇总数据(例如每日总数).

参数类型
options{ start: string; end: string; type: AggregateRecordType; groupBy?: AggregateGroupBy; }

回返情况: Promise<AggregateResponse>


接口

权限响应

Prop类型
readRecordType[]
writeRecordType[]

读取记录回复

阅读健康记录后的反应.

当使用自动页标( 未提供页面Token) 时, 所有记录都会返回 下一个PageToken将被取消定义.

当使用手动 pagination (pageToken 提供) 时, 下一个 PageToken 将包含 下页的符号,如果这是最后一页,则未定义.

Prop类型
recordsany[]
nextPageTokenstring

总体反应

健康记录汇总的答复. 载有按时间段分类的汇总数据.

Prop类型
aggregatesAggregateData[]

汇总数据

特定时期的汇总数据.

Prop类型
startTimestring
endTimestring
valuenumber
unitstring

类型异名

健康连通性

'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/ 电容- 机器人- 健康连接

版本与发布记录

@devmaxime/capacitor-health-connect 共发布 4 个版本,首次发布于 2025/09/27;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.1.0latest2025/10/271 年前
1.0.22025/09/271.1 年前
1.0.12025/09/271.1 年前
1.0.02025/09/271.1 年前

关于 @devmaxime/capacitor-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 和提交记录判断。