跳到主要内容

搜索消息

根据关键字搜索

根据关键字搜索指定会话中的消息

方法

int searchMessages(
RCIMConversationType type,
string targetId,
string channelId,
string keyword,
int startTime,
int count
)

参数说明

参数类型说明
typeRCIMConversationType会话类型
targetIdstring会话ID
channelIdstring暂不支持该参数。传 null 即可
keywordstring搜索的关键字
startTimeint查询 beginTime 之前的消息, 传 0 时从最新消息开始搜索,从该时间往前搜索。
countint查询的数量,count 大于 0,小于等于 50。

返回值

返回值描述
int当次接口操作状态码,并不代表最终操作结果,状态码详细信息

代码示例

int code = engine.searchMessages(
type,
targetId,
channelId,
keyword,
startTime,
count
);

回调方法

  • onMessagesSearched 接口调用结果的监听
delegate void OnMessagesSearchedDelegate(
int code,
RCIMConversationType type,
string targetId,
string channelId,
string keyword,
long startTime,
int count,
List<RCIMMessage> messages);

OnMessagesSearchedDelegate onMessagesSearched;

参数说明

参数名参数类型描述
codeint接口回调的状态码,0 代表成功,非 0 代表出现异常
typeRCIMConversationType调用接口时传入的会话类型
targetIdstring调用接口时传入的会话ID
channelIdstring调用接口时传入的频道 ID
keywordstring调用接口时传入的关键字
startTimeint调用接口时传入的时间戳
countint调用接口时传入的数量
messagesList<RCIMMessage>查询到的消息集合

代码示例

engine.onMessagesSearched = delegate(
int code,
RCIMConversationType type,
string targetId,
string channelId,
string keyword,
int startTime,
int count,
List<RCIMMessage> messages
)
{

};

根据关键字搜索指定会话中某个时间段的消息

方法

int searchMessagesByTimeRange(
RCIMConversationType type,
string targetId,
string channelId,
string keyword,
int startTime,
int endTime,
int offset,
int count
)

参数说明

参数名类型
typeRCIMConversationType会话类型
targetIdstring会话ID
channelIdstring暂不支持该参数。传 null 即可
keywordstring关键字
startTimeint开始时间
endTimeint结束时间
offsetint偏移量
countint搜索结果数量,count 大于 0,小于等于 50。

返回值

返回值描述
int当次接口操作状态码,并不代表最终操作结果,状态码详细信息

代码示例

int code = engine.searchMessagesByTimeRange(
type,
targetId,
channelId,
keyword,
startTime,
endTime,
offset,
count
)

回调方法

  • onMessagesSearchedByTimeRange
delegate void OnMessagesSearchedByTimeRangeDelegate(int code,
RCIMConversationType type,
string targetId,
string channelId,
string keyword,
long startTime,
long endTime,
int offset,
int count,
List<RCIMMessage> messages);

OnMessagesSearchedByTimeRangeDelegate onMessagesSearchedByTimeRange;

参数说明

参数名参数类型描述
codeint接口回调的状态码,0 代表成功,非 0 代表出现异常
typeRCIMConversationType调用接口时传入的会话类型
targetIdstring调用接口时传入的会话ID
channelIdstring调用接口时传入的频道 ID
keywordstring调用接口时传入的关键字
startTimeint调用接口时传入的开始时间
endTimeint调用接口时传入的结束时间
offsetint调用接口时传入的偏移量
countint调用接口时传入的搜索数量
messagesList<RCIMMessage>搜索到的消息集合

代码示例

engine.onMessagesSearchedByTimeRange = delegate (
int code,
RCIMConversationType type,
string targetId,
string channelId,
string keyword,
int startTime,
int endTime,
int offset,
int count,
List<RCIMMessage> messages
)
{

}

根据用户 id 搜索指定会话中的消息

方法

int searchMessagesByUserId(
string userId,
RCIMConversationType type,
string targetId,
string channelId,
int startTime,
int count
)

参数说明

参数名类型
userIdstring用户ID
typeRCIMConversationType会话类型
targetIdstring会话ID
channelIdstring暂不支持该参数。传 null 即可。
startTimeint查询记录的起始时间, 传 0 时从最新消息开始搜索,从该时间往前搜索。
countint搜索结果数量,count 大于 0,小于等于 50。

返回值

返回值描述
int当次接口操作状态码,并不代表最终操作结果,状态码详细信息

代码示例

int code = engine.searchMessagesByUserId(
userId,
type,
targetId,
channelId,
startTime,
count
);

回调方法

  • onMessagesSearchedByUserId

    接口调用结果的监听

delegate void OnMessagesSearchedByUserIdDelegate(int code,
string userId,
RCIMConversationType type,
string targetId,
string channelId,
long startTime,
int count,
List<RCIMMessage> messages);

OnMessagesSearchedByUserIdDelegate onMessagesSearchedByUserId;

参数说明

参数名参数类型描述
codeint接口回调的状态码,0 代表成功,非 0 代表出现异常
userIdstring调用接口时传入的用户ID
typeRCIMConversationType调用接口时传入的会话类型
targetIdstring调用接口时传入的会话ID
channelIdstring调用接口时传入的频道 ID
startTimeint调用接口时传入的时间戳
countint调用接口时传入的搜索数量
messagesList<RCIMMessage>搜索的消息集合

代码示例

engine.onMessagesSearchedByUserId = delegate(
int code,
string userId,
RCIMConversationType type,
string targetId,
string channelId,
int startTime,
int count,
List<RCIMMessage> messages
)
{

}