更新记录

1.0.0（2025-12-22）

• 初次发布。
• 支持 Android、iOS、HarmonyOS Next 三端计步。
• 支持实时步数监听（增量计算）。
• 支持历史步数查询（iOS 支持 7 天历史，Android 支持运行期间记录查询）。
• 适配 Android 10+ 运行时权限。
• 采用 UTS 架构，无原生依赖，体积轻巧。

平台兼容性

uni-app(4.57)

uni-app x(4.57)

其他

beautifulman-fNumber 计步器插件

基于 UTS 开发的高性能计步器插件，支持 Android、iOS 和 HarmonyOS Next。提供实时步数监听和历史步数查询功能。

平台支持情况

注意：Android 端由于硬件特性，历史步数查询仅能查询到插件运行期间记录过的数据。iOS 支持查询过去 7 天的历史数据。

准备工作

使用本插件需要配置相关权限。

Android 配置

在 manifest.json 的 app-plus -> distribute -> android -> permissions 中添加：

"<uses-permission android:name=\"android.permission.ACTIVITY_RECOGNITION\"/>"

且建议设置 targetSdkVersion 为 29 或更高。

iOS 配置

在 manifest.json 的 app-plus -> distribute -> ios -> privacyDescription 中添加：

"NSMotionUsageDescription": "需要访问您的运动数据以进行计步"

HarmonyOS 配置

插件已内置权限声明：ohos.permission.ACTIVITY_MOTION。

API 说明

1. isStepCountingSupported()

检查当前设备是否支持计步功能。

返回值：Boolean (true: 支持, false: 不支持)

示例代码：

import { isStepCountingSupported } from "@/uni_modules/beautifulman-fNumber";

const isSupported = isStepCountingSupported();
console.log(isSupported ? "支持计步" : "不支持计步");

2. startStepCountUpdates(options)

开始实时监听步数更新。每当步数发生变化时，会触发 success 回调。

示例代码：

import { startStepCountUpdates } from "@/uni_modules/beautifulman-fNumber";

startStepCountUpdates({
  success: (res) => {
    console.log("实时步数:", res.steps);
  },
  fail: (err) => {
    console.error("启动失败:", err.errMsg);
  }
});

3. stopStepCountUpdates()

停止实时步数监听，释放系统资源。

示例代码：

import { stopStepCountUpdates } from "@/uni_modules/beautifulman-fNumber";

stopStepCountUpdates();

4. queryStepCount(options)

按日期范围查询步数。

示例代码：

import { queryStepCount } from "@/uni_modules/beautifulman-fNumber";

const now = new Date();
const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime();

queryStepCount({
  startDate: todayStart,
  endDate: now.getTime(),
  success: (res) => {
    console.log("今日总步数:", res.steps);
  },
  fail: (err) => {
    console.error("查询失败:", err.errMsg);
  }
});

错误码说明