百城推送
UniappSDK
更新时间:2021-07-27 22:00:00

为了方便开发者快速接入,百城推送推出了适用于 UNIAPP 开发的IOS、Android、H5、微信小程序、支付宝小程序、百度小程序、字节跳动小程序、QQ小程序、360小程序、快应用等项目的 UniappSDK。

SDK & DEMO

下载UniappSDK 下载DEMO

引入SDK

可以通过在 main.js 中引入,然后挂载到 Vue.prototype 上,示例如下:

import XBCIM from 'plugins/xbcim_sdk_1.0.0.min.js'
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 回调,回调会返回接收到的消息数据。