@capgo/capacitor-pedometer

中文文档

8.0.54发布于 2026/11/09MPL-2.0TypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 5.3万

电容插件,用于访问计时器数据,包括步骤、距离、速度、节奏和地板

文档目录23 节

*免费开始*
主要特点
兼容性
安装
配置
iOS系统
机器人
API 密码
获取计量(...)
易读 ()
启动测量更新日期( )
停止测量更新日期( )
检查( )
请求( )
添加倾听器( “ 度量器 ” ,...)
删除所有收听器( )
获取 PluginVersion ()
接口
类型异名
使用量
平台支持
页:1
许可证

@ capgo/ 电容器计

在您的 Capacitor app 中与设备运动传感器一起计算步骤: 现场步骤更新和历史查询健身,健康和挑战应用.

队长:在几分钟内将修正推给您的 Capacitor 用户,在没有Mac的情况下构建已签名的iOS和Android apps,并在一击中回滚.

免费开始

14天无限自由审判. 不需要信用卡

🤖 建筑与AI编码代理? 安装 Capgo 技能所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 @capgo/capacitor-pedometer 在您的电容应用程序中: npx skills add Cap-go/capgo-skills。然后问你的经纪人: 添加@capgo/电容计到我的电容软件上并把它接上 代理设置指南 • 妇女主机磁共振

主要特点

实时更新数字 : startMeasurementUpdates() 流经 measurement 事件, stopMeasurementUpdates() 结束它.
IOS上的历史数字 : getMeasurement() 返回时间范围的步骤.
IOS 的丰富数据:从Core Motion上起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起.
可用性数字 : isAvailable() 告诉您设备支持的衡量标准 .
权限: 移动 iOS 和 ACTIVITY_RECOGNITION 安卓号.
平台: iOS和Android. 互联网档案馆的存檔,存档日期2013-12-21. Android)用步感应器来计算步数. 在网上不可用.

兼容性

插件版本	电容兼容性	维护
联合国	联合国	✅
页:1	页:1	应要求
页:1	页:1	❌
页:1	页:1	❌

说明: 此插件的主要版本沿用了Capacitor的主要版本. 使用匹配您的 Capacitor 安装的版本( 如 Capacitor 8 的插件 v8) 。只有最新的主要版本得到积极维护.

安装

您可以使用我们的 AI 辅助设置安装插件。使用以下命令将 Capgo 技能添加到您的 AI 工具 :

npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins

