消息交互API参考说明 - Android

主要方法

初始化 (EVMessage)

public EVMessage(Context context)

该方法创建EVMessage对象

设置回调（setMessageCallback）

public void setMessageCallback(MessageCallback callback)

设置消息系统回调函数。消息系统运行过程中各种事件的回调，包括网络连接、发送消息、接收消息等事件的回调。MessageCallback的定义详见下方回调事件中的描述

连接（connect）

public void connect(String channel)

连接房间，频道号channel字符串由上层业务指定，一般以视频唯一id作为房间号

发送消息（send）

public void send(String channel, String message, String userdata, String type,
                     MyRequestCallBack<String> callBack)

该方法用于发送消息，消息级别、是否保存、是否过滤等设置使用默认值。参数说明如下：

发送消息（sendMsg）

public void sendMsg(String channel, String message, String userdata, String type, int level,
                        boolean save, boolean filter, MyRequestCallBack<String> callBack)

该方法是send方法的高级版本，可以指定消息级别、是否保存、是否过滤等。参数说明如下：

获取最近N条历史消息（getLastHistoryMsgs）

public void getLastHistoryMsgs(String channel, int count, String type)

该方法用于获取最近的N条历史消息，第一次获取历史消息时使用。

获取从指定位置开始的N条历史消息（getHistoryMsgs）

public void getHistoryMsgs(String channel, int start, int count, String type)

该方法用于获取从指定位置开始的N条历史消息，当start为0时，和getLastHistoryMsgs方法效果相同

关闭（close）

public void close()

退出聊天交互界面时调用该函数，关闭网络连接，停止接收消息。

回调事件（MessageCallback）

MessageCallback接口类用于消息SDK向应用程序发送回调事件通知，应用程序通过该接口类的方法获取SDK的事件通知。

连接成功回调（onConnected）

void onConnected()

表示客户端已经加入聊天交互房间，房间id是connect方法中指定的房间id。

接收到消息回调（onNewMessage）

void onNewMessage(final String message, final String userdata, final String userid,
                      final String channel, final String type)

表示收到交互房间中的新消息，参数说明如下：

历史消息回调（onHistoryMessage）

void onHistoryMessage(final List<MsgInfoEntity> msgs, final int next, final int count)

调用获取历史消息的异步回调通知，参数说明如下：

用户进入回调（onUserJoin）

void onUserJoin(final List<String> users)

表示房间中有用户加入。

用户离开回调（onUserLeave）

void onUserLeave(final List<String> users)

表示房间中有用户离开。

正在观看人数回调（onWatchingCount）

void onWatchingCount(int watchingCount)

房间实时观看人数有变化会回调该方法。

已观看人数回调（onWatchedCount）

void onWatchedCount(int watchedCount)

房间已经观看人数有变化回调该方法。

错误回调（onError）

void onError(final int errCode)

用户互动过程中发生错误，回调该方法。错误码详情：

重连回调（onReconnecting）

void onReconnecting()

由于网络原因，客户端可能会和消息服务器失去连接，互动消息SDK会进行自动重连，开始重连时触发此回调方法。

重连成功回调（onReconnected）

void onReconnected()

互动消息SDK内部重连成功后触发此回调方法。

重连失败回调（onReconnectFailed）

void onReconnectFailed()

互动消息SDK内部不会无限重连，当重连次数超过一定限制还未连接上消息服务器，会触发重连失败回调。

连接断开回调（onClose）

void onClose()

客户端和消息服务器连接断开会触发此回调。