uexRongCloud查看3.0文档

1、简介

uexRongCloud(融云IM)插件

1.1、 说明

融云是国内首家专业的即时通讯云服务提供商,专注为互联网、移动互联网开发者提供免费的即时通讯基础能力和云端服务。通过融云平台,开发者不必搭建服务端硬件环境,就可以将即时通讯、实时网络能力快速集成至应用中。融云SDK包括两部分:IM界面组件和 IM通讯能力库。

本插件封装的是IM通讯能力库-IMLib,IMLib 是不含界面的基础 IM 通讯能力库,封装了通信能力和会话、消息等对象。

使用前说明:

该插件需要引擎3.3以上版本

本插件为单例插件 ——

  • 在任何网页调用本插件,调用的是同一个插件实例;
  • 所有的API都是异步方法,不会直接返回值;
  • 所有的回调都会传到root页面(config.xml中配置的App起始页面)

以上内容非常重要

root页面收到回调后,可以通过uexWindow的相关方法传递到各个网页去, 以下方法是您可能要用到的——

 传递给某个窗口:
* uexWindow.evaluateScript;
* uexWindow.evaluatePopoverScript
* uexWindow.evaluateMultiPopoverScript

 传递给某些窗口:
* uexWindow.publishChannelNotification
* uexWindow.subscribeChannelNotification

这些方法具体用法在uexWindow文档 内有描述,当然,也可下载Demo 参考Demo内的调用。

1.2、 UI展示

暂无

1.3、 开源源码

插件测试用例与自定义插件下载:点击此处 (插件测试用例与插件源码已经提供)

参考4.0规范测试用例:点击下载

1.4、 术语表

Path Types

协议头 Android对应路径 (其中"/sdcard/"等 同于"/storage/emulated/0/") iOS对应路径
res:// widget/wgtRes/ widget/wgtRes
wgts:// /storage/emulated/0/widgetone/apps/ xxx(widgetAppId)/ /Documents/apps/xxx(widgetAppId)/
wgts:// /storage/emulated/0/widgetone/widgets/ /Documents/widgets/
file:///sdcard/ /storage/emulated/0/
1.5、平台版本支持

本插件的所有API默认支持Android4.0+iOS7.0+操作系统.
有特殊版本要求的API会在文档中额外说明.

1.6、接口有效性

本插件所有API默认在插件版本4.0.0+可用.
在后续版本中新添加的接口会在文档中额外说明.

2、API概述

使用该插件需要先在融云官网申请AppKey。 注意:Android 版本的AppKey需要在config.xml中配置,把value对应的值替换成自己的AppKey即可。示例如下:

<config desc="uexRongCloud" type="KEY">
    <param name="$uexRongCloud_APPKEY$" platform="Android" value="e5t4ouvptdhca"/>
</config>
2.1、初始化

init //初始化融云sdk

uexRongCloud.init(param,callback)

说明:

初始化融云sdk。 注意:Android 版本的AppKey需要在config.xml中配置,把value对应的值替换成自己的AppKey即可。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var param = {
    appKey:   
};
参数名称 参数类型 是否必选 说明
appKey String 融云官网申请的appKey

回调参数:

var callback = function (error,data){}
参数名称 类型 说明
error Number 0表示成功,非0表示失败
data String 失败时返回相关的原因

示例:

var param = {
      appKey:'bmdehs6pdprts'
  };
uexRongCloud.init(param,function(error,data){
    if(!error){
    alert("初始化成功")!
  }
});
2.2、登录与登出

写在前面:在您连接融云服务器之前,您需要请求您的 App Server,您的 App Server通过Server API 获取 Token 并返回给您的客户端,客户端获取到这个 Token 即可进入下一步连接融云服务器。可参考其官方文档

connect //与融云服务器建立连接

uexRongCloud.connect(param,callback)

说明:

与融云服务器建立连接。

注意:在App整个生命周期,您只需要调用一次此方法与融云服务器建立连接。之后无论是网络出现异常或者App有前后台的切换等,SDK都会负责自动重连。除非您已经手动将连接断开,否则您不需要自己再手动重连。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var param = {
    token:
};
参数名称 参数类型 是否必选 说明
token String 从您服务器端获取的token(用户身份令牌)

