# @capgo/capacitor-pedometer 中文文档

规范地址：https://npmcn.com/package/%40capgo/capacitor-pedometer/

版本：8\.0\.54
npm 元数据更新时间：2026-11-09T07:25:44.378Z
中文译文更新时间：2026-11-09T03:22:37.412Z
软件包许可：MPL-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40capgo/capacitor-pedometer
原文对照：https://npmcn.com/package/%40capgo/capacitor-pedometer/?lang=original
项目主页：https://capgo.app/docs/plugins/pedometer/
源码仓库：https://github.com/Cap-go/capacitor-pedometer

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：87.8 kB，24 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@capacitor/core \>=8\.0\.0
- 首次发布：2025-10-27T07:06:34.871Z
- 最新版本发布：2026-11-09T07:25:44.032Z
- 近 30 天下载量：52611（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：60（近 12 个月 55 个）

## 中文简介

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

## 安装

```sh
npm install @capgo/capacitor-pedometer
```

也可以使用：`pnpm add @capgo/capacitor-pedometer`、`yarn add @capgo/capacitor-pedometer`、`bun add @capgo/capacitor-pedometer`

## README

# @ capgo/ 电容器计

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

[![Capgo - Build Capacitor apps with AI, ship updates instantly](https://capgo.app/readme-banner.svg?repo=Cap-go/capacitor-pedometer)](https://capgo.app/?ref=plugin_pedometer)

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

## [\*免费开始\*](https://capgo.app/register/?ref=plugin_pedometer)

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

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

![@capgo/capacitor-pedometer for Capacitor apps](https://raw.githubusercontent.com/Cap-go/capacitor-pedometer/main/assets/github-social-preview.png)

## 主要特点

-   **实时更新**数字 : `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 工具 :

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

然后使用下列提示:

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

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

```bash
npm install @capgo/capacitor-pedometer
npx cap sync
```

## 配置

### iOS系统

在您的 `Info.plist`数字 :

```xml
<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` 允许在运行时间.

## API 密码

-   [`getMeasurement(...)`](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-getmeasurement)
-   [`isAvailable()`](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-isavailable)
-   [`startMeasurementUpdates()`](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-startmeasurementupdates)
-   [`stopMeasurementUpdates()`](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-stopmeasurementupdates)
-   [`checkPermissions()`](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-checkpermissions)
-   [`requestPermissions()`](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-requestpermissions)
-   [`addListener('measurement', ...)`](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-addlistenermeasurement-)
-   [`removeAllListeners()`](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-removealllisteners)
-   [`getPluginVersion()`](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-getpluginversion)
-   [接口](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-interfaces)
-   [类型异名](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-type-aliases)

### 获取计量(...)

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

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

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[GetMeasurementOptions](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-getmeasurementoptions)` |

**回返情况:** `Promise<[Measurement](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-measurement)>`

**自:** 0.0.1 资源

* * *

### 易读 ()

```typescript
isAvailable() => Promise<IsAvailableResult>
```

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

**回返情况:** `Promise<[IsAvailableResult](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-isavailableresult)>`

**自:** 0.0.1 资源

* * *

### 启动测量更新日期( )

```typescript
startMeasurementUpdates() => Promise<void>
```

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

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

**自:** 0.0.1 资源

* * *

### 停止测量更新日期( )

```typescript
stopMeasurementUpdates() => Promise<void>
```

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

**自:** 0.0.1 资源

* * *

### 检查( )

```typescript
checkPermissions() => Promise<PermissionStatus>
```

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

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

**回返情况:** `Promise<[PermissionStatus](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-permissionstatus)>`

**自:** 0.0.1 资源

* * *

### 请求( )

```typescript
requestPermissions() => Promise<PermissionStatus>
```

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

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

**回返情况:** `Promise<[PermissionStatus](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-permissionstatus)>`

**自:** 0.0.1 资源

* * *

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

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

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

| 参数 | 类型 |
| --- | --- |
| **`eventName`** | `'measurement'` |
| **`listenerFunc`** | `(event: [Measurement](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-measurement)) => void` |

**回返情况:** `Promise<[PluginListenerHandle](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-pluginlistenerhandle)>`

**自:** 0.0.1 资源

* * *

### 删除所有收听器( )

```typescript
removeAllListeners() => Promise<void>
```

删除此插件的所有听众 .

**自:** 0.0.1 资源

* * *

### 获取 PluginVersion ()

```typescript
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](https://npmcn.com/package/%40capgo/capacitor-pedometer/#readme-measurement)`

## 使用量

```typescript
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 是什么？

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

### 如何安装 @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 和提交记录判断。