融云聊天--web SDK API

因为产品需求，需要有聊天功能，客服功能。用的是融云的，他把什么方法都集成好了，用起来很方便。并且是免费的。但是第一次接触，并不是那么顺利，并且在网上搜不到相关核心资料，只能硬着头皮看文档，实在没办法就去融云提交工单。深知做前端第一次接触融云不不易，所以我在这梳理一下融云的相关方法。方便和我一样找不着头绪的前端使用。
1.聊天室的样式（包括消息的气泡）是你自己定义的。融云不提供样式的选择。这样的好处是，方便使用者创建属于自己的聊天样式。这么解释是因为我一开始以为样式不用自己写。
进入正题：
1.引入融云相关ＪＳ文档，这个不难理解。我建议一定要引最新版本。

        <scriptsrc="http://res.websdk.rongcloud.cn/RongIMClient.emo  ji-0.9.2.min.js">
</script>

2.在初次加载融云中我们所要做的事情：

        RongIMClient.init(APPKEY)//这是初始化，需要填参数就是你的APPKEY。这个不难理解。

3.获取融云的token,这个就不贴代码了，官方文档说的很清楚。
4.现在有了融云的token,就该链接融云的服务器了。

        RongIMClient.connect(token,
         {
              onSuccess: function(userId) {

              console.log("Login successfully." + userId);
        },
        onTokenIncorrect: function() {
          console.log('token无效');
        },
        onError:function(errorCode){
              var info = '';
              switch (errorCode) {
                case RongIMLib.ErrorCode.TIMEOUT:
                  info = '超时';
                  break;
                case RongIMLib.ErrorCode.UNKNOWN_ERROR:
                  info = '未知错误';
                  break;
                case RongIMLib.ErrorCode.UNACCEPTABLE_PaROTOCOL_VERSION:
                  info = '不可接受的协议版本';
                  break;
                case RongIMLib.ErrorCode.IDENTIFIER_REJECTED:
                  info = 'appkey不正确';
                  break;
                case RongIMLib.ErrorCode.SERVER_UNAVAILABLE:
                  info = '服务器不可用';
                  break;
              }
              console.log(errorCode);
            }
      });

5.设置消息监听器

// 设置连接监听状态 （ status 标识当前连接状态）
 // 连接状态监听器
 RongIMClient.setConnectionStatusListener({
    onChanged: function (status) {
        switch (status) {
            //链接成功
            case RongIMLib.ConnectionStatus.CONNECTED:
                console.log('链接成功');
                break;
            //正在链接
            case RongIMLib.ConnectionStatus.CONNECTING:
                console.log('正在链接');
                break;
            //重新链接
            case RongIMLib.ConnectionStatus.DISCONNECTED:
                console.log('断开连接');
                break;
            //其他设备登陆
            case RongIMLib.ConnectionStatus.KICKED_OFFLINE_BY_OTHER_CLIENT:
                console.log('其他设备登陆');
                break;
              //网络不可用
            case RongIMLib.ConnectionStatus.NETWORK_UNAVAILABLE:
              console.log('网络不可用');
              break;
            }
    }});

 // 消息监听器
 RongIMClient.setOnReceiveMessageListener({
    // 接收到的消息
    onReceived: function (message) {
        // 判断消息类型
        switch(message.messageType){
            case RongIMClient.MessageType.TextMessage:
                   console.log(message.content.content);
                //发送的消息内容将会被打印
                break;
            case RongIMClient.MessageType.ImageMessage:
                // do something...
                break;
            case RongIMClient.MessageType.DiscussionNotificationMessage:
                // do something...
                break;
            case RongIMClient.MessageType.LocationMessage:
                // do something...
                break;
            case RongIMClient.MessageType.RichContentMessage:
                // do something...
                break;
            case RongIMClient.MessageType.DiscussionNotificationMessage:
                // do something...
                break;
            case RongIMClient.MessageType.InformationNotificationMessage:
                // do something...
                break;
            case RongIMClient.MessageType.ContactNotificationMessage:
                // do something...
                break;
            case RongIMClient.MessageType.ProfileNotificationMessage:
                // do something...
                break;
            case RongIMClient.MessageType.CommandNotificationMessage:
                // do something...
                break;
            case RongIMClient.MessageType.CommandMessage:
                // do something...
                break;
            case RongIMClient.MessageType.UnknownMessage:
                // do something...
                break;
            default:
                // 自定义消息
                // do something...
        }
    }
});