回调参数:

var callback = function (error,data){}
参数名称 类型 说明
error Number 0表示成功,非0表示失败
data String 失败时返回相关的原因, 成功返回userId

示例:

var param = {
      token:'g3fqLjRWtJdOkUCd+uqMRFYLsaBj7tK6QZ9/KFrx+0H22Ki0yw2VryZSnIEN2vTPv9T56shgMwGSAC9SfCY27A=='
  };
uexRongCloud.connect(param,function(error,data){
     if(!error){
         alert("userId为:"+data)!
    }
});
disconnect //断开与融云服务器建立连接

uexRongCloud.disconnect(param)

说明:

断开与融云服务器建立连接。

注意:因为SDK在前后台切换或者网络出现异常都会自动重连,会保证连接的可靠性。 所以除非您的App逻辑需要登出,否则一般不需要调用此方法进行手动断开。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
var param = {
    isReceivePush:
};
参数名称 参数类型 是否必选 说明
isReceivePush Boolean 断开与融云服务器的连接之后,是否还接收远程推送。true:接收,false:不接收

示例:

var param = {
      isReceivePush:false
  };
uexRongCloud.disconnect(param);
2.3、基础消息功能

写在前面:群组关系和群组列表由您的 App 维护,客户端的所有群组操作都需要请求您的 App Server, 您的 App Server 可以根据自己的逻辑进行管理和控制,然后通过 Server API 接口进行群组操作,并将结果返回给客户端。可参考其官方文档

sendMessage //发送消息

uexRongCloud.sendMessage(param,callback)

说明:

发送消息,包括文字消息、语音消息、图片消息、图文消息、位置消息、命令消息,并根据objectName字段区分。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var param = {

    ---公共参数---
    objectName:,
    conversationType:,
    targetId:,
    extra:,


     ---私有参数---
    //objectName 为"RC:TxtMsg"时(文字消息) 需要传以下参数
    text:,

    //objectName 为"RC:VcMsg"时(语音消息) 需要传以下参数
    voicePath:,  
    duration:,

    //objectName 为"RC:ImgMsg"时(图片消息) 需要传以下参数
    imgPath:, 

    //objectName 为"RC:ImgTextMsg"时(图文消息) 需要传以下参数
    title:, 
    description:, 
    imgPath:, 
    url: 

    //objectName 为"RC:LBSMsg"时(位置消息) 需要传以下参数
    latitude:, 
    longitude:, 
    poi:, 
    imgPath:, 

    //objectName 为"RC:CmdNtf"时(命令消息) 需要传以下参数
    name:, 
    data:, 

};
参数名称 参数类型 是否必选 说明
objectName String 消息类型, "RC:TxtMsg":文字消息;"RC:VcMsg":语音消息;"RC:ImgMsg":图片消息;"RC:ImgTextMsg":图文消息;"RC:LBSMsg":位置消息;"RC:CmdMsg":命令消息
conversationType String 会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统
targetId String 消息的接收方Id。根据不同的 conversationType,可能是用户Id、讨论组Id、群组Id或聊天室Id等
extra String 消息的附加字段

objectName 为"RC:TxtMsg"时(文字消息) 需要传以下参数:

参数名称 参数类型 是否必选 说明
text String 消息的文字内容

objectName 为"RC:VcMsg"时(语音消息) 需要传以下参数:

参数名称 参数类型 是否必选 说明
voicePath String 语音文件的路径
duration Number 语音消息的时长,单位为秒

objectName 为"RC:ImgMsg"时(图片消息) 需要传以下参数:

参数名称 参数类型 是否必选 说明
imgPath String 图片的本地路径

objectName 为"RC:ImgTextMsg"时(图文消息) 需要传以下参数:

参数名称 参数类型 是否必选 说明
title String 消息的标题
description String 消息的内容描述
imgPath String 发送图片的网络路径
url String 图文消息中包含的需要跳转到的URL

objectName 为"RC:LBSMsg"时(位置消息) 需要传以下参数:

