rongCloud2

• Method
• Constant

注意事项:

使用该插件需要在config.xml中进行如下配置

<intent-filter>
    <action name="android.intent.action.VIEW"/>
    <category name="android.intent.category.DEFAULT"/>
    <data scheme="rong" host="你的包名" pathPrefix="/conversation/"/>
</intent-filter>

<intent-filter>
   <action name="android.intent.action.VIEW" />
   <category name="android.intent.category.DEFAULT" />
   <data host="你的包名" path="/conversationlist" scheme="rong" />
</intent-filter>


<intent-filter>
    <action name="android.intent.action.VIEW" />
    <category name="android.intent.category.DEFAULT" />
    <data host="你的包名" pathPrefix="/push_message" scheme="rong" />
</intent-filter>

其中 data中的host为集成应用的包名

iOS上与bMap插冲突的解决方案

目前rongCloud2与bMap同时使用会引起插件冲突。经过与融云官方技术的讨论沟通，是音视频相关功能引起的，目前没有更好的解决方案。 所以如果用户未使用rongCloud2的音视频功能，那么官方提供了移除音视频版的iOS插件包，用户可以下载上传到自定义插件中去使用。 具体操作如下：

1. 点击下面的链接 下载 移除音视频版的iOS融云插件，然后通过自定义插件方式上传使用。

   rongCloud2抽离音视频iOS插件包

2. 下载插件包后，在云端工作台通过上传自定义插件包的方式上传（名称还是rongCloud2，插件包只包含iOS版本）。

3. 移除原rongCloud2插件，绑定自定义插件到项目，然后重新编译iOS版本即可。

   需要注意的是：自定义插件版的rongCloud2与原本的rongCloud2不可以同时绑定到同一个项目，所以你需要分开编译iOS版本和android版本。在编译iOS版本的时候，添加绑定自定义rongCloud2，编译Android版本的时候绑定插件库的rongCloud2

初始化和连接

消息的接收和发送

会话

会话通知状态

消息的读取和删除

未读消息数

消息的状态

消息回执

文字消息草稿

音视频通话

视频美颜

讨论组

群组

聊天室

黑名单

消息通知免打扰

论坛示例

为帮助用户更好更快的使用插件，论坛维护了一个示例，示例中包含示例代码、知识点讲解、注意事项等，供您参考。

概述

rongCloud2是rongCloud的优化版

融云 Rong Cloud 是国内首家专业的即时通讯云服务提供商，专注为互联网、移动互联网开发者提供即时通讯基础能力和云端服务。通过融云平台，开发者不必搭建服务端硬件环境，就可以将即时通讯、实时网络能力快速集成至应用中。

rongCloud2 封装了融云即时通讯能力库 IMLib SDK 的 API，对融云的相关接口做了一一对应的封装，功能详情可参考目录。

使用 rongCloud2 插件之前，请先 注册 融云的开发者帐号并申请创建 App，创建 App 后，可以在 开发者后台 获取 App Key 和 App Secret 用于开发。

开发前请先认真阅读相关的 融云开发文档和视频。

融云插件V2.0.0版更新说明

弃用的方法：

• reconnect

修改的方法：

• sendImageMessage的prepare返回值content中localPath统一为imageUrl，其值不变
• sendRichContentMessage返回值content中加入url字段
• getConversationList和getConversation 安卓返回值去掉字段notificationStatus,该字段取值可通过 getConversationNotificationStatus 获取
• setConnectionStatusListener返回状态值统一成枚举字符串；去掉了status字段
• setOnReceiveMessageListener 去掉了status字段
• setMessageReceivedStatus 状态值统一成枚举字符串
• getConversation/getConversationList 修改recievedStatus，统一为枚举字符串
• 所有的错误err将只返回code，不再有msg，错误码信息参照 融云常见错误码

新增的方法：

• getConnectionStatus // 获取当前连接状态
• logout // 注销登录
• getRemoteHistoryMessages // 获取远端历史消息
• setMessageSentStatus // 设置消息发送状态
• getCurrentUserId // 获取当前用户 Id
• addToBlacklist // 加入黑名单
• removeFromBlacklist // 移出黑名单
• getBlacklistStatus // 获取用户黑名单状态
• getBlacklist // 获取用户黑名单
• setNotificationQuietHours // 设置关闭 Push 时间，在该段时间内您不会收到远程推送提示，若应用刚被切到后台时，可收到本地推送提示，只有在app被杀死时才会走远程推送。
• removeNotificationQuietHours // 删除 Push 设置
• getNotificationQuietHours // 查询 Push 设置
• sendCommandMessage // 不保存、不计数的消息（ObjectName 为 RC:CmdMsg），您需要这种类型的消息时可以直接使用，不需要再自定义。
• disableLocalNotification // 设置本地消息不在通知栏提示

iOS 平台推送通知功能详解

本文主要介绍了使用融云 IM 时，何时会收到远程推送、如何使用远程推送、如何获取远程推送的内容。

何时会收到远程推

在使用远程推送之前，您需要先了解融云 SDK 的运行状态。

融云SDK的运行状态及其内容的接受

融云 SDK 根据 iOS App 运行的特性，主要有以下三种运行状态：

1、 前台状态 如字面意思，App 前台可见时插件处于前台状态。此时 App 使用融云的长连接通道来收发消息。

2、 后台活动状态 当 App 进入后台 2 分钟之内，插件于后台活跃状态。此时 App 使用融云的长连接通道接收消息。

3、 后台暂停状态当 App 进入后台 2 分钟之后或被杀进程或被冻结，插件处于后台暂停状态。此时融云的长连接通道会断开，融云 Server 会通过 APNs 将消息以远程推送的形式下发到客户端。 此状态下如果有人给该用户发送消息，融云的服务器会根据 deviceToken 和推送证书将消息发送到苹果推送服务器，苹果服务器会将该消息推送到客户端。

如何使用远程推送

此过程的 1-4 步骤请参考融云官方的 推送开发指南----如何使用远程推送。其中涉及到的 AppID即为 Bundle Identifie，与 YonBuilder移动开发 平台上的包名是同一个概念，在 YonBuilder移动开发平台上应用的概览里可以查看。

1. 为 App 开启远程推送服务
2. 生成并上传 P12 证书
3. 融云开发者平台上传 p12 证书
4. 生成 provisioning profile 文件
5. 将 provisioning profile 文件上传 YonBuilder移动开发平台
6. 在 YonBuilder移动开发平台云编译出 ipa 安装包并安装（正式版发布到苹果商店，通过苹果商店下载安装）
7. 用户允许推送

以上步骤都已经实现后，还需要使用您 App 的用户允许通知，才能收到远程推送。您可以在设备的设置应用中，查看当前App是否允许通知。

如何获取远程推送的内容

远程推送内容的获取

点击通知栏的远程推送时，如果此时 App 已经被系统冻结，则YonBuilder移动开发平台会将本次推送的内容通过事件监听回调的方式交给开发者。具体使用如下：

api.addEventListener({
    name: 'noticeclicked'
}, function(ret) {
    if (ret && ret.value) {
        var result = ret.value;
    }
})

如果 App 未被系统冻结，则您在 setOnReceiveMessageListener 接口中可以捕获该消息，详情参考 setOnReceiveMessageListener 接口说明。

音视频通话推送功能详细请参考 VoIP 推送设置文档(1-6)。其中步骤6参考config.xml关于后台运行权限的配置。

注意

• 从3.1.5版本开始，android上点击推送过来的消息，开发者可以在appintent事件中接收到该消息的内容，可以从appParam参数的rong_params字段中获取；

Android 平台推送集成说明

• 融云默认使用自己平台的推送服务，由于该推送服务属于应用级别的，所以可能受到系统平台的限制，建议您在使用时，在设置里打开自启动权限和通知权限，或者勾选“信任此应用”等，以提高推送到达率

• 集成第三方推送（使用thirdpartPush自定义插件）

thirdpartPush 插件集成了小米、魅族、vivo、oppo平台的推送，在使用该插件之前需要到相应的平台创建应用并获取相应的 appKey & appSecret等信息，并登录融云开发者后台在应用标识中配置相应的信息，并将该插件以自定义插件形式编译打包 注意：需要在调用init方法是配置或开启相应的第三方推送

• config.xml中需要单独配置vivo推送，配置如下:

<!-- vivo 推送配置项 -->
<meta-data name="com.vivo.push.api_key" value="您的 vivo 推送平台生成 AppKey"/>
<meta-data name="com.vivo.push.app_id"  value="您的 vivo 推送平台生成 AppID"/>

• 华为推送集成需要下载自定义插件 huaweiPush,使用方式为rongCloud2 初始化成功后再初始化 huaweiPush 插件即可，huaweiPush插件初始化可参考文档

• thirdpartPush 下载地址：

支持arm64-v8a so库

在rongCloud2插件的最新版本中未提供armeabi的so库，因此需要在config.xml 增加标签 <preference name="android_abi" value="arm64-v8a"/>否则可能导致app出现闪退问题

#插件接口

init

初始化融云 SDK，调用 connect 连接前务必保证调用此方法

调用前请在 config.xml 中设置内容如下：

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

其中 value 的值请替换为您在融云开发者平台上申请的 App Key 值. requestPermission: 是否自动请求通知权限，布尔类型，只支持iOS。插件默认会向系统请求通知权限，亦可以根据需要配置为false，然后调用api.requestPermission方法请求通知权限。

init(params, callback(ret, err))

params

miPush:

• 类型：JSON对象
• 描述：(可选项)配置小米推送的信息
• 默认值：无
• 内部字段：

appId:  //字符串类型；小米后台申请的appid
appKey: //字符串类型；小米后台申请的appKey

huaweiPush:

• 类型：布尔类型
• 描述：(可选项) 是否集成华为推送
• 默认值：false

meizuPush:

• 类型：JSON对象
• 描述：（可选项）魅族推送配置（需到魅族开发者平台去申请）
• 内部字段：

{
    appId:'',     // 字符串；魅族推送的AppID
    appKey:''   // 字符串；魅族推送 AppKey
}

oppoPush:

• 类型：JSON对象
• 描述：（可选项）oppo推送配置（需到oppo开发者平台去申请）
• 内部字段：

{
    appKey:'',     // 字符串；oppo推送的key
    appSecret:''   // 字符串；oppo推送 secret
}

vivoPush:

• 类型：布尔类型
• 描述：(可选项) 是否集成vivo推送
• 默认：false

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：初始化的状态，如果 config.xml 中没有设置 appKey 值，会导致失败，错误信息为参数错误
• 内部字段：

{
    status: 'success', // 状态码：success / error
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: -10002	// 错误码
}

错误说明 更多状态码：

示例代码

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

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

initRTC

initRTC(callback(ret, err))

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：初始化的状态
• 内部字段：

{
    status: 'success', // 状态码：success / error
}

示例代码

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

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

configurationParameter

配置推送相关参数

configurationParameter({params})

params

alertTitle:

• 类型：字符串
• 默认值：您收到了一条新消息
• 描述：进入后台两分钟内收到通知的显示内容，不传则显示消息内容

showNickname：

• 类型：布尔
• 默认值：false
• 描述：推送提示是否显示昵称，注：设置昵称的方式为：在发送消息接口的extra字段中填写昵称信息，格式为extra:{userInfo:{nickName:"用户昵称"}}

示例代码

var rong = api.require('rongCloud2');
rong.configurationParameter({
});

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

connect

连接融云 IM 服务器，进行后续各种方法操作前务必要先调用此方法，（Android自3.2.4版本【包括3.2.4】以后，需要开通音视频服务，否则会导致连接失败）

connect({params}, callback(ret, err))

params

token:

• 类型：字符串
• 默认值：无
• 描述：从服务端获取的用户身份令牌（Token）

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的登录成功或者失败的状态
• 内部字段：

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

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 31004	// 错误码
}

错误说明 更多状态码：

示例代码

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 });
});

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

reconnect

