更新记录
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:支持 | × |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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>