参数名称 参数类型 是否必选 说明
latitude String 纬度
longitude String 经度
poi String 地理位置的名称
imgPath String 地图略缩图的路径

objectName 为"RC:CmdMsg"时(命令消息) 需要传以下参数:

参数名称 参数类型 是否必选 说明
name String 命令的名称
data String 命令的数据

回调参数:

var callback=function (status,messageId){}
参数名称 类型 说明
status Number 发送结果 0:准备发送 1.发送成功, 2:发送失败
messageId String 发送消息的ID

示例:


var param = {
    objectName: "RC:ImgMsg",//发图片消息
    conversationType: "PRIVATE",
    targetId: "55666",
    extra: "extra info ...",  
    imgPath: 'res://img.png' //图片的本地路径
  };
  uexRongCloud.sendMessage(param,function(status,messageId){
     if(status==0){
         alert("准备发送 messageId: " + messageId);
     }else if(status==1){
         alert("发送成功 messageId: " + messageId);
     }else{
       alert("发送失败 messageId: " + messageId);
     }
  }); 

    或  

    var param = {
    objectName: "RC:TxtMsg",//发文字消息
    conversationType: "PRIVATE",
    targetId: "55666",
    extra: "extra info ...", 
    text: "text content ...", //消息的文字内容
  };
  uexRongCloud.sendMessage(param,function(status,messageId){
     if(status==0){
         alert("准备发送 messageId: " + messageId);
     }else if(status==1){
         alert("发送成功 messageId: " + messageId);
     }else{
       alert("发送失败 messageId: " + messageId);
     }
  });
onMessageReceived //发送消息的回调

uexRongCloud.onMessageReceived(result)

说明:

发送消息的回调。

参数:

参数名称 参数类型 是否必选 说明
result Object 形式见下:
var result = {
    message:
        {
            content: { //格式见:message -> content字段, 如:文字消息内容
                text: ,
                extra:
            }, 
            conversationType: , 
            messageDirection:, 
            targetId: ,
            objectName:, 
            sentStatus:, 
            senderUserId:, 
            messageId:, 
            sentTime:, 
            receivedTime: 
        },
        left:  
}
参数名称 参数类型 是否必选 说明
content JSON对象 消息内容,格式见:message -> content字段
conversationType String 会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统
messageDirection JSON对象 String 消息方向,发送:SEND 接收:RECEIVE
targetId String 对应消息发送者的 userId
objectName String 消息类型, "RC:TxtMsg":文字消息;"RC:VcMsg":语音消息;"RC:ImgMsg":图片消息;"RC:ImgTextMsg":图文消息;"RC:LBSMsg":位置消息;"RC:CmdMsg":命令消息
sentStatus String 发送状态,DESTROYED:对方已销毁 ;FAILED:发送失败; READ:对方已读; RECEIVED:对方已接收; SENDING:发送中; SENT:已发送
senderUserId String 发送者userId
messageId Number 消息的ID,本地存储的消息的唯一值(数据库索引唯一值)
sentTime Number 发送消息的时间戳,从1970年1月1日0点0分0秒开始到现在的毫秒数
receivedTime Number 收到消息的时间戳,从1970年1月1日0点0分0秒开始到现在的毫秒数
left Number 剩余的未接收的消息数
message -> content字段
    //objectName 为"RC:TxtMsg"时(文字消息)
    text:,//消息的文字内容
    extra:,//消息的附加字段

    //objectName 为"RC:VcMsg"时(语音消息) 
    voicePath:,//语音文件的路径  
    duration:,//Number类型 语音消息的时长,单位为秒
    extra:,//消息的附加字段


    //objectName 为"RC:ImgMsg"时(图片消息) 
    imgPath:,//图片的本地路径  
    thumbPath:,//缩略图
    extra:,//消息的附加字段

    //objectName 为"RC:ImgTextMsg"时(图文消息) 
    title:,//消息的标题
    description:,//消息的内容描述
    imgPath:,//图文消息图片URL
    url://图文消息中包含的需要跳转到的URL 
    extra:,//消息的附加字段

    //objectName 为"RC:LBSMsg"时(位置消息) 
    latitude:,//维度
    longitude:,//经度
    poi:,//地理位置的名称
    imgPath:,//地图略缩图的路径
    extra:,//消息的附加字段


    //objectName 为"RC:CmdNtf"时(命令消息) 
    name:,//命令的名称
    data:,//命令的数据