主动重新连接服务器。融云的 SDK 会自动进行重连，一般情况下您不需要调用这个方法；2.0版本弃用该方法。

reconnect(callback(ret, err))

可用性

iOS系统，Android系统

此方法在YonBuilder移动开发平台融云插件1.1.0中支持，由于融云支持掉线后自动重连，所以在2.0.0版本中弃用该方法

disconnect

断开连接

disconnect({params}, callback(ret, err))

params

isReceivePush:

• 类型：布尔
• 默认值：true
• 描述：断开后是否接收 Push

callback(ret)

ret:

• 类型：JSON 对象
• 描述：返回的断开连接成功或者失败的状态
• 内部字段：

{
    status: 'success' // 状态码：success
}

示例代码

var rong = api.require('rongCloud2');
// 之前调用 init 和 connect 的代码省略
rong.disconnect({
    isReceivePush: true
}, function(ret, err) {
    if ('success' == ret.status) {
        api.toast({ msg: '断开连接成功!' });
    }
}); // 断开，且不再接收 Push

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

setConnectionStatusListener

设置连接状态变化的监听器，请在调用 init 方法之后，调用 connect 方法之前设置

setConnectionStatusListener(callback(ret, err))

callback(ret)

ret:

• 类型：JSON 对象
• 描述：连接服务器的回调返回值，参见 连接状态
• 内部字段：

{
    result:
    {
        connectionStatus: 'CONNECTED' // 连接状态
    }
}

示例代码

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

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

sendTextMessage

发送文字消息

sendTextMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 默认值：无
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 默认值：无
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

text:

• 类型：字符串
• 默认值：无
• 描述：消息的文字内容

extra:

• 类型：字符串
• 默认值：无
• 描述：消息的附加信息

mentionedInfo:

• 类型：JSON类型
• 默认值：无 (可选)
• 描述：@功能，当conversationType为GROUP或DISCUSSION有效；(ios不支持DISCUSSION)；注：＠ 消息推送会越过所有免打扰逻辑，给用户推送 Push 通知。
• 内部字段：

type:"all"   //(可选项) 字符串类型；@消息类型，默认值：all；取值范围：(all，part);all为@群组里所有人；part为@部分人，
userIdList:['123'] //字符串类型的数组；用户id；当type为part时，需要填写此字段；

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：

发送准备：

