为了方便开发者快速接入,百城推送推出了适用于 UNIAPP 开发的IOS、Android、H5、微信小程序、支付宝小程序、百度小程序、字节跳动小程序、QQ小程序、360小程序、快应用等项目的 UniappSDK。
SDK & DEMO
引入SDK
可以通过在 main.js 中引入,然后挂载到 Vue.prototype 上,示例如下:
import XBCIM from 'plugins/xbcim_sdk_1.0.0.min.js'
Vue.prototype.$xbcim = XBCIM
Vue.prototype.$xbcim = XBCIM
初始化SDK
this.$xbcim.init(token)
1、参数 token 为连接授权码,需要通过平台注册账号的 appKey 等参数进行获取,具体方法请参考 获取授权码。
2、参数可以直接传递 token 字符串,也可以传入 json 格式,如 { token: token }。
3、初始化时,默认就会创建WebSocket链接。
监听初始化成功
this.$xbcim.onsuccess(callback)
callback回调,可以在里面进行连接成功后的其他逻辑操作。
监听错误
this.$xbcim.onerror(callback);
1、onerror 会监听初始化失败、token 校验等错误回调。
2、callback回调,可以在里面进行连接成功后的其他逻辑操作。
监听连接是否断开
this.$xbcim.onclose(callback);
callback回调,可以在里面进行连接断开后的其他逻辑操作。
手动断开连接
this.$xbcim.close(callback);
callback回调,可以在里面进行连接断开后的其他逻辑操作。
重新连接
this.$xbcim.reconnect();
发送单聊
this.$xbcim.sendSingle(data);
data 为要发送的消息数据,其具体参数及含义如下:
参数 | 描述 |
---|---|
msgType | 消息类型,默认文本,支持其他自定义消息类型 |
source | 消息发送者ID |
target | 消息接收者ID |
content | 消息内容,字符串 |
extra | 额外数据,支持任意格式 |
创建(加入)群聊
this.$xbcim.addGroup(data);
data 为JSON格式,其具体参数及含义如下:
参数 | 描述 |
---|---|
target | 群ID |
extra | 成员ID,数组格式,需要注意的是:如果群为新群时,需要将自己的ID也加入到成员里面 |
退出群聊
this.$xbcim.quitGroup(data);
data 为JSON格式,其具体参数及含义如下:
参数 | 描述 |
---|---|
target | 群ID |
extra | 成员ID,数组格式 |
删除群聊
this.$xbcim.delGroup(data);
data 为JSON格式,其具体参数及含义如下:
参数 | 描述 |
---|---|
target | 群ID |
发送群聊
this.$xbcim.sendGroup(data);
data 为要发送的消息数据,其具体参数及含义如下:
参数 | 描述 |
---|---|
msgType | 消息类型,默认文本,支持其他自定义消息类型 |
source | 消息发送者ID |
target | 群ID |
content | 消息内容,字符串 |
extra | 额外数据,支持任意格式 |
接收消息
this.$xbcim.onmessage(callback);
callback 回调,回调会返回接收到的消息数据。