getStepCount
描述
获取运动步数。
网页应用需要完成鉴权后调用该接口。
调用前需要用户授权scope.runData,你需要兼容用户拒绝授权的场景。
该接口在Android和iOS双端在获取数据来源时,可能存在一定差异。
a. Android V5.31.0 及以前的版本 获取传感器设备中的当前总步数。如果设备重启,设备传感器中的步数会被清零。如果未能获取到步数信息。请检查设备是否支持 TYPE_STEP_COUNTER 传感器以及传感器是否正常工作。
b. Android V5.32.0 及以后的版本 在小米系列手机上,从小米运动中获取设备当天 0 点至当前时间的步数信息。相关信息参见小米运动文档。 在非小米系列手机上,获取传感器设备内的当前总步数。如果设备重启,设备传感器中的步数不会被清零,运动步数会一直累加。如果未能获取到步数信息, 请检查设备是否支持 TYPE_STEP_COUNTER 传感器以及传感器是否正常工作。
c. iOS 获取传感器设备内的当前总步数。如果设备重启,设备传感器中的步数不会被清零,运动步数会一直累加。如果未能获取到步数信息, 请检查设备是否支持 TYPE_STEP_COUNTER 传感器以及传感器是否正常工作
支持说明
| 客户端平台 | WPS协作版本要求 |
|---|---|
| iOS | >=5.12.0 |
| Android | >=5.12.0 |
输入
| 名称 | 数据类型 | 是否必填 | 描述 |
|---|---|---|---|
| onSuccess | Function | 否 | |
| onError | Function | 否 |
输出
| 名称 | 类型 | 描述 |
|---|---|---|
| stepCount | number | 设备当前步数 |
示例代码
ts
window.ksoxz_sdk.getStepCount({ onSuccess, onError })错误码
| errno | msg | 含义 |
|---|---|---|
| 1002006 | User not granted webApp runData permission | 用户未授予网页应用运动与健康权限 |
| 1021008 | step count permission not obtained | 未授权运动与健康系统权限 |
| 1023002 | step count not available | 设备不支持计步功能 |
| 1801001 | already start | 之前获取步数还未结束,请确保上次调用已经完成 |
除以上错误外,还可能存在公共错误,参考:公共错误码