相信很多做开发的朋友,都或多或少遇到过类似聊天功能的需求,今天小编就给搭建推荐一款超好用的消息推送工具-百城推送。
百城推送是一款通用于所有脚本语言,兼容于支持WebSocket所有客户端专业推送服务,具有如下优势:
- 零储存:平台不会储存您的任何推送消息,我们专注于提供通讯能力
- 安全可靠:一线服务商提供安全、可靠的计算和数据处理能力
- 自主开放:自定义数据包,轻松实现文字、表情、图片、位置、语音等功能
- 平台兼容:平台基于WebSocket,支持所有WebSocket的语言和客户端
- 多端同步:同一账号,多端登录时,信息自动同步,方便您快速高效沟通
- 快速高效:程序仅需对接服务端授权接口,大大降低您的学习和开发成本
快速体验
H5版
对接步骤
第一步:注册/登录(使用邮箱进行账号注册,注册成功后请妥善保管您的appKey和appSecret)
第二步:获取授权码(服务端通过API获取授权码)
第三步:客户端使用(客户端通过后端获取的授权码进行Socket连接,此连接应为全局连接)
第四步:发送/接收消息(通过具体应用场景,使用WebSocket进行消息的发送和接收,并进行消息的保存)
第五步:关闭连接(退出应用时,关闭Socket链接)
SDK
1、初始化SDK
var xbcim = XBCIM.init(token);
1、参数 token 为连接授权码,需要通过平台注册账号的 appKey 等参数进行获取,具体方法请参考 获取授权码。
2、参数可以直接传递 token 字符串,也可以传入 json 格式,如 { token: token }。
3、初始化时,默认就会创建WebSocket链接。
2、监听初始化成功
xbcim.onsuccess(callback);
callback回调,可以在里面进行连接成功后的其他逻辑操作。
3、监听错误
xbcim.onerror(callback);
1、onerror 会监听初始化失败、token 校验等错误回调。
2、callback回调,可以在里面进行连接成功后的其他逻辑操作。
4、监听连接是否断开
xbcim.onclose(callback);
callback回调,可以在里面进行连接断开后的其他逻辑操作。
5、手动断开连接
xbcim.close(callback);
callback回调,可以在里面进行连接断开后的其他逻辑操作。
6、重新连接
xbcim.reconnect();
7、发送单聊
xbcim.sendSingle(data);
data 为要发送的消息数据,其具体参数及含义如下:
| 参数 | 描述 |
|---|---|
| type | 消息类型,默认文本,支持其他自定义消息类型 |
| source | 消息发送者ID |
| target | 消息接收者ID |
| content | 消息内容,字符串 |
| extra | 额外数据,支持任意格式 |
8、发送群聊
xbcim.sendGroup(data);
data 为要发送的消息数据,其具体参数及含义如下:
| 参数 | 描述 |
|---|---|
| type | 消息类型,默认文本,支持其他自定义消息类型 |
| source | 消息发送者ID |
| target | 群ID |
| content | 消息内容,字符串 |
| extra | 额外数据,支持任意格式 |
9、接收消息
xbcim.onmessage(callback);
callback 回调,回调会返回接收到的消息数据。