uni.getWeRunData仅微信小程序可用，App需原生插件调用HealthKit/Health Connect，H5无法获取准确步数；跨平台必须分环境实现，缺一不可。
uni.getWeRunData 只在微信小程序里能用，App 和 H5 都不认
很多人一上来就写 uni.getWeRunData，结果在安卓 App 里调用失败、返回 errCode: -1，或者 H5 直接报 undefined。这不是你代码写错了，是这个 API 根本就不支持非微信小程序环境——它底层调的是微信原生的 wx.getWeRunData，只存在于微信小程序运行时中。
常见错误现象：
• App 端调用后无响应、success 不触发、fail 返回 “not supported”
• H5 页面控制台报错 “uni.getWeRunData is not a function”
• 在条件编译里没加 #ifdef MP-WEIXIN，导致其他平台执行报错
- 微信小程序：可用，但需用户授权
scope.werun，且数据加密需服务端解密（用session_key+encryptedData+iv） - App（Android/iOS）：必须走原生插件，
uni.getWeRunData完全无效 - H5：浏览器无权限访问系统健康数据，该 API 不可用，任何“H5 直接读手机步数”的方案都是伪命题
App 端必须用原生插件，别信“plus.sensor 能算准步数”
有人试过用 plus.sensor.startAccelerometer 自己写峰值检测算法，结果发现：同一段走路，不同手机误差 ±30%；静坐抖腿被记 200 步；电梯里掉 500 步……这不是你算法差，是加速度传感器本身不适合精确计步——它没校准、没上下文、没功耗优化，纯属“估算”，不是“读取”。
真正靠谱的做法，是调用系统级健康数据接口：
- Android：走
Health Connect（新设备）或Google Fit API（需 OAuth2 授权），不能绕过ACTIVITY_RECOGNITION权限 - iOS：必须用
HealthKit，且需在 Xcode 中开启 Capability，并在info.plist加NSHealthShareUsageDescription和NSHealthUpdateUsageDescription - 插件市场搜 “health-data” 或 “step-counter” 插件，优先选更新时间在 2025 年底之后、明确支持 Health Connect 的
示例调用（假设已集成插件 Health-Data）：
const health = uni.requireNativePlugin('Health-Data');<br>health.getStepCount({<br> startDate: Date.now() - 24 * 60 * 60 * 1000,<br> endDate: Date.now()<br>}, (res) => {<br> console.log('今日步数:', res.steps); // 注意：res.steps 是 number，不是字符串<br>});
manifest.json 权限配置漏一项，真机就直接静默失败
Android 上即使插件代码写对了，只要 manifest.json 里没声明 android.permission.ACTIVITY_RECOGNITION（Android 10+ 强制要求），或者 iOS 没配 healthWrite/healthRead，调用时不会弹授权框，也不会报错，而是直接回调空数据或 err: permission denied —— 这是最容易卡住人的点。
- Android 必须加：
"permissions": {<br> "activityRecognition": {}<br>} - iOS 必须在
manifest.json → 模块权限配置 → HealthKit打钩，并补全 plist 描述字段 - 插件调用前建议先检查权限：
uni.authorize({scope: 'scope.health'})（部分插件支持），否则用户第一次打开永远不知道为啥没数据
H5 环境下“获取步数”本质是伪需求，得换思路
浏览器出于隐私限制，navigator.health 几乎没厂商实现，DeviceMotion 事件只能拿到加速度粗粒度数据，且 iOS Safari 默认禁用后台监听。所谓“H5 计步”实际只有两个可行路径：
- 限定微信内打开：用
wx.onAccelerometerChange做轻量估算（仅作趣味展示，别当真） - 放弃 H5，引导用户下载 App 或跳转小程序：在按钮文案里写清楚“需使用手机健康数据，点击进入小程序查看准确步数”
别在 H5 里硬塞计步功能——审核不过、用户投诉多、数据不准，三输。
跨平台健康数据这件事，没有银弹。最稳的路径是：小程序用 uni.getWeRunData，App 用原生插件 + HealthKit/Health Connect，H5 就老老实实不碰步数。哪边少一步配置，真机上就断在哪。