然后使用下列提示:

Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-pedometer` plugin in my project.

如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:

npm install @capgo/capacitor-pedometer
npx cap sync

配置

iOS系统

在您的 Info.plist数字 :

<key>NSMotionUsageDescription</key>
<string>We need access to your motion data to track steps and activity</string>

机器人

插件将自动添加 ACTIVITY_RECOGNITION 允许您使用 AndroidManifest.xml。。。 .

对于Android 10(API 29)及以上,您需要请求 ACTIVITY_RECOGNITION 允许在运行时间.

获取计量(...)

getMeasurement(options?: GetMeasurementOptions | undefined) => Promise<Measurement>

获得一定时间范围内的平分计测量.

参数	类型
`options`	`GetMeasurementOptions`

回返情况: Promise<Measurement>

自: 0.0.1 资源

易读 ()

isAvailable() => Promise<IsAvailableResult>

检查此设备上有哪些平面计特性 .

回返情况: Promise<IsAvailableResult>

自: 0.0.1 资源

启动测量更新日期( )

startMeasurementUpdates() => Promise<void>

开始接收实时计分仪测量更新.

打开 机器人 财务报告和审定财务报表 iOS系统,则 measurement 事件仅在呼叫后被解除 startMeasurementUpdates()。。。 .

自: 0.0.1 资源

停止测量更新日期( )

stopMeasurementUpdates() => Promise<void>

停止接收实时计分仪测量更新.

自: 0.0.1 资源

检查( )

checkPermissions() => Promise<PermissionStatus>

检查访问平面计数据的许可 .

打开 机器人,这个检查 ACTIVITY_RECOGNITION 允许. 打开 iOS系统,这个检查运动使用权限.

回返情况: Promise<PermissionStatus>

自: 0.0.1 资源

请求( )

requestPermissions() => Promise<PermissionStatus>

请求访问计分仪数据的许可 .

打开 机器人,请 ACTIVITY_RECOGNITION 允许. 打开 iOS系统,这要求动议使用许可.

回返情况: Promise<PermissionStatus>

自: 0.0.1 资源

添加倾听器( “ 度量器 ” ,...)

addListener(eventName: 'measurement', listenerFunc: (event: MeasurementEvent) => void) => Promise<PluginListenerHandle>

收到新的计分器测量后调用 .

参数	类型
`eventName`	`'measurement'`
`listenerFunc`	`(event: Measurement) => void`

回返情况: Promise<PluginListenerHandle>

自: 0.0.1 资源

删除所有收听器( )

removeAllListeners() => Promise<void>

删除此插件的所有听众 .

自: 0.0.1 资源

获取 PluginVersion ()

getPluginVersion() => Promise<{ version: string; }>

获取本地 Capacitor 插件版本 .

回返情况: Promise<{ version: string; }>

自: 1.0.0 (单位:千美元)

接口

计量

Prop	类型	说明	自兹
`numberOfSteps`	`number`	用户采取的步骤数量.	0.0.1 资源
`distance`	`number`	用户旅行的估计距离(以米计)。仅存于 iOS系统。。。 .	0.0.1 资源
`floorsAscended`	`number`	大约几层升起。仅存于 iOS系统。。。 .	0.0.1 资源
`floorsDescended`	`number`	楼层的大致数量下降。仅存于 iOS系统。。。 .	0.0.1 资源
`currentPace`	`number`	目前的速度(每米以秒计). 仅存于 iOS系统。。。 .	0.0.1 资源
`currentCadence`	`number`	现相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相仅存于 iOS系统。。。 .	0.0.1 资源
`averageActivePace`	`number`	平均活性速度(每米以秒计). 仅存于 iOS系统。。。 .	0.0.1 资源
`startDate`	`number`	此测量的起步时间( 自纪元起为毫秒) .	0.0.1 资源
`endDate`	`number`	这一测量的结束时间(自纪元起为毫秒).	0.0.1 资源

获得计量选项

Prop	类型	说明	自兹
`start`	`number`	测量查询的起始时间(自纪元起为毫秒). 所需时间 iOS系统。。。 .	0.0.1 资源
`end`	`number`	测量查询的结束时间(自纪元后为毫秒). 所需时间 iOS系统。。。 .	0.0.1 资源

易伤性结果

Prop	类型	说明	自兹
`stepCounting`	`boolean`	步数是否可用 .	0.0.1 资源
`distance`	`boolean`	距离测量是否可用。仅 `true` 打开 iOS系统支持远程跟踪的设备.	0.0.1 资源
`pace`	`boolean`	是否可用速度测量。仅 `true` 打开 iOS系统用于支持速度跟踪的设备.	0.0.1 资源
`cadence`	`boolean`	是否可进行节奏测量。仅 `true` 打开 iOS系统用于支持cadence跟踪的设备.	0.0.1 资源
`floorCounting`	`boolean`	有无底数. 仅 `true` 打开 iOS系统支持地板跟踪的设备.	0.0.1 资源

权限状态

Prop	类型	说明	自兹
`activityRecognition`	`'prompt' \| 'prompt-with-rationale' \| 'granted' \| 'denied'`	活动识别许可状态。打开机器人,这是 `ACTIVITY_RECOGNITION` 允许。打开 iOS系统这是运动使用许可.	0.0.1 资源

插件听筒

Prop	类型
`remove`	`() => Promise<void>`

类型异名

测量事件

Measurement

使用量

import { CapacitorPedometer } from '@capgo/capacitor-pedometer';

// Check availability
const availability = await CapacitorPedometer.isAvailable();
console.log('Features available:', availability);

// Check and request permissions
const permission = await CapacitorPedometer.checkPermissions();
if (permission.activityRecognition !== 'granted') {
  await CapacitorPedometer.requestPermissions();
}

// Start real-time updates
await CapacitorPedometer.addListener('measurement', (data) => {
  console.log('Steps:', data.numberOfSteps);
  console.log('Distance:', data.distance);
});

await CapacitorPedometer.startMeasurementUpdates();

// Query historical data (iOS only - requires start and end timestamps)
const now = Date.now();
const yesterday = now - (24 * 60 * 60 * 1000);
const measurement = await CapacitorPedometer.getMeasurement({
  start: yesterday,
  end: now
});

// Stop updates
await CapacitorPedometer.stopMeasurementUpdates();
await CapacitorPedometer.removeAllListeners();

平台支持

特性	机器人	iOS系统
步数	✅	✅
距离	❌	✅
颜色	❌	✅
低调	❌	✅
楼层计数	❌	✅
历史查询	❌	✅

页:1

打开 机器人,只有步骤计数。该插件使用 TYPE_STEP_COUNTER 感应器.
打开 iOS系统,所有特性都可以在使用 CMPedometer。。。 .
历史数据查询需要明确 start 财务报告和审定财务报表 end iOS上的时间戳.
Android的步数计数器给出了自上个设备重启以来的累积步数;插件跟踪了三角洲.
当应用程序处于后台时,会暂停测量.

许可证

麻省理工学院

版本与发布记录

@capgo/capacitor-pedometer 共发布 60 个版本，首次发布于 2025/10/27；过去 12 个月发布了 55 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本	发布日期	距今
`8.0.54`latest	2026/11/09	今天
`8.0.53`	2026/11/02	6 天前
`8.0.52`	2026/10/26	13 天前
`8.0.51`	2026/10/19	20 天前
`8.0.50`	2026/10/15	25 天前
`8.0.49`	2026/10/13	27 天前

关于 @capgo/capacitor-pedometer 的常见问题

@capgo/capacitor-pedometer 是什么？

电容插件,用于访问计时器数据,包括步骤、距离、速度、节奏和地板

如何安装 @capgo/capacitor-pedometer？

在项目目录运行 npm install @capgo/capacitor-pedometer，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（>=8.0.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

@capgo/capacitor-pedometer 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@capgo/capacitor-pedometer 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require() 都可以使用，打包工具会自动选择合适的版本。

@capgo/capacitor-pedometer 可以商用吗？

@capgo/capacitor-pedometer 使用 MPL-2.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。

@capgo/capacitor-pedometer 的下载量有多少？

根据 npm 官方下载统计，@capgo/capacitor-pedometer 在 2026/10/09 – 2026/11/07 这 30 天内被下载 52,611 次，日均约 1,754 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@capgo/capacitor-pedometer 还在维护吗？

最新版本 8.0.54 发布于 2026/11/09（今天）；至今共发布 60 个版本，其中过去 12 个月发布了 55 个；首次发布于 2025/10/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

npm install @capgo/capacitor-pedometer

pnpmpnpm add @capgo/capacitor-pedometer
yarnyarn add @capgo/capacitor-pedometer
bunbun add @capgo/capacitor-pedometer

peer 依赖@capacitor/core >=8.0.0

npm 7+ 与 pnpm 8+ 会自动安装必需的 peer 依赖，Yarn 需手动安装。

在你的项目目录中运行此命令。

近 30 天下载

52,611

约 5.3万次日均 1,754 次

统计周期 2026/10/09 – 2026/11/07
数据来自 npm 官方下载统计，今天更新

最新版本8.0.54发布于今天

开源许可MPL-2.0文件级弱 Copyleft

包体积87.8 kB24 个文件 · 解压后

运行依赖0 个另有 1 个 peer 依赖

模块格式ESM + CJS

TypeScript自带类型

发布版本60 个近 12 个月 55 个

首次发布2025/10/271 年前

元数据更新2026/11/09

每一个软件包背后，
都有分享与创造的人。

@capgo/capacitor-pedometer

@ capgo/ 电容器计

*免费开始*

主要特点

兼容性

安装

配置

iOS系统

机器人

API 密码

获取计量(...)

易读 ()

启动测量更新日期( )

停止测量更新日期( )

检查( )

请求( )

添加倾听器( “ 度量器 ” ,...)

删除所有收听器( )

获取 PluginVersion ()

接口

计量

获得计量选项

易伤性结果

权限状态

插件听筒

类型异名

测量事件

使用量

平台支持

页:1

许可证

版本与发布记录

关于 @capgo/capacitor-pedometer 的常见问题

@capgo/capacitor-pedometer 是什么？

如何安装 @capgo/capacitor-pedometer？

@capgo/capacitor-pedometer 支持 TypeScript 吗？

@capgo/capacitor-pedometer 支持 ESM 还是 CommonJS？

@capgo/capacitor-pedometer 可以商用吗？

@capgo/capacitor-pedometer 的下载量有多少？

@capgo/capacitor-pedometer 还在维护吗？

免费开始