示例:

window.uexOnload = function() {
   uexRongCloud.onMessageReceived = onMessageReceived;
};
function onMessageReceived(info) {
  alert('onMessageReceived: ' + JSON.stringify(info));
}
2.4、会话功能

getConversationList //获取会话列表

var result = getConversationList();

说明:

获取会话列表,同步返回。

参数

返回值

返回值result为json字符串,各字段如下所示:

var result = {
    resultCode:,// Number  0 返回成功,其他为失败
    conversations:[
        {
            conversationTitle:, 
            conversationType:, 
            draft:, 
            targetId:, 
            latestMessage: { //objectName 为"RC:TxtMsg"时(文字消息)
                text:,
                extra:
            }, // 最后一条消息的内容,格式和onMessageReceived的message -> content字段相同
            sentStatus:, 
            objectName:, 
            receivedStatus: , 
            senderUserId:, 
            unreadMessageCount:, 
            receivedTime:, 
            sentTime:
            isTop:,  
            latestMessageId:
        }
        ....
    ]
}
参数名称 参数类型 是否必选 说明
resultCode Number 0为返回成功,其他为失败
conversationTitle String 会话的标题
draft String 文字消息草稿的内容
targetId String 目标会话ID
latestMessage JSON对象 最后一条消息的内容,格式和onMessageReceived的message -> content字段相同
sentStatus String 发送状态:DESTROYED:对方已销毁 ;FAILED:发送失败; READ:对方已读; RECEIVED:对方已接收; SENDING:发送中; SENT:已发送;
objectName String 会话中最后一条消息的类型, "RC:TxtMsg":文字消息;"RC:VcMsg":语音消息;"RC:ImgMsg":图片消息;"RC:ImgTextMsg":图文消息;"RC:LBSMsg":位置消息;"RC:CmdMsg":命令消息
receivedStatus String 会话中最后一条消息的接收状态,"UNREAD":未读;"READ":已读;"LISTENED":已听,仅用于语音消息;"DOWNLOADED":已下载
senderUserId String 会话中最后一条消息的发送者用户ID
unreadMessageCount Number 本会话的未读消息数
receivedTime Number 会话中最后一条消息的接收时间,从1970年1月1日0点0分0秒开始到现在的毫秒数
sentTime Number 会话中最后一条消息的发送时间,从1970年1月1日0点0分0秒开始到现在的毫秒数
isTop bool 是否置顶,true为置顶,false为不置顶
latestMessageId Number 会话中最后一条消息的消息ID

示例:

var result = uexRongCloud.getConversationList();
  alert(result);
getConversation //获取某一会话信息

var result = uexRongCloud.getConversation(param);

说明:

获取某一会话信息,同步返回。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
var param = {
     conversationType:,//消息的会话类型
     targetId:,//目标会话ID
}

返回值

var result = uexRongCloud.getConversation(param);

返回值result为json字符串,字段如下所示:

var result = {
    resultCode:,//Number, 0为返回成功,其他为失败
    conversationTitle:, // String,会话标题
    conversationType:, // String,会话类型
    draft:, // String,文字消息草稿的内容
    targetId:, // String,消息目标 Id
    latestMessage: {
    }, //JSON对象,消息的内容,格式和onMessageReceived的message -> content字段相同
    sentStatus:, //String, 发送状态:DESTROYED:对方已销毁 ;FAILED:发送失败; READ:对方已读; RECEIVED:对方已接收; SENDING:发送中; SENT:已发送;
    objectName:, // String,消息的类型, "RC:TxtMsg":文字消息;"RC:VcMsg":语音消息;"RC:ImgMsg":图片消息;"RC:ImgTextMsg":图文消息;"RC:LBSMsg":位置消息;"RC:CmdMsg":命令消息  
    recievedStatus: , //String,消息的接收状态,"UNREAD":未读;"READ":已读;"LISTENED":已听,仅用于语音消息;"DOWNLOADED":已下载
    senderUserId: , // String,消息的发送者用户ID
    unreadMessageCount: , //Number,本会话的未读消息数
    receivedTime: , //Number, 消息的接收时间,从1970年1月1日0点0分0秒开始到现在的毫秒数
    sentTime: , //Number, 消息的发送时间,从1970年1月1日0点0分0秒开始到现在的毫秒数
    isTop:, //bool,是否置顶,true为置顶,false为不置顶
    latestMessageId: // Number,消息ID
}

