跳转至正文

计步器 Capacitor 插件

利用设备计步传感器追踪步数、距离、配速、步频和楼层数

安装

bun add @capgo/capacitor-pedometer bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-pedometer
  • pnpm add @capgo/capacitor-pedometer
  • yarn add @capgo/capacitor-pedometer

指南

如何在 Capacitor 中使用 Pedometer

在设备上测试

下载 Capgo App,然后扫描二维码 code。

计步器插件预览二维码 code

使用 @capgo/capacitor-pedometer

Capacitor 插件用于获取计步器数据,包括步数、距离、配速、步频和楼层数。

安装

bun add @capgo/capacitor-pedometer
bunx cap sync

bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。

导入

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

API 概览

方法 描述
getMeasurement 获取指定时间范围内的计步器测量数据。
isAvailable 检查当前设备支持哪些计步器功能。
startMeasurementUpdates 开始接收实时的计步器测量数据更新。
stopMeasurementUpdates 停止接收实时的计步器测量更新。
checkPermissions 检查访问计步器数据的权限。
requestPermissions 请求访问计步器数据的权限。

示例

getMeasurement()

获取指定时间范围内的计步器测量数据。

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

const result = await CapacitorPedometer.getMeasurement();
console.log(result);

isAvailable()

检查当前设备支持哪些计步器功能。

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

const result = await CapacitorPedometer.isAvailable();
console.log(result);

startMeasurementUpdates()

开始接收实时的计步器测量数据更新。

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

await CapacitorPedometer.startMeasurementUpdates();

stopMeasurementUpdates()

停止接收实时的计步器测量更新。

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

await CapacitorPedometer.stopMeasurementUpdates();

checkPermissions()

检查访问计步器数据的权限。

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

const result = await CapacitorPedometer.checkPermissions();
console.log(result);

requestPermissions()

请求访问计步器数据的权限。

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

const result = await CapacitorPedometer.requestPermissions();
console.log(result);

监听事件

addListener 会返回一个句柄。调用 handle.remove() 在屏幕卸载时,或者调用 CapacitorPedometer.removeAllListeners() 以清除所有监听器。

完整参考文档

从“使用 @capgo/capacitor-pedometer”继续

如果你正在使用 使用 @capgo/capacitor-pedometer 要规划原生插件工作,请将其与 @capgo/capacitor-pedometer 有关 @capgo/capacitor-pedometer 的实现细节, 快速入门 有关“入门指南”中的实现细节, Capgo 插件目录 查看 Capgo 插件目录中的产品工作流, Capgo 提供的 Capacitor 插件 有关 Capgo 开发的 Capacitor 插件的实现细节,以及 添加或更新插件 有关添加或更新插件的实现细节。

常见问题

Pedometer 插件常见问题

如何在 Capacitor 应用中安装 Pedometer 插件?

运行 "bun add @capgo/capacitor-pedometer"(或 "npm install @capgo/capacitor-pedometer"),然后运行 "bunx cap sync",让 iOS 和 Android 项目拉取到原生 code。然后在应用的 code 中从 "@capgo/capacitor-pedometer" 导入。

@capgo/capacitor-pedometer 支持 React、Vue 和 Angular 吗?

支持。Pedometer 是一个 Capacitor 包,因此任何运行在 Capacitor 里的 Web 框架都能用,包括 Ionic、React、Vue、Angular、Svelte 和纯 JavaScript。

@capgo/capacitor-pedometer 支持哪个 Capacitor 版本?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-pedometer 是免费开源的吗?

是的。code 的源码公开在 GitHub 上:https://github.com/Cap-go/capacitor-pedometer/,也可以从 npm 免费安装。欢迎提交 bug 报告和 Pull Request。

我可以在不经过 App Store 审核的情况下更新使用 Pedometer 的 code 吗?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待 App 审核,即可发布 Pedometer 更新

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo