更新记录

1.2.0(2022-10-19)

本次主要更新: 1.init方法,设置参数 upload.isNotification 失效问题

1.1.0(2022-10-18)

本次主要更新: 1.增加自动上传短信 2.增加完全关闭app,也收到短信

1.0.0(2022-10-17)

新版首发

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 12.0 armeabi-v7a:支持,arm64-v8a:支持,x86:支持 ×

原生插件通用使用流程:

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


KJ-SMS

设置默认短信应用、监听短信(完全关闭app也可)、自动上传短信到服务器

注意事项


1.完全关闭监听短信,不保证所有机型有效,测试小米和华为可以,vivo手机不可以(因为系统会自动更换为系统的信息,前台可以监听短信)
2.不设置默认短信应用,前台也可以监听短信,后台监听短信,需要设置为默认短信应用

使用

<template>
    <view class="content">
        <button type="primary" @click="isDefaultSMS">判断本app是不是默认短信应用</button>
        <button type="primary" @click="checkIfDefaultSMS">设置默认短信应用</button>
        <button type="primary" @click="init">初始化配置</button>
        <button type="primary" @click="onSMSReceiver">监听短信</button>
        <view>
            收到短信:{{message}}
        </view>
    </view>
</template>

<script>
    const KJSMS = uni.requireNativePlugin('KJ-SMS');
    export default {
        data() {
            return {
                title: 'Hello',
                message: null,
                id: null
            }
        },
        onLoad() {
            if (plus.os.name == 'Android') {
                plus.android.requestPermissions(
                    ['android.permission.RECEIVE_SMS',
                        "android.permission.READ_SMS"
                    ],
                    function(resultObj) {
                        var result = 0;
                        for (var i = 0; i < resultObj.granted.length; i++) {
                            var grantedPermission = resultObj.granted[i];
                            console.log('已获取的权限:' + grantedPermission);
                            result = 1
                        }
                        for (var i = 0; i < resultObj.deniedPresent.length; i++) {
                            var deniedPresentPermission = resultObj.deniedPresent[i];
                            console.log('拒绝本次申请的权限:' + deniedPresentPermission);
                            result = 0
                        }
                        for (var i = 0; i < resultObj.deniedAlways.length; i++) {
                            var deniedAlwaysPermission = resultObj.deniedAlways[i];
                            console.log('永久拒绝申请的权限:' + deniedAlwaysPermission);
                            result = -1
                        }
                    },
                    function(error) {
                        console.log('申请权限错误:' + error.code + " = " + error.message);
                    }
                );
                this.init();
                this.isDefaultSMS();
                this.onSMSReceiver();
            }
        },
        methods: {
            isDefaultSMS() {
                KJSMS.isDefaultSMS((res) => {
                    console.log("isDefaultSMS:" + JSON.stringify(res))
                    if (res.result == false) {
                        uni.showModal({
                            title: '提示',
                            content: 'app不是默认短信应用,是否改变?',
                            success: (res) => {
                                if (res.confirm) {
                                    this.checkIfDefaultSMS();
                                } else if (res.cancel) {
                                    console.log('用户点击取消');
                                }
                            }
                        });
                    }
                })
            },
            checkIfDefaultSMS() {
                KJSMS.checkIfDefaultSMS((res) => {
                    console.log("checkIfDefaultSMS:" + JSON.stringify(res))
                    if (res.resultCode != -1) { //等于 -1 是授权
                        uni.showModal({
                            title: '提示',
                            content: 'app不是默认短信应用,是否改变?',
                            success: (res) => {
                                if (res.confirm) {
                                    this.checkIfDefaultSMS();
                                } else if (res.cancel) {
                                    console.log('用户点击取消');
                                }
                            }
                        });
                    }
                })
            },
            init() {
                /**
                 * body - 上传添加自定义的字段,默认是:[{"message":{"time":"2022-10-18 11:53:58",
                 * "action":"android.provider.Telephony.SMS_DELIVER","displayOriginatingAddress":"xxx",
                 * "serviceCenterAddress":"xxx","originatingAddress":"xxx","displayMessageBody":"8"},
                 * "test":"123"}]
                 * */
                KJSMS.init({
                    "upload": { //如果不需要上传,设置为null
                        "url": "xxx", //上传接口
                        "headers": {}, //请求头
                        "body": {
                            "test": "123" 
                        },
                        "isReUpload": true, //是否重新上传,
                        "isNotification": true //上传成功/失败,是否显示通知,方便测试
                    },
                    "notification": {
                        "isNotification": true //收到短信,是否显示通知
                    }
                })
            },
            onSMSReceiver() {
                /**
                 * app在打开的情况才会回调,可以回调完全关闭app时收到历史的短信
                 * */
                KJSMS.onSMSReceiver((res) => {
                    /**
                     * 返回字段说明:[{"message":{"time":"2022-10-18 11:53:58",
                     * "action":"android.provider.Telephony.SMS_DELIVER","displayOriginatingAddress":"xxx",
                     * "serviceCenterAddress":"xxx","originatingAddress":"xxx","displayMessageBody":"8"},
                     * "test":"123"}]
                     * message - 短信的相关信息
                     * originatingAddress - 发送人地址
                     * displayMessageBody - 收到的消息
                     * serviceCenterAddress - 服务中心地址
                     * time - 收到短信的时间
                     * */
                    this.message = JSON.stringify(res);
                    console.log("onSMSReceiver:" + JSON.stringify(res))
                })
            }
        }
    }
</script>

隐私、权限声明

1. 本插件需要申请的系统权限列表:

"<uses-permission android:name=\"android.permission.RECEIVE_SMS\"/>", "<uses-permission android:name=\"android.permission.READ_SMS\"/>"

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问