示例:

var params = {
    conversationType: "PRIVATE",
    targetId: "55666"
  };
  var data = JSON.stringify(params);
  var result = uexRongCloud.getConversation(data);
  alert(result);
removeConversation //从会话列表中移除某一会话

uexRongCloud.removeConversation(param,callback);

说明:

从会话列表中移除某一会话,但是不删除会话内的消息。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var params={
    conversationType:,//消息的会话类型
    targetId:,//消息目标 Id
}
参数名称 参数类型 是否必选 说明
conversationType String 会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统
targetId String 消息目标 Id

回调参数

var callback=function(error,data){}
参数名称 类型 说明
error Number 0表示成功,非0表示失败
data String 失败时返回相关的原因

示例:

var param = {
    conversationType: "PRIVATE",
    targetId: "55666"
  };
  uexRongCloud.removeConversation(param,function(error, data){
     if(!error){
         alert("移除会话成功");
     }
  });
clearConversations //清空所有会话及会话消息

uexRongCloud.clearConversations(param,callback);

说明:

清空所有会话及会话消息。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var params={
    conversationTypes:
}
参数名称 参数类型 是否必选 说明
conversationTypes Array 消息的会话类型数组,内部元素由conversationType构成 会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统

回调参数:

var callback = function (error,data){}
参数名称 类型 说明
error Number 0表示成功,非0表示失败
data String 失败时返回相关的原因

示例:

 var types = new Array();
 types[0] = "PRIVATE";
 var param = {
    conversationTypes: types
 };
 uexRongCloud.clearConversations(param,function(error, data){
     if(!error){
         alert("清空成功");
     }
 });
setConversationToTop //设置会话置顶

uexRongCloud.setConversationToTop(param,callback);

说明:

设置会话置顶。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var params={
    conversationType:,
    targetId:,
    isTop:
}
参数名称 参数类型 是否必选 说明
conversationType String 消息的会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统
targetId String 消息目标 Id
isTop bool true 或false 是否置顶

回调参数:

var callback = function(error,data){}
参数名称 类型 说明
error Number 0表示成功,非0表示失败
data String 失败时返回相关的原因

示例:

var param = {
    conversationType: "PRIVATE",
    targetId: "55666",
    isTop: true
  };
  uexRongCloud.setConversationToTop(param,function(error,data){
     if(!error){
         alert("置顶成功");
     }
  });
getConversationNotificationStatus //获取某一会话的通知状态

uexRongCloud.getConversationNotificationStatus(param,callback);

说明:

获取某一会话的通知状态。

参数

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var param={
    conversationType:,
    targetId:
}
参数名称 参数类型 是否必选 说明
conversationType String 消息的会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统
targetId String 消息目标 Id

回调参数:

var callback=function (error,data){}
参数名称 类型 说明
error Number 0表示成功,非0表示失败
data Number 状态码,0:免打扰 / 1:提醒

示例:

var param = {
    conversationType: "PRIVATE",
    targetId: "55666"
  };
  uexRongCloud.getConversationNotificationStatus(param,function (error, data) {
    if(!error){
       alert("获取某一会话的通知状态成功");
    }
});
setConversationNotificationStatus //设置某一会话的通知状态

uexRongCloud.setConversationNotificationStatus(param,callback);

说明:

设置某一会话的通知状态。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var param={
    conversationType:,
    targetId:,
    status:
}
参数名称 参数类型 是否必选 说明
conversationType String 消息的会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统
targetId String 消息目标 Id
status Number 状态码,0:免打扰 ;1:新消息提醒

