更新记录

1.0.1（2022-12-29）

无

平台兼容性

原生插件通用使用流程：

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

第三方应用使用统计插件说明

-第三方应用使用统计 白名单后台运行 判断第三方应用有没有在运行、在前台的时长

使用注意事项：
1、购买前请先在自己的项目试用！（重要）
2、购买前请先在自己的项目试用！（重要）

第三方应用使用统计插件

使用示例

    <template>
        <view>
            <button class="button" @click="ignoring">申请白名单，应用可以保持后台运行</button>

            <button class="button" @click="hasPermission">是否有统计权限</button>
            <button class="button" @click="situationPerm">申请统计权限</button>

            <button class="button" @click="isInactiv">指定应用是否活跃</button>
            <button class="button" @click="getForTime">指定应用在前台的时长</button>

            <button class="button" @click="intForTime">定时判断指定应用在前台的时长</button>
            <button class="button" @click="clearForTime">取消定时</button>
        </view>
    </template>

    <script>
        const situationModule = uni.requireNativePlugin('SL-situation');
        export default {
            data() {
                return {
                    pkName:"com.tencent.mm",// 应用包名
                }
            },
            methods: {
                ignoring(){
                    if (situationModule.isSupIgnoring()) {
                        if (situationModule.isIgnoring()) {
                            uni.showToast({duration:3000,title:"已加入白名单",icon: 'none',position:'bottom'});
                        } else{
                            // 申请当前应用加入白名单
                            situationModule.reqIgnoring();
                        }
                    } else{
                        uni.showToast({duration:3000,title:"手机版本太低，没有白名单功能",icon: 'none',position:'bottom'});
                    }
                },

                hasPermission(){
                    if (situationModule.hasPermission()) {
                        uni.showToast({duration:3000,title:"已有活动统计权限",icon: 'none',position:'bottom'});
                    } else{
                        uni.showToast({duration:3000,title:"未有活动统计权限",icon: 'none',position:'bottom'});
                    }
                },
                situationPerm(){
                    let info = uni.getAppBaseInfo();
                    situationModule.situationPerm();
                    uni.showToast({duration:3000,title:"找到“"+ info.appName +"”应用，开启允许查看使用情况",icon: 'none',position:'bottom'});
                },
                isInactiv(){
                    // 根据应用包名判断应用是否处于不活跃状态 安卓6及以上有效
                    if (situationModule.isInactiv(this.pkName)) {
                        uni.showToast({duration:3000,title:"应用处于不活跃状态",icon: 'none',position:'bottom'});
                    } else{
                        // 后台运行也是活跃
                        uni.showToast({duration:3000,title:"应用处于活跃状态",icon: 'none',position:'bottom'});
                    }
                },
                getForTime(){
                    // 安卓5及以上有效
                    // 指定应用在最近5分钟内处于前台的时长，返回时间的单位为毫秒
                    let t = situationModule.getForTime(
                     this.pkName,// 应用包名
                     300000,// 最近n毫秒内处于前台的时间
                     );
                    uni.showToast({duration:3000,title:"指定应用在最近5分钟内处于前台的时长："+ t,icon: 'none',position:'bottom'});
                },
                intForTime(){
                    if (!this.out) {
                        this.out = setInterval(this.getForTime,3000)
                    }
                },
                clearForTime(){
                    if (this.out) {
                        clearInterval(this.out);
                        this.out = 0;
                    }
                },
            }
        }
    </script>

    <style>
    .button{
        margin-top: 10px;
    }

    </style>