关于融云在APIcloud中的集成

个人理解的简单的即时通讯的实现流程 1、A做出发送消息给B的动作 2、B收到A发来的消息 3、通过聊天的窗口显示出来 下面的步骤可以省略 4、B返回A一个已经查看的消息 5、A收到B已经查看的消息通过聊天的窗口显示出来

实现这个流程的基础要素 1、AB双方的融云模块都应经打开，并且网络连接没有问题。 2、AB双方都已经是融云的用户，取得融云的token。 3、连接融云的服务器 在程序中的操作如下： 服务端：配置获取融云token的程序 客户端： 1、配置融云的参数 在 config.xml 中设置内容如下：

<feature name="rongCloud2"> <param name="appKey" value="此处填写 App Key 值" /> </feature>

2、对融云进行初始化 init(callback(ret, err))

var rong = api.require('rongCloud2'); rong.init(function(ret, err){ if (ret.status == 'error') api.toast({ msg: err.code }); });

返回值的代码如下

{ status: 'success', // 状态码：success / error } //错误的返回码 { code: -10002 // 错误码 }

3、监听连接状态 setConnectionStatusListener(callback(ret, err))

var rong = api.require('rongCloud2'); // 之前调用 init 的代码省略 rong.setConnectionStatusListener(function(ret, err){ api.toast({ msg: ret.result.connectionStatus }); }); // 之后调用 connect 的代码省略

返回值如下

{ result: { connectionStatus: 'CONNECTED' // 连接状态 //取值范围 //CONNECTED // 连接成功 //CONNECTING // 连接中 //DISCONNECTED // 断开连接 //KICKED // 用户账户在其他设备登录，本机会被踢掉线 //NETWORK_UNAVAILABLE // 网络不可用 //SERVER_INVALID // 服务器异常或无法连接 //TOKEN_INCORRECT // Token 不正确 } }

4、监听所有消息（根据文档规定是在connect之前调用） 所有接收到的消息、通知、状态都经由此处设置的监听器处理。包括私聊消息、讨论组消息、群组消息、聊天室消息以及各种其他消息、通知、状态等 setOnReceiveMessageListener(callback(ret, err))

var rong = api.require('rongCloud2'); // 之前调用 init 的代码省略 rong.setOnReceiveMessageListener(function (ret, err) { api.toast({ msg: JSON.stringify(ret.result.message) }); api.toast({ msg: ret.result.message.left }); }) // 之后调用 connect 的代码省略

返回值特别注意下

{ result: { message: { content: { text: 'Hello world!', extra: '' }, // 消息内容 conversationType: 'PRIVATE', // 参见 会话类型 枚举 messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE targetId: '55', // 这里对应消息发送者的 userId objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息 sentStatus: 'SENDING', // 发送状态：SENDING, SENT 或 FAILED senderUserId: '55', // 发送者 userId messageId: 608, // 本地消息 Id sentTime: 1418971531533, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数 receivedTime: 0 // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数 }, left: 0 // 剩余未拉取的消息数目 } }

5、连接融云 IM 服务器 connect({params}, callback(ret, err))

这里就需要传递参数了，参数只有一个token，用于服务器识别当前登录的账号，并返回账号的ID

var rong = api.require('rongCloud2'); rong.init(function(ret, err){ if (ret.status == 'error') api.toast({ msg: err.code }); }); rong.connect({ token: 'ThptTWyiPPPvZHvuSiuri82yq+hfEluLjZ78E1qo4hEVSFQNpqdoPu406urMWKN4Z3/olWR+v9JVLAwfOQoLrA=="}, function(ret, err){ if (ret.status == 'success') api.toast({ msg: ret.result.userId }); });

返回值

{ status: 'success', // 状态码：success / error result: { userId: '9527' // 当前登录的用户 Id } }

集成到这里，通过写死一个发送的函数。固定发送给用户B，这是登录用户B的手机就会收到发送的消息。可以通过打印出来观摩一下。至此融云的集成基本完成一半了。 接下来我会写一下怎么把接收到的数据展示到聊天界面。