回调参数:

var callback=function (error,data){}
参数名称 类型 说明
error Number 0表示成功,非0表示失败
data Number 状态码,0:免打扰 ;1:提醒

示例:

var param = {
    conversationType: "PRIVATE",
    targetId: "55666",
    status: 1
  };
  uexRongCloud.setConversationNotificationStatus(param, function (error, data) {
  if(!error){
       alert("设置某一会话的通知状态成功");
    }

});
getLatestMessages //获取某一会话的最新消息记录

uexRongCloud.getLatestMessages(param,callback);

说明:

获取某一会话的最新消息记录。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var params={
    conversationType:,//消息的会话类型
    targetId:,//消息目标 Id
    count:,//Number 要获取的消息数量
}
参数名称 参数类型 是否必选 说明
conversationType String 消息的会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统
targetId String 消息目标 Id
count Number 要获取的消息数量

回调参数:

var callback=function (error,data){}
参数名称 类型 说明
error Number 0表示成功,非0表示失败
data json对象 消息记录

data各字段如下:

var data = [
        {
            content: {
                text: ,
                extra: 
            }, // 消息内容,格式和onMessageReceived的message -> content字段相同
            extra:, // String,消息的附加信息,此信息只保存在本地
            conversationType:, //String,会话类型
            messageDirection:, //String 消息方向 发送:SEND  接收:RECEIVE
            targetId:, // String,这里对应消息发送者的 userId
            objectName:, //String, 消息类型 
            sentStatus:, // String, 发送状态:DESTROYED:对方已销毁 ;FAILED:发送失败; READ:对方已读; RECEIVED:对方已接收; SENDING:发送中; SENT:已发送;
            senderUserId:, // String,消息发送者 userId
            messageId:,// Number,消息 Id
            sentTime:,// Number,发送消息的时间戳,从1970年1月1日0点0分0秒开始到现在的毫秒数
            receivedTime: //Number, 收到消息的时间戳,从1970年1月1日0点0分0秒开始到现在的毫秒数
    }
    ...
]

示例:

var param = {
    conversationType: "PRIVATE",
    targetId: "55666",
    count: 20
  };
  uexRongCloud.getLatestMessages(param, function (error, data) {
    if(!error){
       alert(JSON.stringify(data));
    }
});
getHistoryMessages //获取某一会话的历史消息记录

uexRongCloud.getHistoryMessages(param,callback);

说明:

获取某一会话的历史消息记录。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var params={
    conversationType:,
    targetId:,
    count:,
    oldestMessageId:
}
参数名称 参数类型 是否必选 说明
conversationType String 消息的会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统
targetId String 消息目标 Id
count Number 要获取的消息数量
oldestMessageId Number 截止的消息ID,获取此消息之前的 count 条消息,没有消息第一次调用应设置为: -1。如:oldestMessageId为10,count为2,会返回messageId为9和8的消息列表

回调参数:

var callback = function (error,data){}
参数名称 类型 说明
error Number 0表示成功,非0表示失败
data Json对象 历史消息记录

data各字段如下:

var params=[
        {
            content: {
                text: ,
                extra: 
            }, // 消息内容,格式和onMessageReceived的message -> content字段相同
            extra:, // String,消息的附加信息,此信息只保存在本地
            conversationType:, //String,会话类型
            messageDirection:, //String, 消息方向 发送:SEND  接收:RECEIVE
            targetId:, //String, 这里对应消息发送者的 userId
            objectName:, //String, 消息类型 
            sentStatus:, //String, 发送状态:DESTROYED:对方已销毁 ;FAILED:发送失败; READ:对方已读; RECEIVED:对方已接收; SENDING:发送中; SENT:已发送;
            senderUserId:, // String,发送者 userId
            messageId:,//Number, 本地消息 Id
            sentTime:,// Number,发送消息的时间戳,从1970年1月1日0点0分0秒开始到现在的毫秒数
            receivedTime: //Number, 收到消息的时间戳,从1970年1月1日0点0分0秒开始到现在的毫秒数
        }
        ...
]

