更新记录

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:支持 ×

原生插件通用使用流程:

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


双屏异显使用说明

# 勾选插件后引入插件
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);

隐私、权限声明

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

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/> <uses-permission android:name="android.permission.SYSTEM_OVERLAY_WINDOW" />

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

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

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