{
    status: 'prepare', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            content: {
                text: 'Hello world!',
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
          extra: '',
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

成功：

{
    status: 'success', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象

内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendTextMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    text: 'Hello world.',
    extra: ''
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

sendVoiceMessage

发送语音消息

sendVoiceMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 默认值：无
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 默认值：无
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

voicePath:

• 类型：字符串
• 默认值：无
• 描述：语音文件的路径，支持 fs://，如：fs:///voice/123.wav。文件要求为 wav 格式

duration:

• 类型：数字
• 默认值：无
• 描述：语音消息的时长，单位为秒

extra:

• 类型：字符串
• 默认值：无
• 描述：消息的附加信息

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：

发送准备：

{
    status: 'prepare', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            content: {
                voicePath: '/xxx/xxx/voice.amr',
                duration: 5,
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            objectName: 'RC:VcMsg', // 消息类型，参见 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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

成功：

{
    status: 'success', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendVoiceMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    voicePath: 'fs:///xxx/xxx/voice.amr',
    duration: 5,
    extra: ''
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

sendHQVoiceMessage

发送高清语音消息

sendHQVoiceMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 默认值：无
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 默认值：无
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

voicePath:

• 类型：字符串
• 默认值：无
• 描述：语音文件的路径，支持 fs://，如：fs:///voice/123.amr。

duration:

• 类型：数字
• 默认值：无
• 描述：语音消息的时长，单位为秒

extra:

• 类型：字符串
• 默认值：无
• 描述：消息的附加信息

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：

发送准备：

{
    status: 'prepare', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            content: {
                voicePath: '/xxx/xxx/voice.amr',
                duration: 5,
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            objectName: 'RC:VcMsg', // 消息类型，参见 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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

成功：

{
    status: 'success', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendHQVoiceMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    voicePath: 'fs:///xxx/xxx/voice.amr',
    duration: 5,
    extra: ''
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 3.2.8 及更高版本

sendImageMessage

发送图片消息

sendImageMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 默认值：无
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 默认值：无
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

imagePath:

• 类型：字符串
• 默认值：无
• 描述：图片的路径，支持 fs://，如：fs:///image/123.jpg

extra:

• 类型：字符串
• 默认值：无
• 描述：消息的附加信息

isFull:

• 类型：布尔类型
• 描述：是否发送原图
• 默认值：false

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：

发送准备：

{
    status: 'prepare', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            content: {
                imageUrl: '/xxx/xxx/image.jpg',
                thumbPath: '/xxx/xxx/thumb.jpg',
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            objectName: 'RC:ImgMsg', // 消息类型，参见 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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

发送中：

{
    status: 'progress', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        },
        progress: 66 // 发送进度
    }
}

成功：

{
    status: 'success', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            sentStatus: 'FAILED', // 发送状态：SENDING, SENT 或 FAILED
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendImageMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    imagePath: 'fs:///xxx/xxx/picture.jpg',
    extra: ''
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'progress')
        api.toast({ msg: ret.result.progress });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

sendGifMessage

发送 GIF 消息

sendGifMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 默认值：无
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 默认值：无
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

imagePath:

• 类型：字符串
• 默认值：无
• 描述：图片的路径，仅支持 fs://，如：fs:///image/123.jpg

extra:

• 类型：字符串
• 默认值：无
• 描述：消息的附加信息

width:

• 类型：数字
• 描述：gif 图宽度

height:

• 类型：数字
• 描述：gif 图高度

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：（注意：message字段 android 和 ios字段存在差异）

发送准备：

{
    status: 'prepare', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            content: {
                imageUrl: '/xxx/xxx/image.jpg',
                thumbPath: '/xxx/xxx/thumb.jpg',
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            objectName: 'RC:ImgMsg', // 消息类型，参见 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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

发送中：

{
    status: 'progress', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        },
        progress: 66 // 发送进度
    }
}

成功：

{
    status: 'success', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            sentStatus: 'FAILED', // 发送状态：SENDING, SENT 或 FAILED
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendGifMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    imagePath: 'fs:///xxx/xxx/picture.gif',
    width: 100,
    height: 100,
    extra: ''
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'progress')
        api.toast({ msg: ret.result.progress });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 3.2.8 及更高版本

sendSightMessage

发送小视频消息

sendSightMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 默认值：无
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 默认值：无
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

sightPath:

• 类型：字符串
• 描述：小视频的路径，仅支持 fs://，如：fs:///image/123.jpg

thumbPath:

• 类型：字符串
• 描述：缩略图的路径，仅支持 fs://，如：fs:///image/123.jpg

extra:

• 类型：字符串
• 默认值：无
• 描述：消息的附加信息

duration:

• 类型：数字
• 描述：小视频时长

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：（注意：message字段 android 和 ios字段存在差异）

发送准备：

{
    status: 'prepare', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            content: {
                imageUrl: '/xxx/xxx/image.jpg',
                thumbPath: '/xxx/xxx/thumb.jpg',
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            objectName: 'RC:ImgMsg', // 消息类型，参见 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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

发送中：

{
    status: 'progress', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        },
        progress: 66 // 发送进度
    }
}

成功：

{
    status: 'success', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            sentStatus: 'FAILED', // 发送状态：SENDING, SENT 或 FAILED
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendSightMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    thumbPath: 'fs:///xxx/xxx/picture.jpg',
    sightPath:'',
    duration: 10,
    extra: ''
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'progress')
        api.toast({ msg: ret.result.progress });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 3.2.8 及更高版本

sendFileMessage

发送文件消息

sendFileMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 默认值：无
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 默认值：无
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

filePath:

• 类型：字符串
• 描述：文件的路径，仅支持 fs://，如：fs:///image/123.jpg

extra:

• 类型：字符串
• 描述：消息的附加信息

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：（注意：message字段 android 和 ios字段存在差异）

发送准备：

{
    status: 'prepare', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            content: {
                imageUrl: '/xxx/xxx/image.jpg',
                thumbPath: '/xxx/xxx/thumb.jpg',
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            objectName: 'RC:ImgMsg', // 消息类型，参见 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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

发送中：

{
    status: 'progress', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        },
        progress: 66 // 发送进度
    }
}

成功：

{
    status: 'success', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            sentStatus: 'FAILED', // 发送状态：SENDING, SENT 或 FAILED
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendFileMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    filePath: 'fs:///xxx/xxx/picture.gif',
    extra: ''
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'progress')
        api.toast({ msg: ret.result.progress });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 3.2.8 及更高版本

sendRichContentMessage

发送图文消息

sendRichContentMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 默认值：无
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 默认值：无
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

title:

• 类型：字符串
• 默认值：无
• 描述：消息的标题

description:

• 类型：字符串
• 默认值：无
• 描述：消息的内容描述

imageUrl:

• 类型：字符串
• 默认值：无
• 描述：消息图片的网络地址

extra:

• 类型：字符串
• 默认值：无
• 描述：消息的附加信息

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：

发送准备：

{
    status: 'prepare', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            content: {
                title: 'Big News',
                description: 'I am Ironman.',
                imageUrl: 'http://p1.cdn.com/fds78ruhi.jpg',
                extra: ''，
                url: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            objectName: 'RC:ImgTextMsg', // 消息类型，参见 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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

成功：

{
    status: 'success', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            sentStatus: 'FAILED', // 发送状态：SENDING, SENT 或 FAILED
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendRichContentMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    title: 'Big News',
    description: 'I am Ironman.'
    imageUrl: 'http://ironman.com/xxx/xxx/picture.jpg',
    extra: ''
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

sendLocationMessage

发送位置消息

sendLocationMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 默认值：无
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 默认值：无
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

latitude:

• 类型：数字
• 默认值：无
• 描述：消息的文字内容

longitude:

• 类型：数字
• 默认值：无
• 描述：消息的文字内容

poi:

• 类型：字符串
• 默认值：无
• 描述：消息的文字内容

imagePath:

• 类型：字符串
• 默认值：无
• 描述：地图缩率图的路径，支持 fs://，如：fs:///location_thumb/123.jpg

extra:

• 类型：字符串
• 默认值：无
• 描述：消息的附加信息

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：

发送准备：

{
    status: 'prepare', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            content: {
                latitude: 39.9139
                longitude: 116.3917
                poi: '北京市朝阳区北苑路北辰泰岳大厦',
                imagePath: '/xxx/xxx/location.jpg'
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            objectName: 'RC:LBSMsg', // 消息类型，参见 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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

发送中：

{
    status: 'progress', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        },
        progress: 66 // 发送进度
    }
}

成功：

{
    status: 'success', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / progress / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendLocationMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    latitude: 39.9139,
    longitude: 116.3917,
    poi: '北京市朝阳区北苑路北辰泰岳大厦',
    imagePath: 'fs:///xxx/xxx/location.jpg',
    extra: ''
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'progress')
        api.toast({ msg: ret.result.progress });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

sendCommandNotificationMessage

发送命令消息，可以用来实现任何自定义消息的发送

sendCommandNotificationMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 默认值：无
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 默认值：无
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

name:

• 类型：字符串
• 默认值：无
• 描述：命令的名称

data:

• 类型：字符串
• 默认值：无
• 描述：命令的数据

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：

发送准备：

{
    status: 'prepare', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            content: {
                name: 'AddFriend',
                data: '{\"inviteUserId\":123}'
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

成功：

{
    status: 'success', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendCommandNotificationMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    name: 'AddFriend',
    data: '{\"inviteUserId\":123}'
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

sendContactNotificationMessage

发送好友通知消息

sendContactNotificationMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

operation:

• 类型：字符串
• 描述：好友请求当前的操作名

sourceUserId:

• 类型：字符串
• 描述：当前操作发起用户的用户ID

message:

• 类型：字符串
• 描述：当前操作的消息内容

extra:

• 类型：字符串
• 描述：当前操作的附加信息

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：（注意：message字段 android 和 ios字段存在差异）

发送准备：

{
    status: 'prepare', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            content: {
                name: 'AddFriend',
                data: '{\"inviteUserId\":123}'
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

成功：

{
    status: 'success', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendContactNotificationMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    sourceUserId: '9528',
    operation: '9528',
    message: '9528',
    extra: '{\"inviteUserId\":123}'
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 3.2.8 及更高版本

sendProfileNotificationMessage

发送资料通知消息

sendProfileNotificationMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

operation:

• 类型：字符串
• 描述：资料通知的操作名

data:

• 类型：字符串
• 描述：信息变更的数据，可以为任意格式，如json数据。

extra:

• 类型：字符串
• 描述：当前操作的附加信息

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：（注意：message字段 android 和 ios字段存在差异）

发送准备：

{
    status: 'prepare', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            content: {
                name: 'AddFriend',
                data: '{\"inviteUserId\":123}'
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

成功：

{
    status: 'success', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendProfileNotificationMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    operation: '9528',
    data: 'data',
    extra: '{\"inviteUserId\":123}'
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 3.2.8 及更高版本

sendInformationNotificationMessage

发送通知消息

sendInformationNotificationMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

message:

• 类型：字符串
• 描述：当前操作的消息内容

extra:

• 类型：字符串
• 描述：当前操作的附加信息

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：（注意：message字段 android 和 ios字段存在差异）

发送准备：

{
    status: 'prepare', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            content: {
                name: 'AddFriend',
                data: '{\"inviteUserId\":123}'
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

成功：

{
    status: 'success', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendInformationNotificationMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    message: '9528',
    extra: '{\"inviteUserId\":123}'
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 3.2.8 及更高版本

sendGroupNotificationMessage

发送群组通知消息类消息

sendGroupNotificationMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

operation:

• 类型：字符串
• 描述：群组通知当前的操作名

operatorUserId:

• 类型：字符串
• 描述：当前操作发起用户的用户ID

message:

• 类型：字符串
• 描述：当前操作的消息内容

data:

• 类型：字符串
• 描述：当前操作的目标对象，如被当前操作目标用户的用户ID或变更后的群主名称等。

extra:

• 类型：字符串
• 描述：当前操作的附加信息

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：（注意：message字段 android 和 ios字段存在差异）

发送准备：

{
    status: 'prepare', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            content: {
                name: 'AddFriend',
                data: '{\"inviteUserId\":123}'
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

成功：

{
    status: 'success', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendGroupNotificationMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    operation: '9528',
    operatorUserId: '9528',
    message: '9528',
    data: 'data',
    extra: '{\"inviteUserId\":123}'
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 3.2.8 及更高版本

sendCommandMessage

发送命令消息，您需要这种类型的消息时可以直接使用，不需要再自定义。此消息不保存、不计数。

sendCommandMessage({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 默认值：无
• 描述：消息的会话类型，通过改变消息会话类型，可以发送单聊消息、讨论组消息、群聊消息、聊天室消息等，参见 会话类型

targetId:

• 类型：字符串
• 默认值：无
• 描述：消息的接收方 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

name:

• 类型：字符串
• 默认值：无
• 描述：命令的名称

data:

• 类型：字符串
• 默认值：无
• 描述：命令的数据

isCanIncludeExpansion:

• 类型：布尔类型
• 描述：是否携带扩展数据
• 默认：false

expansion:

• 类型：JSON对象
• 描述：扩展数据
• 内部字段：

{
    '自定义key': '自定义value',
    '自定义key1': '自定义value1',
    // ...
}

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：返回的消息内容。发送准备时，提供所有消息信息；之后，result 中将只返回 message.messageId 等必要相关的内容
• 内部字段：

发送准备：

{
    status: 'prepare', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            content: {
                name: 'AddFriend',
                data: '{\"inviteUserId\":123}'
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '16', // 接收者 Id
            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 秒开始到现在的毫秒数
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    }
}

成功：

{
    status: 'success', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

失败：

{
    status: 'error', // 状态码：prepare / success / error
    result:
    {
        message:
        {
            messageId: 608 // 本地消息 Id
        }
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明 更多状态码：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.sendCommandMessage({
    conversationType: 'PRIVATE',
    targetId: '9527',
    name: 'AddFriend',
    data: '{\"inviteUserId\":123}'
}, function(ret, err) {
    if (ret.status == 'prepare')
        api.toast({ msg: JSON.stringify(ret.result.message) });
    else if (ret.status == 'success')
        api.toast({ msg: ret.result.message.messageId });
    else if (ret.status == 'error')
        api.toast({ msg: err.code });
});

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

setOnReceiveMessageListener

设置接收消息的监听器，请在调用 init 方法之后，调用 connect 方法之前设置

所有接收到的消息、通知、状态都经由此处设置的监听器处理。包括私聊消息、讨论组消息、群组消息、聊天室消息以及各种其他消息、通知、状态等

setOnReceiveMessageListener(callback(ret, err))

callback(ret)

ret:

• 类型：JSON 对象
• 描述：接收到的消息内容和剩余消息条数
• 内部字段：

{

     result: {
        message:{
            content: {                   //JSON对象；消息内容
                text: 'Hello world!',
                extra: ''
            },         
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            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 秒开始到现在的毫秒数
            receivedStatus: 'LISTENED' // 消息状态(android不支持) 取值范围：UNREAD，READ，LISTENED，DOWNLOADED，RETRIEVED，MULTIPLERECEIVE
            isRead:true,    //获取是否已读取的状态(ios不支持)
            isListened:true, //获取是否已被收听的状态(ios不支持)
            isDownload:true,   //获取文件是否已经下载的状态(ios不支持)
            isRetrieved:false, //获取是否已经被收取过(ios不支持)
            messageUId: ''   //消息UID，如果无则显示空字符串
            isMultipleReceive: false  //获取是否被其他端同时接收(ios不支持)
        },
        left: 0                         // 剩余未拉取的消息数目
    },
    isPushMsg: false                   //布尔类型；是否是推送消息，本参数仅在iOS平台有效。
                                       //在 iOS 平台上APP收到推送时，有以下几种情况：
                                       //1，应用在前台激活状态，开发者可同本接口获取推送消息，此时 result数据格式如下文说明
                                       //2，应用在后台但未被杀死，此时系统弹出推送提示。若用户点击推送提示，开发者可同本接口获取推送消息，此时 result数据格式如下文说明。若用户不点击推送提示，直接点击app进入应用，则获取
                                       //3，应用未激活，此时收到推送后，系统会弹出提示框，用户点击该提示框，开发者可通过api对象下noticeclicked事件监听到推送消息。
                                       //注意：如果用户不点击推送提示框，而是直接点击app图标进入应用，开发者是收不到推送消息的。
}

档 isPushMsg 为 true 时 result 数据的格式说明：

{
    _j_msgid:20266200178825380,  //数字类型；
    infoid:'0',                  //字符串类型；
    _j_business:1,               //数字类型；
    id:62358',                   //字符串类型；
    aps:{                        //JSON对象
      sound:'default',           //字符串类型；
      badge:1,                   //数字类型；
      alert:'你有新的消息'         //字符串类型；
    },
    _j_uid:12108421449,          //数字类型；
    type:‘8’,                    //字符串类型；
}

示例代码

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 的代码省略

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

getOfflineMessageDuration

获取当前用户离线消息时间

getOfflineMessageDuration(callback(ret, err))

callback(ret)

ret:

• 类型：JSON 对象
• 描述：获取状态
• 内部字段：

status: true  //布尔类型；获取到的状态
duration: ''  //字符串类型；当前用户离线消息时间，单位：天

err:

• 类型：JSON 对象
• 描述：获取状态
• 内部字段：

errCode: ''  //数字类型；错误码；详情参见：https://www.rongcloud.cn/docs/status_code.html#android_ios_code

示例代码

var rong = api.require('rongCloud2');

rong.getOfflineMessageDuration(function(ret, err) {
    api.toast({ msg: JSON.stringify(ret) });
})

可用性

iOS系统，Android系统

可提供的 3.1.1 及更高版本

setOfflineMessageDuration

设置当前用户离线消息存储时间

setOfflineMessageDuration(params, callback(ret, err))

params

duration：

• 类型：数字类型
• 描述：(可选项)用户离线消息存储时间（以天为单位），范围【1~7天】
• 默认值：1

callback(ret)

ret:

• 类型：JSON 对象
• 描述：获取状态
• 内部字段：

status: true  //布尔类型；获取到的状态
time: ''      //字符串类型；设置成功后的时间(毫秒值)(iOS不支持)

err:

• 类型：JSON 对象
• 描述：获取状态
• 内部字段：

errCode: ''  //数字类型；错误码；详情参见：https://www.rongcloud.cn/docs/status_code.html#android_ios_code

示例代码

var rong = api.require('rongCloud2');

rong.setOfflineMessageDuration({duration:2}, function(ret, err) {
    api.toast({ msg: JSON.stringify(ret) });
})

可用性

iOS系统，Android系统

可提供的 3.1.1 及更高版本

searchConversations

搜索本地历史消息

searchConversations({params}, callback(ret))

params

conversationTypes:

• 类型：数组类型
• 描述：搜索的会话类型，参见 会话类型

objectNames:

• 类型：数组类型
• 描述：搜索的消息类型。比如：RC:TxtMsg；详情参见：http://docs.rongcloud.cn/android_message.html#_内置内容类消息

keyword:

• 类型：字符串类型
• 描述： 搜索的关键字

callback(ret)

ret:

• 类型：JSON 对象
• 描述：会话信息
• 内部字段：

{
    status: 'success',
    result: [
        {
            conversationTitle: 'Ironman', // 会话标题
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            draft: '', // 文字消息草稿的内容
            targetId: 'group001', // 消息目标 Id
            latestMessage: {
                text: 'Hello world!',
                extra: ''
            }, // 最后一条消息的内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            sentStatus: 'SENT', // 参见 发送出的消息状态
            *notificationStatus: 'NOTIFY', // 会话通知状态，2.0.0将不再提供此字段，可通过 getConversationNotificationStatus 获取
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            receivedStatus: 'READ', // 参见 接收到的消息状态
            senderUserId: '55', // 发送消息的用户 Id
            unreadMessageCount: 10, // 本会话的未读消息数
            receivedTime: 1418968547905, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            sentTime: 1418968488063, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            isTop: false, // 置顶状态
            latestMessageId: 608 // 本会话最后一条消息 Id
        }
    ]
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.searchConversations({
    conversationTypes: ['PRIVATE'],
    objectNames: ['RC:TxtMsg'],
    keyword:'hello'
}, function(ret) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 3.1.1 及更高版本

searchMessages

根据会话,搜索本地历史消息。

searchMessages({params}, callback(ret))

params

conversationType:

• 类型：字符串类型
• 描述：指定的会话类型，参见 会话类型

targetId:

• 类型：字符串类型
• 描述：指定的会话 id

keyword:

• 类型：字符串类型
• 描述： 搜索的关键字

count:

• 类型：数字类型
• 描述： 返回的搜索结果数量（iOS平台为返回的最大搜索结果数量）, 安卓平台传0时会返回所有搜索到的消息, 非0时,逐页返回
• 默认值：0

beginTime:

• 类型：数字类型
• 描述： 查询记录的起始时间, 传0时从最新消息开始搜索。（单位：毫秒值）
• 默认值：0

callback(ret)

ret:

• 类型：JSON 对象
• 描述：会话信息
• 内部字段：

{
    status: 'success',
    result: [
        {
            content: {
                text: 'Hello world!',
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
          extra: '', // 消息的附加信息，此信息只保存在本地
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '55', // 这里对应消息发送者的 userId
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            sentStatus: 'SENDING', // 参见 发送出的消息状态
            senderUserId: '55', // 发送者 userId
            messageId: 608, // 本地消息 Id
            sentTime: 1418971531533, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedTime: 0, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedStatus: 'LISTENED' // 消息状态(android不支持) 取值范围：UNREAD，READ，LISTENED，DOWNLOADED，RETRIEVED，MULTIPLERECEIVE
            isRead:true,    //获取是否已读取的状态(ios不支持)
            isListened:true, //获取是否已被收听的状态(ios不支持)
            isDownload:true,   //获取文件是否已经下载的状态(ios不支持)
            isRetrieved:false, //获取是否已经被收取过(ios不支持)
            isMultipleReceive: false  //获取是否被其他端同时接收(ios不支持)
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    ]
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.searchMessages({
    conversationType: 'PRIVATE',
    targetId: '1234',
    keyword:'hello'
}, function(ret) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 3.1.1 及更高版本

getConversationList

获取会话列表

会话列表按照时间从前往后排列，如果有置顶会话，则置顶会话在前

getConversationList(callback(ret, err))

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：会话列表
• 内部字段：

{
    status: 'success',
    result: [
        {
            conversationTitle: 'Ironman', // 会话标题
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            draft: '', // 文字消息草稿的内容
            targetId: 'group001', // 消息目标 Id
            latestMessage: {
                text: 'Hello world!',
                extra: ''
            }, // 最后一条消息的内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            sentStatus: 'SENT', // 参见 发送出的消息状态
            *notificationStatus: 'NOTIFY', // 会话通知状态，2.0.0将不再提供此字段，可通过 getConversationNotificationStatus 获取
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            receivedStatus: 'READ', // 参见 接收到的消息状态
            senderUserId: '55', // 发送消息的用户 Id
            unreadMessageCount: 10, // 本会话的未读消息数
            receivedTime: 1418968547905, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            sentTime: 1418968488063, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            isTop: false, // 置顶状态
            latestMessageId: 608 // 本会话最后一条消息 Id,
            mentionedCount: 2   //本会话里自己被＠的消息数量(iOS不支持)
            hasUnreadMentioned:true //会话中是否存在被@的消息,在清除会话未读数的时候，会将此状态置成false(android不支持)
        }
    ]
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略

rong.getConversationList(function(ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

getTopConversationList

获取置顶会话列表

getTopConversationList(callback(ret))

callback(ret)

ret:

• 类型：JSON 对象
• 描述：会话列表
• 内部字段：

{
    status: 'success',
    result: [
        {
            conversationTitle: 'Ironman', // 会话标题
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            draft: '', // 文字消息草稿的内容
            targetId: 'group001', // 消息目标 Id
            latestMessage: {
                text: 'Hello world!',
                extra: ''
            }, // 最后一条消息的内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            sentStatus: 'SENT', // 参见 发送出的消息状态
            *notificationStatus: 'NOTIFY', // 会话通知状态，2.0.0将不再提供此字段，可通过 getConversationNotificationStatus 获取
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            receivedStatus: 'READ', // 参见 接收到的消息状态
            senderUserId: '55', // 发送消息的用户 Id
            unreadMessageCount: 10, // 本会话的未读消息数
            receivedTime: 1418968547905, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            sentTime: 1418968488063, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            isTop: false, // 置顶状态
            latestMessageId: 608 // 本会话最后一条消息 Id,
            mentionedCount: 2   //本会话里自己被＠的消息数量(iOS不支持)
            hasUnreadMentioned:true //会话中是否存在被@的消息,在清除会话未读数的时候，会将此状态置成false(android不支持)
        }
    ]
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略

rong.getTopConversationList(function(ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

可用性

iOS系统，Android系统

可提供的 3.0.7 及更高版本

getBlockedConversationList

获取屏蔽消息的会话列表

getBlockedConversationList(params, callback(ret))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见会话类型(ios不支持)
• 默认值：PRIVATE

callback(ret)

ret:

• 类型：JSON 对象
• 描述：会话列表
• 内部字段：

{
    status: 'success',
    result: [
        {
            conversationTitle: 'Ironman', // 会话标题
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            draft: '', // 文字消息草稿的内容
            targetId: 'group001', // 消息目标 Id
            latestMessage: {
                text: 'Hello world!',
                extra: ''
            }, // 最后一条消息的内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            sentStatus: 'SENT', // 参见 发送出的消息状态
            *notificationStatus: 'NOTIFY', // 会话通知状态，2.0.0将不再提供此字段，可通过 getConversationNotificationStatus 获取
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            receivedStatus: 'READ', // 参见 接收到的消息状态
            senderUserId: '55', // 发送消息的用户 Id
            unreadMessageCount: 10, // 本会话的未读消息数
            receivedTime: 1418968547905, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            sentTime: 1418968488063, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            isTop: false, // 置顶状态
            latestMessageId: 608 // 本会话最后一条消息 Id,
            mentionedCount: 2   //本会话里自己被＠的消息数量(iOS不支持)
            hasUnreadMentioned:true //会话中是否存在被@的消息,在清除会话未读数的时候，会将此状态置成false(android不支持)
        }
    ]
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略

rong.getBlockedConversationList(function(ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

可用性

iOS系统，Android系统

可提供的 3.0.7 及更高版本

getConversationListByCount

分页获取会话列表

会话列表按照时间从前往后排列，如果有置顶会话，则置顶会话在前

getConversationListByCount({params},callback(ret, err))

params

typeList：

• 类型：数组
• 描述：（可选项）回话类型组成的数组
• 默认值：['private','group','discussion','system']
• 取值范围：
  • private：单聊
  • discussion：讨论组
  • group：群组
  • chatroom：聊天室
  • customerService：客服
  • system：系统会话
  • appService：应用内公众服务会话
  • publicService：跨应用公众服务会话
  • pushService：推送服务会话

count：

• 类型：数字
• 描述：（可选项）获取的数量
• 默认：10

startTime：

• 类型：数字
• 描述：（可选项）会话的时间戳（获取这个时间戳之前的会话列表，0表示从最新开始获取）
• 默认：0

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：会话列表
• 内部字段：

{
    status: 'success',
    result: [
        {
            conversationTitle: 'Ironman', // 会话标题
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            draft: '', // 文字消息草稿的内容
            targetId: 'group001', // 消息目标 Id
            latestMessage: {
                text: 'Hello world!',
                extra: ''
            }, // 最后一条消息的内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            sentStatus: 'SENT', // 参见 发送出的消息状态
            *notificationStatus: 'NOTIFY', // 会话通知状态，2.0.0将不再提供此字段，可通过 getConversationNotificationStatus 获取
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            receivedStatus: 'READ', // 参见 接收到的消息状态
            senderUserId: '55', // 发送消息的用户 Id
            unreadMessageCount: 10, // 本会话的未读消息数
            receivedTime: 1418968547905, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            sentTime: 1418968488063, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            isTop: false, // 置顶状态
            latestMessageId: 608 // 本会话最后一条消息 Id,
            mentionedCount: 2   //本会话里自己被＠的消息数量(iOS不支持)
            hasUnreadMentioned:true //会话中是否存在被@的消息,在清除会话未读数的时候，会将此状态置成false(android不支持)
        }
    ]
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略

rong.getConversationListByCount(function(ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

可用性

iOS系统，Android系统

可提供的 3.0.3 及更高版本

getConversation

获取某一会话信息

getConversation({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：会话信息
• 内部字段：

{
    status: 'success',
    result: {
        conversationTitle: 'Ironman', // 会话标题
        conversationType: 'PRIVATE', // 参见 会话类型 枚举
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
        draft: '', // 文字消息草稿的内容
        targetId: 'group001', // 消息目标 Id
        latestMessage: {
                text: 'Hello world!',
                extra: ''
            }, // 最后一条消息的内容
            sentStatus: 'SENT', // 参见 发送出的消息状态
            *notificationStatus: 'NOTIFY', // 会话通知状态，2.0将不再提供此字段，可通过 getConversationNotificationStatus 获取
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            recievedStatus: 0, // 参见 接收到的消息状态
            senderUserId: '55', // 发送消息的用户 Id
            unreadMessageCount: 10, // 本会话的未读消息数
            receivedTime: 1418968547905, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            sentTime: 1418968488063, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            isTop: false, // 置顶状态
            latestMessageId: 608 // 本会话最后一条消息 Id,
            mentionedCount: 2   //本会话里自己被＠的消息数量(iOS不支持)
            hasUnreadMentioned:true //会话中是否存在被@的消息,在清除会话未读数的时候，会将此状态置成false(android不支持)
        }
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略

rong.getConversation({
    conversationType: 'PRIVATE',
    targetId: '9527'
}, function(ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

getMessageCount

获取某一会话信息数量

getMessageCount({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：会话信息
• 内部字段：

{
    status: 'success',
    result: {
        count:        // 数字类型；当前会话消息数
    }
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略

rong.getMessageCount({
    conversationType: 'PRIVATE',
    targetId: '9527'
}, function(ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

可用性

iOS系统

可提供的 3.0.7 及更高版本

removeConversation

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

如果此会话中有新的消息，该会话将重新在会话列表中显示，并显示最近的历史消息

removeConversation({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略

rong.removeConversation({
    conversationType: 'PRIVATE',
    targetId: '9527'
}, function(ret, err) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

clearConversations

清空所有会话及会话消息

clearConversations({params}, callback(ret, err))

params

conversationTypes:

• 类型：字符串数组
• 默认值：无
• 描述：消息的会话类型，参见 会话类型

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略

rong.clearConversations({
    conversationTypes: ['PRIVATE', 'GROUP']
}, function(ret, err) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

setConversationToTop

设置某一会话为置顶或者取消置顶

setConversationToTop({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

isTop:

• 类型：布尔
• 描述：是否置顶

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略

rong.setConversationToTop({
    conversationType: 'PRIVATE',
    targetId: '9527',
    isTop: true
}, function(ret, err) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

getConversationNotificationStatus

获取某一会话的通知状态

getConversationNotificationStatus({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success', // 状态码：success / error
    result: {
        code: 0 // 状态码，0：免打扰 / 1：提醒
        notificationStatus: 'DO_NOT_DISTURB' // 参见 会话通知提醒状态 枚举
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略

rong.getConversationNotificationStatus({
    conversationType: 'PRIVATE',
    targetId: '9527'
}, function(ret, err) {
    if (ret.status == 'success')
        api.toast({ msg: ret.result.code });
    else
        api.toast({ msg: err.code });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

setConversationNotificationStatus

设置某一会话的通知状态

setConversationNotificationStatus({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

notificationStatus:

• 类型：字符串
• 描述：会话通知提醒状态，参见 会话通知提醒状态

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success', // 状态码：success / error
    result: {
        code: 0 // 状态码，0：免打扰 / 1：提醒
        notificationStatus: "DO_NOT_DISTURB" // 参见 会话通知提醒状态 枚举
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略

rong.setConversationNotificationStatus({
    conversationType: 'PRIVATE',
    targetId: '9527',
    notificationStatus: 'DO_NOT_DISTURB'
}, function(ret, err) {
    if (ret.status == 'success')
        api.toast({ msg: ret.result.code });
    else
        api.toast({ msg: err.code });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

getLatestMessages

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

getLatestMessages({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

count:

• 类型：数字
• 描述：要获取的消息数量

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：最新消息记录，按照时间顺序从新到旧排列。
• 内部字段：

{
    status: 'success',
    result: [
        {
            content: {
                text: 'Hello world!',
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
          extra: '', // 消息的附加信息，此信息只保存在本地
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '55', // 这里对应消息发送者的 userId
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            sentStatus: 'SENDING', // 参见 发送出的消息状态
            senderUserId: '55', // 发送者 userId
            messageId: 608, // 本地消息 Id
            sentTime: 1418971531533, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedTime: 0, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedStatus: 'LISTENED' // 消息状态(android不支持) 取值范围：UNREAD，READ，LISTENED，DOWNLOADED，RETRIEVED，MULTIPLERECEIVE
            isRead:true,    //获取是否已读取的状态(ios不支持)
            isListened:true, //获取是否已被收听的状态(ios不支持)
            isDownload:true,   //获取文件是否已经下载的状态(ios不支持)
            isRetrieved:false, //获取是否已经被收取过(ios不支持)
            isMultipleReceive: false  //获取是否被其他端同时接收(ios不支持)
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    ]
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.getLatestMessages({
    conversationType: 'PRIVATE',
    targetId: '9527',
    count: 20
}, function(ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

getHistoryMessages

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

getHistoryMessages({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

oldestMessageId:

• 类型：数字
• 描述：最后一条消息的 Id，获取此消息之前的 count 条消息，没有消息第一次调用应设置为: -1

count:

• 类型：数字
• 描述：要获取的消息数量

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：最新消息记录，按照时间顺序从新到旧排列。
• 内部字段：

{
    status: 'success',
    result: [
        {
            content: {
                text: 'Hello world!',
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
          extra: '', // 消息的附加信息，此信息只保存在本地
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '55', // 这里对应消息发送者的 userId
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            sentStatus: 'SENDING', // 参见 发送出的消息状态
            senderUserId: '55', // 发送者 userId
            messageId: 608, // 本地消息 Id
            sentTime: 1418971531533, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedTime: 0, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedStatus: 'LISTENED' // 消息状态(android不支持) 取值范围：UNREAD，READ，LISTENED，DOWNLOADED，RETRIEVED，MULTIPLERECEIVE
            isRead:true,    //获取是否已读取的状态(ios不支持)
            isListened:true, //获取是否已被收听的状态(ios不支持)
            isDownload:true,   //获取文件是否已经下载的状态(ios不支持)
            isRetrieved:false, //获取是否已经被收取过(ios不支持)
            isMultipleReceive: false  //获取是否被其他端同时接收(ios不支持)
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    ]
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.getHistoryMessages({
    conversationType: 'PRIVATE',
    targetId: '9527',
    oldestMessageId: 688,
    count: 20
}, function(ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

getHistoryMessagesForward

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

getHistoryMessagesForward({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

objectNames:

• 类型：数组
• 描述：消息类型标识组成的数组

sentTime:

• 类型：数字
• 描述： 指定发送消息的时间戳

count:

• 类型：数字
• 描述：要获取的消息数量

isForward:

• 类型：布尔
• 描述：查询方向，是否向前查询，true｜false

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：消息记录
• 内部字段：

{
    status: 'success',
    result: [
        {
            content: {
                text: 'Hello world!',
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
          extra: '', // 消息的附加信息，此信息只保存在本地
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '55', // 这里对应消息发送者的 userId
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            sentStatus: 'SENDING', // 参见 发送出的消息状态
            senderUserId: '55', // 发送者 userId
            messageId: 608, // 本地消息 Id
            sentTime: 1418971531533, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedTime: 0, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedStatus: 'LISTENED' // 消息状态(android不支持) 取值范围：UNREAD，READ，LISTENED，DOWNLOADED，RETRIEVED，MULTIPLERECEIVE
            isRead:true,    //获取是否已读取的状态(ios不支持)
            isListened:true, //获取是否已被收听的状态(ios不支持)
            isDownload:true,   //获取文件是否已经下载的状态(ios不支持)
            isRetrieved:false, //获取是否已经被收取过(ios不支持)
            isMultipleReceive: false  //获取是否被其他端同时接收(ios不支持)
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    ]
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.getHistoryMessagesForward({
    conversationType: 'PRIVATE',
    targetId: '9527',
    sentTime: 688,
    count: 20,
    objectNames: ['RC:TxtMsg'],
    isForward: false
}, function(ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

可用性

iOS系统，Android系统

可提供的 3.5.8 及更高版本

getUnreadMentionedMessages

获取某会话里未读的@消息。

getUnreadMentionedMessages({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：未读的@消息。
• 内部字段：

{
    status: 'success',
    result: [
        {
            content: {
                text: 'Hello world!',
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            extra: '', // 消息的附加信息，此信息只保存在本地
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '55', // 这里对应消息发送者的 userId
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            sentStatus: 'SENDING', // 参见 发送出的消息状态
            senderUserId: '55', // 发送者 userId
            messageId: 608, // 本地消息 Id
            sentTime: 1418971531533, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedTime: 0, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedStatus: 'LISTENED' // 消息状态(android不支持) 取值范围：UNREAD，READ，LISTENED，DOWNLOADED
            isRead:true,    //获取是否已读取的状态(ios不支持)
            isListened:true, //获取是否已被收听的状态(ios不支持)
            isDownload:true,   //获取文件是否已经下载的状态(ios不支持)
            isRetrieved:false, //获取是否已经被收取过(ios不支持)
            isMultipleReceive: false  //获取是否被其他端同时接收(ios不支持)
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    ]
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.getUnreadMentionedMessages({
    conversationType: 'GROUP',
    targetId: '9527'
}, function(ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

可用性

iOS系统，Android系统

可提供的 3.1.4 及更高版本

getHistoryMessagesByObjectName

按照消息类型获取历史消息记录

getHistoryMessagesByObjectName({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

objectName:

• 类型：字符串
• 描述：消息类型标识

oldestMessageId:

• 类型：数字
• 描述：最后一条消息的 Id，获取此消息之前的 count 条消息，没有消息第一次调用应设置为: -1

count:

• 类型：数字
• 描述：要获取的消息数量

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：最新消息记录，按照时间顺序从新到旧排列。
• 内部字段：

{
    status: 'success',
    result: [
        {
            content: {
                text: 'Hello world!',
                extra: ''
            }, // 消息内容
            readReceiptInfo:{   // 注：如果此字段无值，则返回空
               hasRespond:true,          //是否已经发送回执
               isReceiptRequestMessage:true,//是否需要回执消息
               userIdList:{},       //发送回执的用户ID列表 (android不支持)
               userIds:[]      //json数组类型；发送回执的用户ID和时间戳列表 (ios不支持)
            },
            extra: '', // 消息的附加信息，此信息只保存在本地
            conversationType: 'PRIVATE', // 参见 会话类型 枚举
            messageDirection: 'SEND', // 消息方向：SEND 或者 RECEIVE
            targetId: '55', // 这里对应消息发送者的 userId
            objectName: 'RC:TxtMsg', // 消息类型，参见 http://docs.rongcloud.cn/android_message.html#_内置内容类消息
            sentStatus: 'SENDING', // 参见 发送出的消息状态
            senderUserId: '55', // 发送者 userId
            messageId: 608, // 本地消息 Id
            sentTime: 1418971531533, // 发送消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedTime: 0, // 收到消息的时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
            receivedStatus: 'LISTENED' // 消息状态(android不支持) 取值范围：UNREAD，READ，LISTENED，DOWNLOADED，RETRIEVED，MULTIPLERECEIVE
            isRead:true,    //获取是否已读取的状态(ios不支持)
            isListened:true, //获取是否已被收听的状态(ios不支持)
            isDownload:true,   //获取文件是否已经下载的状态(ios不支持)
            isRetrieved:false, //获取是否已经被收取过(ios不支持)
            isMultipleReceive: false  //获取是否被其他端同时接收(ios不支持)
            messageUId: ''   //消息UID，如果无则显示空字符串
        }
    ]
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.getHistoryMessagesByObjectName({
    conversationType: 'PRIVATE',
    targetId: '9527',
    objectName: 'RC:TxtMsg',
    oldestMessageId: 688,
    count: 20
}, function(ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

deleteMessages

删除指定的一条或者一组消息

deleteMessages({params}, callback(ret, err))

params

messageIds:

• 类型：数字数组
• 描述：要删除的消息 Id 数组

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.deleteMessages({
    messageIds: [688, 689]
}, function(ret, err) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

clearMessages

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

clearMessages({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.clearMessages({
    conversationType: 'PRIVATE',
    targetId: '9527'
}, function(ret, err) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

recallMessage

撤回消息

recallMessage({params}, callback(ret, err))

params

messageId:

• 类型：字符串
• 描述：消息ID

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    success: true   // 布尔类型；是否成功
    messageId: 888    // 数值类型；撤回的消息ID，该消息已经变更为新的消息；(android不支持)
    operatorId: ''    //字符串类型；发起撤回消息的用户id；(ios不支持)
    recallTime:       //数值类型； 撤回的时间（毫秒）(ios不支持)
}

err:

• 类型：JSON 对象
• 内部字段：

{
       code: 1,   // 数值类型；错误code
}

示例代码

var rong = api.require('rongCloud2');
rong.recallMessage({
                        messageId : 888
                    }, function(ret, err){
                      if (ret.success) {
                          alert(JSON.stringify(ret));
                      }else {
                           alert(JSON.stringify(err));
                      }
                })

可用性

iOS系统，Android系统

可提供的 3.1.2 及更高版本

syncConversationReadStatus

同步会话阅读状态

syncConversationReadStatus(params, callback(ret))

params

conversationType:

• 类型：字符串类型
• 描述：会话类型
• 默认值：GROUP

targetId:

• 类型：字符串类型
• 描述：targetId

time:

• 类型：数字类型
• 描述：已经阅读的最后一条消息的Unix时间戳(毫秒)

callback(ret)

ret:

• 类型：JSON对象
• 描述：设置后状态
• 内部字段：

{
    status: ,                 //布尔类型；状态
    errorCode: ,              //数字；错误码；status为false时有值
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.syncConversationReadStatus({conversationType:1,targetId:"2er",time: 1545464616156}, function(ret){
   api.alert({msg:JSON.stringify(ret)});
});

可用性

iOS 系统，Android 系统

可提供的 3.1.7 及更高版本

setOnMessageRecalledListener

监听撤回消息

setOnMessageRecalledListener(callback(ret))

callback(ret)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    messageId: 888    // 数值类型；被撤回的消息ID
}

示例代码

var rong = api.require('rongCloud2');
rong.setOnMessageRecalledListener(function(ret){                  alert(JSON.stringify(ret));
                })

可用性

iOS系统，Android系统

可提供的 3.1.2 及更高版本

getTotalUnreadCount

获取所有未读消息数

getTotalUnreadCount(callback(ret, err))

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success',
    result: 12 // 未读消息数
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.getTotalUnreadCount(function(ret, err) {
    api.toast({ msg: ret.result });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

getUnreadCount

获取来自某用户（某会话）的未读消息数

getUnreadCount({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success',
    result: 12 // 未读消息数
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.getUnreadCount({
    conversationType: 'PRIVATE',
    targetId: '9527'
}, function(ret, err) {
    api.toast({ msg: ret.result });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

getUnreadCountByConversationTypes

获取某（些）会话类型的未读消息数

getUnreadCountByConversationTypes({params}, callback(ret, err))

params

conversationTypes:

• 类型：字符串数组
• 描述：消息的会话类型，参见 会话类型

containBlocked:

• 类型：布尔类型
• 描述：是否包含屏蔽的消息
• 默认：true

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success',
    result: 12 // 未读消息数
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.getUnreadCountByConversationTypes({
    conversationTypes: ['PRIVATE', 'GROUP']
}, function(ret, err) {
    api.toast({ msg: ret.result });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

setMessageReceivedStatus

设置接收到的消息状态

setMessageReceivedStatus({params}, callback(ret, err))

params

messageId:

• 类型：数字
• 描述：消息 Id

receivedStatus:

• 类型：字符串
• 描述：设置接收到的消息状态，参见 接收到的消息状态
• 特别说明：此参数在1.0版本中为数字类型，在2.0版本中统一了消息状态，变更为字符串类型

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.setMessageReceivedStatus({
    messageId: '688',
    receivedStatus: 'READ'
}, function(ret, err) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

clearMessagesUnreadStatus

清除某一会话的消息未读状态

clearMessagesUnreadStatus({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.clearMessagesUnreadStatus({
    conversationType: 'PRIVATE',
    targetId: '9527'
}, function(ret, err) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

setMessageExtra

设置消息的附加信息，此信息只保存在本地

setMessageExtra({params}, callback(ret, err))

params

messageId:

• 类型：数字
• 描述：消息 Id

value:

• 类型：字符串
• 描述：消息附加信息，最大 1024 字节

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.setMessageExtra({
    messageId: '688',
    value: 'extra info'
}, function(ret, err) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

getTextMessageDraft

获取某一会话的文字消息草稿

getTextMessageDraft({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success',
    result: 'Hello w' // 草稿的文字内容
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.getTextMessageDraft({
    conversationType: 'PRIVATE',
    targetId: '9527'
}, function(ret, err) {
    api.toast({ msg: ret.result });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

saveTextMessageDraft

保存某一会话的文字消息草稿

saveTextMessageDraft({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

content:

• 类型：字符串
• 描述：草稿的文字内容

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.saveTextMessageDraft({
    conversationType: 'PRIVATE',
    targetId: '9527',
    content: 'Hello w'
}, function(ret, err) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

clearTextMessageDraft

清除某一会话的文字消息草稿

clearTextMessageDraft({params}, callback(ret, err))

params

conversationType:

• 类型：字符串
• 描述：消息的会话类型，参见 会话类型

targetId:

• 类型：字符串
• 描述：目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id 等

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.clearTextMessageDraft({
    conversationType: 'PRIVATE',
    targetId: '9527'
}, function(ret, err) {
    api.toast({ msg: ret.status });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

addCallReceiveListener

音视频来电事件监听

addCallReceiveListener(params)

params

target:

• 类型：字符串
• 描述：要监听的事件
• 默认：didReceiveCall
• 取值范围：
  • didReceiveCall:收到来电的事件
  • permissionRequest 权限请求事件（暂仅支持android 注意：targetSDKVersion>=23（android 6.0+）时，才会回调该事件）
  • didReceiveCallRemoteNotification: 接收到通话呼入的远程通知的事件 (android不支持)
  • didCancelCallRemoteNotification:接收到取消通话的远程通知的事件 (android不支持)

callback(ret)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    callSession:{}      //JSON对象；与getCallSession接口返回的参数一致，仅当 target 为 didReceiveCall 时有值
    remoteNoti:{        //JSON对象；音视频推送通知信息，仅当 target 为 didReceiveCallRemoteNotification 、didCancelCallRemoteNotification时有值
       callId:'',       //字符串类型；呼入通话的唯一值
       inviterUserId:'',//字符串类型；通话邀请者的UserId
       userIdList:[],   //数组类型；被邀请者的UserId列表
       mediaType:'',    //字符串类型；通话的媒体类型：audio、video
       userDict:{}      //JSON对象；远程推送包含的其他扩展信息，didReceiveCallRemoteNotification时不返回此值
    }
}

示例代码

var rong = api.require('rongCloud2');
rong.addCallReceiveListener({
    target:'didReceiveCall'
},function(ret){
     console.log(JSON.stringify(ret))
});

可用性

ios系统，Android系统

可提供的 3.1.7 及更高版本

removeCallReceiveListener

移除音视频来电事件监听

removeCallReceiveListener(params)

params

target:

• 类型：字符串
• 描述：要移除的来电监听的事件
• 默认：didReceiveCall
• 取值范围：
  • didReceiveCall:收到来电的事件
  • didReceiveCallRemoteNotification: 接收到通话呼入的远程通知的事件 (android不支持)
  • didCancelCallRemoteNotification:接收到取消通话的远程通知的事件 (android不支持)

示例代码

var rong = api.require('rongCloud2');
rong.removeCallReceiveListener({
    target:'didReceiveCall'
});

可用性

ios系统，Android系统

可提供的 3.1.7 及更高版本

startCall

发起音视频通话 (注：android上在发起语音通话时需要麦克风的权限，发起视频通话时需要相机的权限)

startCall(params)

params

targetId:

• 类型：字符串
• 描述：目标会话ID

conversationType:

• 类型：字符串
• 描述：（可选项）消息的会话类型，参见 会话类型

mediaType:

• 类型：字符串
• 描述：（可选项）发起的通话媒体类型
• 默认：audio
• 取值范围：
  • audio：音频
  • video：视频

userIdList:

• 类型：数组
• 描述：（可选项）邀请的用户 ID 列表，注意发起端不要传入自己的id
• 默认：[]

extra:

• 类型：字符串
• 描述：（可选项）附件信息

callback(ret)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    callSession:{}      //JSON对象；与getCallSession接口返回的参数一致(android回调中callSession中只有callId字段)
}

示例代码

var rong = api.require('rongCloud2');
rong.startCall({
    targetId:'didReceiveCall',
    mediaType:,
    conversationType:,
    extra:,
    userIdList
},function(ret){
     console.log(JSON.stringify(ret))
});

可用性

iOS系统，Android系统

可提供的 3.1.7 及更高版本

addCallSessionListener

音视频通话事件的监听

addCallSessionListener(params)

params

target:

• 类型：字符串
• 描述：要监听的事件
• 默认：didConnect
• 取值范围：
  • callOutgoing:电话已拨出事件(ios不支持)
  • didConnect:收通话已接通的事件
  • didDisconnect:通话已结束的事件 （注意：双人通话中Android对端挂断也会回调该事件）
  • remoteUserDidRing:对端用户正在振铃的事件
  • remoteUserDidInvite:有用户被邀请加入通话的事件
  • remoteUserDidJoin:对端用户加入了通话的事件
  • remoteUserDidChangeMediaType:对端用户切换了媒体类型的事件
  • remoteUserDidDisableCamera:对端用户开启或关闭了摄像头的状态的事件
  • remoteUserDidLeft:对端用户挂断
  • shouldAlertForWaitingRemoteResponse:彩铃事件(android不支持)
  • shouldRingForIncomingCall:来电铃声的事件(android不支持)
  • shouldStopAlertAndRing:停止播放铃声(通话接通或挂断)的事件(android不支持)
  • errorDidOccur:通话过程中的错误事件
  • networkTxQuality:当前通话网络状态，每两秒触发一次(android不支持)
  • networkSendLost:发送的丢帧率(ios不支持)
  • networkReceiveLost:接收的丢帧率(ios不支持)

callback(ret)

ret:

• 类型：JSON 对象
• 描述：监听事件返回，其中callOutgoing、callDidConnect、callDidDisconnect(android上会有disConnectReason参数回调)、shouldAlertForWaitingRemoteResponse、shouldRingForIncomingCall、shouldStopAlertAndRing只返回事件，无参数返回
• 内部字段：

{
    userId:''           //字符串类型；用户ID，仅当 target 为 remoteUserDidRing、remoteUserDidInvite 、remoteUserDidJoin、remoteUserDidChangeMediaType、remoteUserDidDisableCamera、remoteUserDidLeft时有值
    mediaType:''        //字符串类型；媒体类型，仅当 target 为 remoteUserDidInvite 、remoteUserDidJoin、remoteUserDidChangeMediaType时有值  
    disabled:           //布尔类型；是否关闭摄像头，仅当 target 为 remoteUserDidDisableCamera时有值  
    reason:             //数字类型；挂断原因，仅当 target 为 remoteUserDidLeft时有值 ，取值范围：1-9&11-20：
                        //己方取消已发出的通话请求、己方拒绝收到的通话请求、己方挂断、己方忙碌、己方未接听、己方不支持当前引擎、己方网络出错、己方摄像头初始化错误，可能是没有打开使用摄像头权限、其他端已经接听
                        //对方取消已发出的通话请求、对方拒绝收到的通话请求、通话过程对方挂断、对方忙碌、对方未接听、对方引擎不支持、对方网络错误、(ios)己方其他端已接听|(android)im ipc服务已断开、己方被加入黑名单(android不支持)、 己方被降级为观察者(android不支持)
    disConnectReason:   //数字类型；连接失败的原因；仅当target为didDisconnect时有值；取值范围：1:己方取消已发出的通话请求、2：己方拒绝收到的通话请求、3：己方挂断、4：己方忙碌、5：己方未接听、6：当前引擎不支持、7：己方网络出错、8：己方摄像头初始化错误，可能是没有打开使用摄像头权限、9：其他端已经接听、11：对方取消已发出的通话请求、12：对方拒绝收到的通话请求、13：通话过程对方挂断、14：对方忙碌、15：对方未接听、16：对方引擎不支持、17：对方网络错误、18：im ipc服务已断开
    errorCode:          //数字类型；错误码，errorDidOccur时返回；取值范围:0-10：成功、网络不可用、已经处于通话中了、无效操作、参数错误、网络不稳定、没提服务请求失败、媒体服务初始化失败、媒体服务未初始化、媒体服务请求超时、未知的媒体服务错误
    txQuality: ,        //数字类型；上行网络质量，(android不支持)networkTxQuality时返回，取值范围如下
    rxQuality:          //数字类型；下行网络质量，(android不支持)networkTxQuality时返回，，取值范围如下
                        //0：未知
                        //1：Excellent
                        //2：Good
                        //3：Poor
                        //4：Bad
                        //5：VBad
                        //6：Down
     sendLost:          //数字类型；发送丢帧率；networkSendLost时返回； (ios不支持)
     receiveLost        //数字类型；接收丢帧率；networkReceiveLost时返回；(ios不支持)

   startTime: 0,      //数字类型；通话开始时间； 挂断时有回调
   endTime: 0,        //数字类型；通话结束时间； 挂断时有回调
   callerUserId:''    //字符串；主叫用户id；接听或挂断时有回调

}

示例代码

var rong = api.require('rongCloud2');
rong.addCallSessionListener({
    target:'didConnect'
},function(ret){
     console.log(JSON.stringify(ret))
});

可用性

ios系统，Android系统

可提供的 3.1.7 及更高版本

removeCallSessionListener

移除音视频来电事件监听

removeCallSessionListener(params)

params

target:

• 类型：字符串
• 描述：要移除的来电监听的事件
• 默认：didConnect
• 取值范围：
  • callOutgoing:电话已拨出事件(ios不支持)
  • didConnect:收通话已接通的事件
  • didDisconnect:通话已结束的事件
  • remoteUserDidRing:对端用户正在振铃的事件
  • remoteUserDidInvite:有用户被邀请加入通话的事件
  • remoteUserDidJoin:对端用户加入了通话的事件
  • remoteUserDidChangeMediaType:对端用户切换了媒体类型的事件 (注:android上端在调用changeMediaType接口后会监听到此事件)
  • remoteUserDidDisableCamera:对端用户开启或关闭了摄像头的状态的事件
  • remoteUserDidLeft:对端用户挂断
  • shouldAlertForWaitingRemoteResponse:彩铃事件(android不支持)
  • shouldRingForIncomingCall:来电铃声的事件(android不支持)
  • shouldStopAlertAndRing:停止播放铃声(通话接通或挂断)的事件(android不支持)
  • errorDidOccur:通话过程中的错误事件
  • networkTxQuality:当前通话网络状态，每两秒触发一次 (android不支持)
  • networkSendLost:发送的丢帧率(ios不支持)
  • networkReceiveLost:接收的丢帧率(ios不支持)

示例代码

var rong = api.require('rongCloud2');
rong.removeCallSessionListener({
    target:'didConnect'
});

可用性

ios系统，Android系统

可提供的 3.1.7 及更高版本

getCallSession

获取当前通话实体，通话实体中维护着当前通话的所有信息。

getCallSession(callback(ret))

callback(ret)

ret：

• 类型：JSON对象
• 描述：当前通话实体
• 内部字段：

{
   conversationType:'',   //字符串类型；通话的会话类型
   callId:'',             //字符串类型；通话 ID
   targetId:'',           //字符串类型；通话的目标会话 ID
   multiCall:,            //布尔类型；是否是多方通话
   extra:'',              //字符串类型；通话的扩展信息
   callStatus:'',         //字符串类型；通话的当前状态 (android不支持)
   callerUserId:'',       //字符串类型；通话的最初发起人 ID
   inviterUserId:'',      //字符串类型；邀请当前用户加入通话的邀请者 ID
   observerUserList:[],   //数组类型；当前的用户列表
   selfUserId:'',         //字符串类型；自己的 ID
   mediaType:'',          //字符串类型；通话媒体类型：audio、video
   startTime: ,           //数字类型；呼入/呼出时间
   activeTime: ,          //数字类型；接通时间
   disconnectReason:'',   //字符串类型；通话挂断原因 (android不支持)
   endTime:,              //数字类型；结束时间，仅支持 android端
    callUserType:''        //字符串类型；用户类型； 1:NORMAL 2:OBSERVER，仅支持 android端
}

示例代码

var rong = api.require('rongCloud2');
rong.getCallSession(function(ret) {
    api.alert({msg:JSON.stringify(ret)});
});

可用性

iOS系统，Android系统

可提供的 3.1.7 及更高版本

isCallEnabled

判断当前是否支持音视频通话 (注:android上此接口用来判断音视频引擎是否可用)

isCallEnabled(params,callback(ret))

params

conversationType:

• 类型：字符串
• 描述：（可选项）消息的会话类型，参见 会话类型 (android不支持)

mediaType:

• 类型：字符串
• 描述：（可选项）发起的通话媒体类型 (android不支持)
• 默认：audio
• 取值范围：
  • audio：音频
  • video：视频

callback(ret)

ret：

• 类型：JSON对象
• 描述：当前通话实体
• 内部字段：

{
   enabled:      //布尔类型；是否支持
}

示例代码

var rong = api.require('rongCloud2');

var params = {
    conversationType:'',
    mediaType:'audio'
};
rong.isCallEnabled(params,function(ret){
if(ret.enabled)
alert('支持');
});

可用性

iOS系统

可提供的 3.1.7 及更高版本

setVideoProfile

设置本地视频属性，可用此接口设置本地视频分辨率，设置宽和高替换

setVideoProfile(params)

params

profile:

• 类型：字符串
• 描述：（可选项）通话视频参数
• 默认：480P
• 取值范围：
  • 240P:320x240, 15fps, 200kbps
  • 360P:480x360, 15fps, 350kbps
  • 480P:640x480, 15fps, 500kbps
  • 720P:1280x720, 15fps, 1000kbps

swapWidthAndHeight: 已废弃 - 类型：布尔 - 描述：（可选项）是否交换宽和高 (android不支持) - 默认：false

fps:

• 类型：数字
• 描述：帧率
• 默认：15
• 取值：
  • 10
  • 15
  • 24
  • 30

cameraDisplayOrientation:

• 类型：数字
• 描述：相机旋转角度
• 默认：-1
• 取值：
  • -1
  • 0
  • 90
  • 180
  • 270

示例代码

var rong = api.require('rongCloud2');
rong.setVideoProfile({
    swapWidthAndHeight:true,
    profile:'480P'
});

可用性

iOS系统，Android系统

可提供的 3.1.7 及更高版本

setEnableBeauty

设置本地视频属性，是否使用默认美颜

setEnableBeauty(params)

params

enableBeauty:

• 类型：布尔
• 描述：（可选项）是否使用美颜
• 默认：false

示例代码

var rong = api.require('rongCloud2');
rong.setEnableBeauty({
    enableBeauty:true
});

可用性

iOS系统，Android系统

可提供的 3.1.7 及更高版本

accept

设接听来电

accept(params)

params

mediaType:

• 类型：字符串
• 描述：（可选项）接听使用的媒体类型 (android不支持)
• 默认：audio
• 取值范围：
  • audio：音频
  • video：视频

callId :

• 类型: 字符串
• 描述：呼叫id (ios不支持)

示例代码

var rong = api.require('rongCloud2');
rong.accept({
    mediaType:'audio'
});

可用性

iOS系统，Android系统

可提供的 3.1.7 及更高版本

hangup

挂断

hangup()

示例代码

var rong = api.require('rongCloud2');
rong.hangup();

可用性

iOS系统，Android系统

可提供的 3.1.7 及更高版本

addParticipants

邀请用户加入当前通话 （仅限讨论组和群组）

addParticipants(params)

params

userIds:

• 类型：数组类型
• 描述：邀请的用户 ID 列表

observerUserIds:

• 类型：数组类型
• 描述：邀请的观察者列表,没有观察者可以不传(iOS不支持)
• 默认值：空

示例代码

var rong = api.require('rongCloud2');

var params = {
        userIds : ['1234', '0000']
};
rong.addParticipants(params);

可用性

iOS系统，Android系统

可提供的 3.1.7 及更高版本

setVideoView

打开视频区域 （注意：Android如果设置对方窗口时，需要监听到 remoteUserDidJoin 事件之后设置，否则可能导致窗口无法显示的问题）

setVideoView({params})

params

rect：

• 类型：JSON 对象
• 描述：（可选项）视频的位置及尺寸
• 内部字段：

{
    x: 0,   //（可选项）数字类型；地图左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认：0
    y: 0,   //（可选项）数字类型；地图左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认：0
    w: 320, //（可选项）数字类型；地图的宽度；默认：'auto'
    h: 480  //（可选项）数字类型；地图的高度；默认：'auto'
}

userId：

• 类型：字符串
• 描述：用户 ID

renderModel：

• 类型：字符串
• 描述：（可选项）设视频显示模式 (android不支持)
• 默认值：adaptive
• 取值范围:
  • hidden：如果视频尺寸与显示视窗尺寸不一致，则视频流会按照显示视窗的比例进行周边裁剪或图像拉伸后填满视窗
  • fit:如果视频尺寸与显示视窗尺寸不一致，在保持长宽比的前提下，将视频进行缩放后填满视窗
  • adaptive:如果自己和对方都是竖屏，或者如果自己和对方都是横屏，使用hidden，如果对方和自己一个竖屏一个横屏，则使用fit

bg：

• 类型：字符串
• 描述：（可选项）背景配置，支持rgb、rgba()、#、img（本地路径）
• 默认值：#000000

isMirror:

• 类型：布尔
• 描述：是否设置镜像(该参数仅支持Android)
• 默认：true

fixedOn：

• 类型：字符串类型
• 描述：（可选项）视频视图添加到指定 frame 的名字（只指 frame，传 window 无效）
• 默认：插件依附于当前 window

fixed:

• 类型：布尔
• 描述：（可选项）视频是否随所属 window 或 frame 滚动
• 默认值：true（不随之滚动）

示例代码

var rong = api.require('rongCloud2');
rong.setVideoView({
    rect: {
        x: 0,
        y: 0,
        w: 320,
        h: 300
    },
    bg: '#ff0000',
    renderModel: 'fit',
    fixedOn: api.frameName,
    fixed: true
});

可用性

iOS系统，Android系统

可提供的3.1.7及更高版本

resetVideoView

重设打开的视频区域

resetVideoView({params},callback(ret,err))

params

rect：

• 类型：JSON 对象
• 描述：（可选项）视频的位置及尺寸
• 内部字段：

{
    x: 0,   //（可选项）数字类型；地图左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认：0
    y: 0,   //（可选项）数字类型；地图左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认：原值
    w: 320, //（可选项）数字类型；地图的宽度；默认：'auto'
    h: 480  //（可选项）数字类型；地图的高度；默认：'auto'
}

userId：

• 类型：字符串
• 描述：用户 ID

renderModel：

• 类型：字符串
• 描述：（可选项）设视频显示模式 (android不支持)
• 默认值：adaptive
• 取值范围:
  • hidden：如果视频尺寸与显示视窗尺寸不一致，则视频流会按照显示视窗的比例进行周边裁剪或图像拉伸后填满视窗
  • fit:如果视频尺寸与显示视窗尺寸不一致，在保持长宽比的前提下，将视频进行缩放后填满视窗
  • adaptive:如果自己和对方都是竖屏，或者如果自己和对方都是横屏，使用hidden，如果对方和自己一个竖屏一个横屏，则使用fit

bg：

• 类型：字符串
• 描述：（可选项）背景配置，支持rgb、rgba()、#、img（本地路径）
• 默认值：#000000

animationDuration：

• 类型：数字类型
• 描述：（可选项）改变位置大小时添加的动画效果时长，为负数或0时表示没动画效果
• 默认值：-1

callback(ret,err)

ret：

• 类型：JSON对象
• 描述：当前通话实体
• 内部字段：

{
   enabled:      //布尔类型；是否设置成功
}

err：

• 类型：JSON 对象
• 描述：回调
• 内部字段：

{
    code: 1   //数字类型；错误码，取值范围：
              //1：userID为空
              //2：viewView不存在（尚未setVideoView初始化）
}

示例代码

var rong = api.require('rongCloud2');
rong.resetVideoView({
    rect: {
        x: 0,
        y: 0,
        w: 320,
        h: 300
    },
    bg: '#ff0000',
    renderModel: 'fit'
});

可用性

iOS系统，Android系统

可提供的3.1.7及更高版本

videoViewBringToFront

将指定画面窗口从其父窗口带到最上层显示

videoViewBringToFront({params},callback(ret,err))

params

userId：

• 类型：字符串
• 描述：用户 ID

callback(ret,err)

callback(ret)

ret：

• 类型：JSON对象
• 描述：当前通话实体
• 内部字段：

{
   enabled:      //布尔类型；是否设置成功
}

err：

• 类型：JSON 对象
• 描述：回调
• 内部字段：

{
    code: 1   //数字类型；错误码，取值范围：
              //1：userID为空
              //2：viewView不存在（尚未setVideoView初始化）
}

示例代码

var rong = api.require('rongCloud2');
rong.videoViewBringToFront({
    userId: ''
});

可用性

iOS系统，Android系统

可提供的3.2.1及更高版本

removeVideoView

关闭移除打开的视频区域

removeVideoView({params})

params

userId：

• 类型：字符串
• 描述：用户 ID

示例代码

var rong = api.require('rongCloud2');
rong.removeVideoView({
    userId: 'a2'
});

可用性

iOS系统，Android系统

可提供的3.1.7及更高版本

addVideoViewListener

添加视频区域的监听

addVideoViewListener(callback(ret))

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回监听事件
• 内部字段：

{
  userId: ''  //字符串类型；单击的用户ID
}

示例代码

var rong = api.require('rongCloud2');
rong.addVideoViewListener(function(ret){
    api.alert(JSON.stringify(ret));
});

可用性

iOS系统，Android系统

可提供的3.1.7及更高版本

changeMediaType

改变当前通话的媒体类型

changeMediaType({params})

params

mediaType:

• 类型：字符串
• 描述：（可选项）接听使用的媒体类型
• 默认：audio
• 取值范围：
  • audio：音频
  • video：视频

示例代码

var rong = api.require('rongCloud2');
rong.changeMediaType({
    mediaType: 'audio'
});

可用性

iOS系统，Android系统

可提供的3.1.7及更高版本

isMuted

是否是静音

isMuted(callback(ret))

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口
• 内部字段：

{
  isMuted:   //布尔类型；是否静音
}

示例代码

var rong = api.require('rongCloud2');
rong.isMuted(function(ret){
    if(ret.isMuted)  alert('静音')
});

可用性

iOS系统

可提供的3.1.7及更高版本

setMuted

设置静音

setMuted({params},callback(ret))

params

muted:

• 类型：布尔
• 描述：（可选项）是否静音
• 默认：false

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口 (android不支持)
• 内部字段：

{
  status:   //布尔类型；是否设置成功
}

示例代码

var rong = api.require('rongCloud2');
rong.setMuted({
    muted: true
},function(ret){
  if(ret.status) alert("设置成功");
});

可用性

iOS系统，Android系统

可提供的3.1.7及更高版本

speakerEnabled

是否打开扬声器

speakerEnabled(callback(ret))

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口 (android不支持)
• 内部字段：

{
  speakerEnabled:   //布尔类型；是否是扬声器播放
}

示例代码

var rong = api.require('rongCloud2');
rong.speakerEnabled(function(ret){
    if(ret.speakerEnabled)  alert('扬声器')
});

可用性

iOS系统

可提供的3.1.7及更高版本

setSpeakerEnabled

设置扬声器状态

setSpeakerEnabled({params},callback(ret))

params

speakerEnabled:

• 类型：布尔
• 描述：（可选项）是否开启扬声器
• 默认：false

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口 (android不支持)
• 内部字段：

{
  status:   //布尔类型；是否设置成功
}

示例代码

var rong = api.require('rongCloud2');
rong.setSpeakerEnabled({
    speakerEnabled: true
},function(ret){
  if(ret.status) alert('设置成功');
});

可用性

iOS系统，Android系统

可提供的3.1.7及更高版本

cameraEnabled

是否开启摄像头

cameraEnabled(callback(ret))

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口
• 内部字段：

{
  cameraEnabled:   //布尔类型；是否开启摄像头
}

示例代码

var rong = api.require('rongCloud2');
rong.cameraEnabled(function(ret){
    if(ret.cameraEnabled)  alert('扬声器')
});

可用性

iOS系统

可提供的3.1.7及更高版本

setCameraEnabled

设置打开摄像头

setCameraEnabled({params},callback(ret))

params

cameraEnabled:

• 类型：布尔
• 描述：（可选项）是否打开摄像头
• 默认：false

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口 (android不支持)
• 内部字段：

{
  status:   //布尔类型；是否设置成功
}

示例代码

var rong = api.require('rongCloud2');
rong.setCameraEnabled({
    cameraEnabled: true
},function(ret){
  if(ret.status) alert('设置成功');
});

可用性

iOS系统，Android系统

可提供的3.1.7及更高版本

switchCameraMode

切换摄像头

switchCameraMode(callback(ret))

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口 (android不支持)
• 内部字段：

{
  status:   //布尔类型；是否切换成功
}

示例代码

var rong = api.require('rongCloud2');
rong.switchCameraMode(function(ret){
  if(ret.status) alert('切换成功');
});

可用性

iOS系统，Android系统

可提供的3.1.7及更高版本

startAudioRecording

开始声音录制，目前只支持录制wav格式音频文件, 请给出完整沙盒路径+文件名

startAudioRecording({params},callback(ret))

params

filePath:

• 类型：字符串
• 描述：录制文件保存路径

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口 (android不支持)
• 内部字段：

{
  status:   //数字类型；设置结果
            //-1:路径错误
}

示例代码

var rong = api.require('rongCloud2');
rong.startAudioRecording({
    filePath: 'fs://123.wav'
},function(ret){
  if(ret.status) alert('设置成功');
});

可用性

iOS系统，Android系统

可提供的3.1.7及更高版本

stopAudioRecording

停止录音

stopAudioRecording(callback(ret))

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口 (android不支持)
• 内部字段：

{
  status:   //布尔类型；是否停止成功
}

示例代码

var rong = api.require('rongCloud2');
rong.stopAudioRecording(function(ret){
  if(ret.status) alert('停止成功');
});

可用性

iOS系统，Android系统

可提供的3.1.7及更高版本

setBeauty

打开美颜

setBeauty({params})

params

enable:

• 类型：布尔
• 描述：（可选项）是否开启美颜
• 默认：true

whitenessLevel:

• 类型：数字
• 描述：（可选项）美白，取值范围 [0 ~ 9] 0是正常值
• 默认：0

smoothLevel:

• 类型：数字
• 描述：（可选项）磨皮，取值范围 [0 ~ 9] 0是正常值
• 默认：0

ruddyLevel:

• 类型：数字
• 描述：（可选项）红润，取值范围 [0 ~ 9] 0是正常值
• 默认：0

brightLevel:

• 类型：数字
• 描述：（可选项）亮度，取值范围 [0 ~ 9] 5是正常值
• 默认：5

示例代码

var rong = api.require('rongCloud2');
rong.setBeauty({
    enable: true,
    brightLevel: 6,
    ruddyLevel: 5,
    smoothLevel: 6,
    whitenessLevel: 6
});

可用性

iOS系统，Android系统

可提供的3.4.0及更高版本

setBeautyFilter

设置滤镜

setBeautyFilter({params})

params

filter:

• 类型：字符串
• 描述：（可选项）滤镜
• 默认：none
• 取值范围：
  • none：原图
  • esthetic：唯美
  • fresh：清新
  • romantic：浪漫

示例代码

var rong = api.require('rongCloud2');
rong.setBeautyFilter({
    filter: 'fresh'
});

可用性

iOS系统，Android系统

可提供的3.4.0及更高版本

resetBeauty

重置美颜和滤镜，重置后所有参数恢复默认值 whitenessLevel = 0 smoothLevel = 0 ruddyLevel = 0 brightLevel = 5 filter = none

resetBeauty()

示例代码

var rong = api.require('rongCloud2');
rong.resetBeauty();

可用性

iOS系统，Android系统

可提供的3.4.0及更高版本

getCurrentBeautyOption

获取当前美颜参数

getCurrentBeautyOption(callback(ret))

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口
• 内部字段：

{
  whitenessLevel:,  //数字类型；美白
  smoothLevel:,     //数字类型；磨皮
  ruddyLevel:,      //数字类型；红润
  brightLevel:,     //数字类型；亮度
}

示例代码

var rong = api.require('rongCloud2');
rong.getCurrentBeautyOption(function(ret){
  api.alert({msg:JSON.stringify(ret)});
});

可用性

iOS系统，Android系统

可提供的3.4.0及更高版本

getCurrentBeautyFilter

获取当前滤镜

getCurrentBeautyFilter(callback(ret))

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口
• 内部字段：

{
  filter:    //字符串类型；取值范围
             //esthetic
             //fresh
             //romantic
             //none
}

示例代码

var rong = api.require('rongCloud2');
rong.getCurrentBeautyFilter(function(ret){
  api.alert({msg:JSON.stringify(ret)});
});

可用性

iOS系统，Android系统

可提供的3.4.0及更高版本

getBeautyEngineVersion

获取美颜引擎版本号

getBeautyEngineVersion(callback(ret))

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回接口
• 内部字段：

{
  version:    //字符串类型； 美颜引擎版本号
}

示例代码

var rong = api.require('rongCloud2');
rong.getBeautyEngineVersion(function(ret){
  api.alert({msg:JSON.stringify(ret)});
});

可用性

iOS系统，Android系统

可提供的3.4.0及更高版本

createDiscussion

创建讨论组

注意：有关讨论组的7个接口已废弃

createDiscussion({params}, callback(ret, err))

params

name:

• 类型：字符串
• 描述：讨论组名称，如：当前所有成员的名字的组合。

userIdList:

• 类型：字符串数组
• 描述：讨论组成员 Id 列表

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success', // 状态码：success / error
    result: {
        discussionId: "1b9f7abe-a5ae-463d-8ff8-d96deaf40b59" // 创建成功的讨论组 Id
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.createDiscussion({
    name: 'Ironman, Batman',
    userIdList: ['1234', '4321']
}, function(ret, err) {
    if (ret.status == 'success')
        api.toast({ msg: ret.result.discussionId });
    else
        api.toast({ msg: err.code });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

getDiscussion

获取讨论组信息和设置

getDiscussion({params}, callback(ret, err))

params

discussionId:

• 类型：字符串
• 描述：讨论组 Id

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success', // 状态码：success / error
    result: {
        creatorId: '55', // 讨论组创建者 Id
        id: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59', //讨论组 Id
        name: 'Ironman, Batman', // 讨论组名称
        memberIdList: [ '1234', '4321' ], // 成员 Id 列表
        inviteStatus: 'OPENED' // 是否公开好友邀请：OPENED / CLOSED，参见 讨论组邀请状态
    }
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.getDiscussion({
    discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59'
}, function(ret, err) {
    if (ret.status == 'success')
        api.toast({ msg: JSON.stringify(ret.result.discussion) });
    else
        api.toast({ msg: err.code });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

setDiscussionName

设置讨论组名称

setDiscussionName({params}, callback(ret, err))

params

discussionId:

• 类型：字符串
• 描述：讨论组 Id

name:

• 类型：字符串
• 默认值：无
• 描述：讨论组名称

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.setDiscussionName({
    discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59',
    name: 'Ironman, Hulk'
}, function(ret, err) {
    if (ret.status == 'success')
        api.toast({ msg: JSON.stringify(ret.status) });
    else
        api.toast({ msg: err.code });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

addMemberToDiscussion

添加一名或者一组用户加入讨论组

addMemberToDiscussion({params}, callback(ret, err))

params

discussionId:

• 类型：字符串
• 描述：讨论组 Id

userIdList:

• 类型：字符串数组
• 描述：邀请的用户 Id 列表

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.addMemberToDiscussion({
    discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59',
    userIdList: ['4567', '7654']
}, function(ret, err) {
    if (ret.status == 'success')
        api.toast({ msg: JSON.stringify(ret.status) });
    else
        api.toast({ msg: err.code });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

removeMemberFromDiscussion

供创建者将某用户移出讨论组

移出自己或者调用者非讨论组创建者将产生 -1 未知错误

removeMemberFromDiscussion({params}, callback(ret, err))

params

discussionId:

• 类型：字符串
• 描述：讨论组 Id

userId:

• 类型：字符串
• 描述：用户 Id

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.removeMemberFromDiscussion({
    discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59',
    userId: '4567'
}, function(ret, err) {
    if (ret.status == 'success')
        api.toast({ msg: JSON.stringify(ret.status) });
    else
        api.toast({ msg: err.code });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

quitDiscussion

退出当前用户所在的某讨论组

quitDiscussion({params}, callback(ret, err))

params

discussionId:

• 类型：字符串
• 默认值：无
• 描述：讨论组 Id

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.quitDiscussion({
    discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59'
}, function(ret, err) {
    if (ret.status == 'success')
        api.toast({ msg: JSON.stringify(ret.status) });
    else
        api.toast({ msg: err.code });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

setDiscussionInviteStatus

设置讨论组成员邀请权限

setDiscussionInviteStatus({params}, callback(ret, err))

params

discussionId:

• 类型：字符串
• 描述：讨论组 Id

inviteStatus:

• 类型：字符串
• 描述：邀请状态，默认为开放，参见 讨论组邀请状态

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.setDiscussionInviteStatus({
    discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59',
    inviteStatus: 'OPENED'
}, function(ret, err) {
    if (ret.status == 'success')
        api.toast({ msg: JSON.stringify(ret.status) });
    else
        api.toast({ msg: err.code });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

syncGroup

同步当前用户所属的群组信息到融云服务器

注意：此方法已废弃，建议您通过您的App Server进行群组操作。 群组操作的流程，可以参考：http://support.rongcloud.cn/kb/MzY5

syncGroup({params}, callback(ret, err))

params

groups:

• 类型：JSON 对象数组
• 描述：讨论组 Id

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明：

示例代码

var rong = api.require('rongCloud2');

// 之前调用 init 和 connect 的代码省略
rong.syncGroup({
    groups: [{
        groupId: '123',
        groupName: 'Ski Club',
        portraitUrl: 'http://club.com/ski.jpg'
    }, {
        groupId: '456',
        groupName: 'Diving Club',
        portraitUrl: 'http://club.com/diving.jpg'
    }]
}, function(ret, err) {
    if (ret.status == 'success')
        api.toast({ msg: JSON.stringify(ret.status) });
    else
        api.toast({ msg: err.code });
})

可用性

iOS系统，Android系统

可提供的 1.1.0 及更高版本

joinGroup

当前用户加入某群组

注意：此方法已废弃，建议您通过您的App Server进行群组操作。 群组操作的流程，可以参考：http://support.rongcloud.cn/kb/MzY5

joinGroup({params}, callback(ret, err))

params

groupId:

• 类型：字符串
• 描述：群组 Id

groupName:

• 类型：字符串
• 描述：群组名称

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：操作结果
• 内部字段：

{
    status: 'success' // 状态码：success / error
}

err:

• 类型：JSON 对象
• 内部字段：

{
    code: 30003
}

状态码说明：