示例:

  var param = {
    conversationType: "PRIVATE",
    targetId: "55666",
    count: 2,
    oldestMessageId: 10
  };
  uexRongCloud.getHistoryMessages(param, function (error, data) {
     if(!error){
        alert(JSON.stringify(data));
     }
});
deleteMessages //删除消息

uexRongCloud.deleteMessages(param,callback);

说明:

删除消息。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var param = {
    messageIds:
}
参数名称 参数类型 是否必选 说明
messageIds Array 要删除的消息Id数组,内部元素由messageId构成

回调参数:

var callback = function (error,data){}
参数名称 类型 说明
error Number 0表示成功,非0表示失败
data String 失败时返回相关的原因

示例:

  var ids = new Array();
  ids[0]= 12;
  var param = {
   messageIds: ids
  };
  uexRongCloud.deleteMessages(param, function (error, data) {
   if(!error){
      alert("删除成功");
   }
});
clearMessages //清空某一会话的所有聊天消息记录

uexRongCloud.clearMessages(param,callback);

说明:

清空某一会话的所有聊天消息记录。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
callback Function 回调方法
var param = {
    conversationType:,
    targetId:
}
参数名称 参数类型 是否必选 说明
conversationType String 消息的会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统
targetId String 消息目标 Id

回调参数:

var callback = function (error,data){}
参数名称 类型 说明
error Number 0表示成功,非0表示失败
data String 失败时返回相关的原因

示例:

  var param = {
    conversationType: "PRIVATE",
    targetId: "55666"
  };
  uexRongCloud.clearMessages(param, function (error, data) {
     if(!error){
        alert("清空成功");
     }
});
getTotalUnreadCount //获取所有未读消息数

var count = uexRongCloud.getTotalUnreadCount();

说明:

获取所有未读消息数。

参数

返回值

参数名称 参数类型 是否必选 说明
count Number 所有的未读消息数

示例:

var count = uexRongCloud.getTotalUnreadCount();
alert(count);
getUnreadCount //获取来自某用户(某会话)的未读消息数

var count = uexRongCloud.getUnreadCount(param);

说明:

获取来自某用户(某会话)的未读消息数。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
var params={
    conversationType:,
    targetId:
}
参数名称 参数类型 是否必选 说明
conversationType String 消息的会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统
targetId String 消息目标 Id

返回值

参数名称 参数类型 是否必选 说明
count Number 返回来自某用户(某会话)的未读消息数

示例:

var param = {
    conversationType:"PRIVATE",
    targetId:"55666"
  };
  var count = uexRongCloud.getUnreadCount(param);
  alert(count);
getUnreadCountByConversationTypes //获取某(些)会话类型的未读消息数

var count = uexRongCloud.getUnreadCountByConversationTypes(param);

说明:

获取某(些)会话类型的未读消息数。支持同步返回

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
var param ={
    conversationTypes:,//消息的会话类型,是conversationType的数组
}
参数名称 参数类型 是否必选 说明
conversationTypes Array 消息的会话类型数组,由conversationType构成

返回值

参数名称 参数类型 是否必选 说明
count Number 返回某(些)会话类型的未读消息数

示例:

  var types = new Array();
    types[0]= "PRIVATE";
    var param = {
    conversationTypes: types
    };
    var count = uexRongCloud.getUnreadCountByConversationTypes(param);
    alert(count);
setMessageReceivedStatus //设置接收到的消息状态

uexRongCloud.setMessageReceivedStatus(param);

说明:

设置接收到的消息状态。

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
var param = {
    messageId:,
    receivedStatus:
}
参数名称 参数类型 是否必选 说明
messageId Number 消息的Id
receivedStatus String 消息的接收状态,"UNREAD":未读;"READ":已读;"LISTENED":已听,仅用于语音消息;"DOWNLOADED":已下载

示例:

  var param = {
    messageId: 12, 
    receivedStatus: "READ"
  };
  uexRongCloud.setMessageReceivedStatus(param);
clearMessagesUnreadStatus //清除某一会话的消息未读状态

uexRongCloud.clearMessagesUnreadStatus(param);

说明:

清除某一会话的消息未读状态,iOS不支持

参数:

