更新记录
1.0.7(2023-03-27) 下载此版本
close 事件支持 code、reason
1.0.6(2023-01-30) 下载此版本
iOS 不再使用 UIWebview
1.0.4(2019-08-06) 下载此版本
- 解决 iOS 端无法使用的问题。
- 解决关闭连接时必须提供code参数的问题。
平台兼容性
uni-app
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | √ | - | - | - |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
× | × | × | × | × | × | - | × | × | × | × |
其他
多语言 | 暗黑模式 | 宽屏模式 |
---|---|---|
× | × | √ |
plus-websocket
在 HTML5+ 和 WEB 环境使用小程序风格的 websocket 接口,支持 H5、5+APP、uni-app(不含小程序,小程序环境请直接使用 uni 接口)。
也可以用于解决 uni-app 环境下不支持 ArrayBuffer 类型数据和不支持多个 websocket 连接的问题以及解决使用 websocket 后导致部分安卓设备白屏的问题。
使用方式
NPM
npm i plus-websocket --save
import socket from 'plus-websocket'
直接下载
// 以下路径需根据项目实际情况填写
import socket from '../../js/plus-websocket/index.js'
API
详细用法可参考 uni-app文档
- socket.connectSocket(OBJECT)
- SocketTask.onMessage(CALLBACK)
- SocketTask.send(OBJECT)
- SocketTask.close(OBJECT)
- SocketTask.onOpen(CALLBACK)
- SocketTask.onClose(CALLBACK)
- SocketTask.onError(CALLBACK)
- socket.onSocketOpen(CALLBACK)
- socket.onSocketError(CALLBACK)
- socket.sendSocketMessage(OBJECT)
- socket.onSocketMessage(CALLBACK)
- socket.closeSocket(OBJECT)
- socket.onSocketClose(CALLBACK)
注意事项
当在 uni-app 中使用时也可用当前 API 替换 uni-app 内置的 websocket API
// main.js
import socket from 'plus-websocket'
// #ifdef APP-PLUS
Object.assign(uni, socket)
// #endif