更新记录
1.0.1(2021-10-28)
1.优化通信 2.处理接口bug
1.0.0(2021-07-13)
主屏打开副屏页面连接,副屏开启websocket,并且主屏连接,客互相发送消息,根据消息内容,自定义副屏内容 副屏推荐使用普通html+vue.js监听消息,并作出对应操作,副屏不受限制,可自行设计一切内容,当成普通网页 即可。副屏页面和所用到的文件一定要放在static文件夹里面,且html文件必须放在static文件夹根目录
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 11.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原生插件配置”->”云端插件“列表中删除该插件重新选择
双屏异显使用说明
# 勾选插件后引入插件
const XM_SCREEN_Module = uni.requireNativePlugin('XM-SCREEN-Module');
# 转换文件路径并打开
cocnst url = plus.io.convertLocalFileSystemURL('/static/index.html')
XM_SCREEN_Module.ShowViceScreen(url)
# 副屏 index.html页面开启websocket服务
//接收插件带来的js对象
const screenFn = window.screenObj
//开始websocket服务
screenFn.startServer(8888);
//开始接收主屏消息
function onRecvMainMsg(data) {
//主屏消息
console.log(data)
//发送数据到主屏
screenFn.sendMainMsg('消息回馈----');
}
# 主屏连接websocket 延时一下,等待页面成功开启服务
setTimeout(function(){
//连接
uni.connectSocket({
url:"ws://127.0.0.1:8888",
});
//打开成功监听
uni.onSocketOpen(function (res) {
androidScreen = true
console.log('WebSocket连接已打开!');
});
//打开失败监听
uni.onSocketError(function (res) {
console.log('WebSocket连接打开失败,请检查!');
});
//发送消息 最好发送json字符串 JSON.stringify => JSON.parse解析使用
let msg = {type:'android',data:'发送消息'}
uni.sendSocketMessage({
data: JSON.stringify(msg),
success:(res) => {
console.log('消息发送成功',res);
},
fail:(err) => {
console.log('发送失败', err)
}
});
//接收消息
uni.onSocketMessage((res) => {
console.log('收到服务器内容:' + res.data);
});
},2000);