更新记录

2.2（2024-05-22）

1、插件Android端适配android13通知权限，增加StepCounter.openNotifySetting()打开通知栏设置界面接口。 2、插件Android端增加打开自启动设置界面接口StepCounter.openAutoStartSetting()。 3、修复targetSdkVersion设置33打包是开启保活闪退问题。 4、去掉存储相关权限。

2.1（2023-04-21）

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

2.0（2023-04-18）

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

平台兼容性

原生插件通用使用流程：

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原生插件配置”->”云端插件“列表中删除该插件重新选择

计步器uniapp原生插件接口文档

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.openNotifySetting();
    }//*/
    //检查是否允许通知，oppo vivo等部分手机默认不允许通知
    StepCounter.checkNotificationsEnabled(function(enable){
        if (enable) {
            //是否忽略电池优化，vivo部分手机需要忽略电池优化，保活才不被杀掉
            StepCounter.checkIgnoringBatteryOptimizations(function(ret){
                if (ret == true) {
                    that.initStep(true);
                } else {
                    //请求忽略电池优化, 由于暂时没有回调通知，只能轮询检查isIgnoringBatteryOptimizations
                    //StepCounter.requestIgnoreBatteryOptimizations();
                }
            });
        } else {
            //打开通知设置界面
            //StepCounter.openNotifySetting();
        }
    });
}

4. 打开后台相关设置(后台活动)，（只支持android） 注：此接口不保证所有机型支持，部分机型可能需要去设置允许后台活动

//打开后台相关设置(后台活动)，注：此接口不保证所有机型支持，部分机型可能需要去设置允许后台活动
StepCounter.openAutoStartSetting();

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

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

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

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

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

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

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) + "米";
});