6.这样我们跟融云链接的差不多了。接下来我们就可以开始做发送消息。前提是你的聊天室的样式已将写好。

// 定义消息类型,文字消息使用 RongIMLib.TextMessage
 var msg = new RongIMLib.TextMessage({content:"hello",extra:"附加信息"});
 //或者使用RongIMLib.TextMessage.obtain 方法.具体使用请参见文档
 //var msg = RongIMLib.TextMessage.obtain("hello");
 var conversationtype = RongIMLib.ConversationType.PRIVATE; // 私聊
 var targetId = "xxx"; // 目标 Id
 RongIMClient.getInstance().sendMessage(conversationtype, targetId, msg, {
                // 发送消息成功
                onSuccess: function (message) {
                    //message 为发送的消息对象并且包含服务器返回的消息唯一Id和发送消息时间戳
                    console.log("Send successfully");
                },
                onError: function (errorCode,message) {
                    var info = '';
                    switch (errorCode) {
                        case RongIMLib.ErrorCode.TIMEOUT:
                            info = '超时';
                            break;
                        case RongIMLib.ErrorCode.UNKNOWN_ERROR:
                            info = '未知错误';
                            break;
                        case RongIMLib.ErrorCode.REJECTED_BY_BLACKLIST:
                            info = '在黑名单中，无法向对方发送消息';
                            break;
                        case RongIMLib.ErrorCode.NOT_IN_DISCUSSION:
                            info = '不在讨论组中';
                            break;
                        case RongIMLib.ErrorCode.NOT_IN_GROUP:
                            info = '不在群组中';
                            break;
                        case RongIMLib.ErrorCode.NOT_IN_CHATROOM:
                            info = '不在聊天室中';
                            break;
                        default :
                            info = x;
                            break;
                    }
                    console.log('发送失败:' + info);
                }
            }
        );

这里需要注意的是，你的聊天类型；是私聊，群组要定义清楚
还有自定义消息：比如在群组聊天中，谁点了一个赞，我要在聊天室中显示：XXX点了一个赞。这时候就用到了自定义消息。

RongIMClient.registerMessageType('messageType','objectName','messageTag','message|[]')
自定义消息注册位置: RongIMClient.init("appkey") 之后的第一行位置注册即可。

7.我说一个我遇到的Bug：在前端点赞，视频的点赞数量要+1，原生规定要传一个“fav”(这个fav是自定义的)，并且类型是：TextMessage。将之放到extra中，但是我一开始放不进去。后来在控制台打印，他有一个方法:setSxtra()方法。最后就把”fav”给放进去了。

 var fav=RongIMClient.TextMessage.obtain("1");
        console.log(fav);
        fav.setExtra('fav');
        console.log(fav.getExtra());

8.言归正传，这时候你已经把消息发送，推送给了融云，这时候再去融云消息监测方法那找你推送的消息，并且把它显示在你写好的聊天框中，就OK了。
9.想要获取历史聊天记录怎么办？不怕，有方法：

//getHistoryMessages
 RongIMClient.getInstance().getHistoryMessages(RongIMLib.ConversationType.PRIVATE, 'targetId', null, 20, {
          onSuccess: function(list, hasMsg) {
            // hasMsg为boolean值，如果为true则表示还有剩余历史消息可拉取，为false的话表示没有剩余历史消息可供拉取。
               // list 为拉取到的历史消息列表
          },
          onError: function(error) {
              // APP未开启消息漫游或处理异常
                   // throw new ERROR ......
          }
        });

写到这里，我们一个聊天室的基本需求功能已将实现。有一个表情我没有介绍到，等下次更新吧。
最后，希望可以帮到大家。有什么问题可以在下边留言，我看到会回复 ，大家一块成长！
发现一个问题就是，我是整理近期问题才会来csdn更新博客，所以导致好多小伙伴私信我的问题，我都是过了好久才看到，
有不明白的地方，可以微博找我。
微博：璐飞童鞋。关注之后，私信即可。