参数名称 参数类型 是否必选 说明
param Object 接口所需数据,形式见下:
var param = {
    conversationType:,
    targetId:
}
参数名称 参数类型 是否必选 说明
conversationType String 消息的会话类型, 'PRIVATE':单聊 ;'DISCUSSION':讨论组 'GROUP':群组 ;'CHATROOM':聊天室 ;'CUSTOMER_SERVICE':客服 ;'SYSTEM':系统
targetId String 消息目标 Id

示例:

  var param = {
    conversationType: "PRIVATE",
    targetId: "55666"
  };
  uexRongCloud.clearMessagesUnreadStatus(param);

3、附录

建立连接返回的错误码
error 错误信息
30000 导航路由失败,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30001 连接已被释放, 建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30002 连接不可用,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30003 请求响应超时,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30004 导航HTTP发送失败,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30005 导航HTTP请求超时,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30006 导航HTTP接收失败,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30007 导航HTTP请求失败,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30008 导航HTTP返回数据格式错误,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30009 导航HTTP返回数据不可用,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30010 创建Socket连接失败,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30011 Socket断开,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30012 PING失败,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30013 PING超时,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
30014 信令发送失败,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
31000 连接ACK超时,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
31001 信令版本错误,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
31002 AppKey错误,请检查您使用的AppKey是否正确。
31003 服务器当前不可用(预留),建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
31004 Token无效,Token无效一般有以下两种原因。一是token错误,请您检查客户端初始化使用的AppKey和您服务器获取token使用的AppKey是否一致;二是token过期,是因为您在开发者后台设置了token过期时间,您需要请求您的服务器重新获取token并再次用新的token建立连接。
31005 AppKey与Token不匹配,请检查您使用的AppKey与Token是否正确,是否匹配。一般有以下两种原因。一是token错误,请您检查客户端初始化使用的AppKey和您服务器获取token使用的AppKey是否一致;二是token过期,是因为您在开发者后台设置了token过期时间,您需要请求您的服务器重新获取token并再次用新的token建立连接。
31006 连接重定向,建立连接的临时错误码,SDK会做好自动重连,开发者无须处理。
31007 BundleID不正确,请检查您App的BundleID是否正确。
31008 AppKey被封禁或已删除,请检查您使用的AppKey是否正确。
31009 用户被封禁,请检查您使用的Token是否正确,以及对应的UserId是否被封禁。
31010 当前用户在其他设备上登陆,此设备被踢下线
32001 信令数据无效,建立连接的临时状态,SDK会做好自动重连,开发者无须处理。
32002 信令数据错误,建立连接的临时状态,SDK会做好自动重连,开发者无须处理。
33001 SDK没有初始化,在使用SDK任何功能之前,必须先Init。
33003 开发者接口调用时传入的参数错误,请检查接口调用时传入的参数类型和值。
-1000 开发者接口调用时传入的参数错误,请检查接口调用时传入的参数类型和值。
具体业务错误码
code 详细描述
-1 未知错误(预留)
405 已被对方加入黑名单
5004 超时
20604 发送消息频率过高,1秒钟最多只允许发送5条消息
21406 不在该讨论组中
22406 不在该群组中
22408 在群组中已被禁言
23409 已被踢出聊天室
23410 聊天室不存在
23411 聊天室成员超限
30001 当前连接不可用(连接已经被释放)
30002 当前连接不可用
33001 SDK没有初始化,在使用SDK任何功能之前,必须先Init。
33002 数据库错误,请检查您使用的Token和userId是否正确。
33003 开发者接口调用时传入的参数错误,请检查接口调用时传入的参数类型和值。
33007 历史消息云存储业务未开通

4、更新历史

iOS

API版本:uexRongCloud-4.0.0

最近更新时间:2016-9-9

历史发布版本 更新内容
4.0.0 融云IM(uexRongCloud)插件 for iOS
Android

API版本:uexRongCloud-4.0.0

最近更新时间:2016-9-9

历史发布版本 更新内容
4.0.0 融云IM(uexRongCloud)插件

5 文档更新记录

还需要帮助吗? 联系我们
最新更新 8th Jul 2021