更新记录

2.1（2023-04-21）

修复Android端检查运动传感器权限grantedStepPermission接口返回值相反问题。

2.0（2023-04-18）

增加grantedStepPermission接口检查运动传感器权限是否开启。

1.9（2023-02-13）

Android端为了方便上架市场去掉android.permission.RECEIVE_BOOT_COMPLETED权限，如有需要可以Manifest权限里面勾选。

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

计步器（Android和iOS）

1. 获取计步器插件对象

<script>
    //获取计步器插件对象
    var StepCounter = uni.requireNativePlugin('YStep-Counter');

    var that;
    export default {
        data() {
        },
        onLoad() {
        }
    }
</script>

2. 设置计步器数据回调

onLoad() {
    that = this;
    //设置计步回调
    StepCounter.setStepCallback(function(res){
        console.log(res);
        var numberOfSteps = res.numberOfSteps;//当天累计步数
        var distance = res.distance;//当天累计距离
        that.title = "步数：" + numberOfSteps + "步, 距离：" + distance.toFixed(0) + "米";
    });
}

3. 检查允许通知和忽略电池优化，保活需要，不需要保活可忽略（只支持android）

checkNotifyAndBattery() {
    //检查是否允许通知，oppo vivo等部分手机默认不允许通知
    if (StepCounter.areNotificationsEnabled()) {
        //是否忽略电池优化，vivo部分手机需要忽略电池优化，保活才不被杀掉
        var ret = StepCounter.isIgnoringBatteryOptimizations();
        console.log(ret);
        if (ret == true) {
            this.initStep(true);
        } else {
            //请求忽略电池优化, 由于暂时没有回调通知，只能轮询检查isIgnoringBatteryOptimizations
            StepCounter.requestIgnoreBatteryOptimizations();
        }
    } else {
        //打开设置通知
        StepCounter.openSetting();
    }
}

4. 初始化计步器，必需调用（只支持android）

initStep(enable) {
    //检查权限
    StepCounter.checkPermission(function(res) {
        if (res.result == true) {
            //初始化计步器
            StepCounter.initStep({
                enable:enable,//是否启用前台保活服务通知，默认启用
                contentTitle:"计步器",//标题
                //largeIcon:iconPath,//大图标
                contentText:"正在后台运行"//描述
            });
        } else {
            //提示用户权限被禁止
        }
    }); 
}

5. 销毁计步器（只支持android）

//销毁计步器
StepCounter.destroyStep();

6. 计步器清零（只支持android）

//计步器清零
StepCounter.clearStep();

7. 检查运动传感器权限是否开启

var ret = StepCounter.grantedStepPermission() 
console.log(ret);//true or false

8. 根据日期查询历史计步

var date = "2022-09-13";//日期
StepCounter.queryStepByDate(date, function(res) {
    console.log(res);
});

9. 开启计步器监控

//开启计步监控
StepCounter.startStepCounter();

10. 停止计步器监控

//停止计步监控
StepCounter.stopStepCounter();

11. 手动查询当天计步

var that = this;
//查询计步
StepCounter.queryStepCounter(function(res){
    console.log(res);
    var numberOfSteps = res.numberOfSteps;//当天累计步数
    var distance = res.distance;//当天累计距离
    that.title = "步数：" + numberOfSteps + "步, 距离：" + distance.toFixed(0) + "米";
});