发送消息
本文介绍了 IMLib 如何发送消息。
客户端 SDK 发送消息存在频率限制,每秒最多只能发送 5 条消息。
发送普通消息
开发者在发送文本消息、引用消息、自定义消息时,可以使用下面接口发送。
方法
sendMessage(
message: RCIMIWMessage,
callback: RCIMIWSendMessageCallback
): Promise<number>;
参数说明
参数名 | 参数类型 | 描述 |
---|---|---|
message | RCIMIWMessage | 发送的消息实体 |
callback | RCIMIWSendMessageCallback | 接口调用结果回调。 |
返回值
返回值 | 描述 |
---|---|
number | 当次接口操作的状态码。0 代表调用成功 具体 结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码 |
代码示例
const callback = {
onMessageSaved: (message: RCIMIWMessage) => {
//...
},
onMessageSent: (code: number, message: RCIMIWMessage) => {
//...
},
};
let code = await engine.sendMessage(message, callback);
发送媒体消息
开发者在发送图片消息、语音消息、视频消息、文件消息、GIF 消息时,可以使用下面接口发送。
方法
sendMediaMessage(
message: RCIMIWMediaMessage,
listener: RCIMIWSendMediaMessageListener
): Promise<number>;
参数说明
参数名 | 参数类型 | 描述 |
---|---|---|
message | RCIMIWMediaMessage | 发送的媒体消息实体 |
listener | RCIMIWSendMediaMessageListener | 发送媒体消息的事件监听 |
返回值
返回值 | 描述 |
---|---|
number | 当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码 |
代码示例
const listener = {
onMediaMessageSaved: (message: RCIMIWMediaMessage) => {
currentSendingMediaMessage = message;
//...
},
onMediaMessageSending: (message: RCIMIWMediaMessage, progress: number) => {
//...
},
onSendingMediaMessageCanceled: (message: RCIMIWMediaMessage) => {
//...
},
onMediaMessageSent: (code: number, message: RCIMIWMediaMessage) => {
//...
},
};
let code = await engine.sendMediaMessage(message, listener);
如何处理消息发送失败
对于客户端本地会存储的消息类型(参见消息介绍),如果触发消息入库的回调(onMessageSaved / onMediaMessageSaved),表示此时该消息已存入本地数据库,并已进入本地消息列表。
- 如果入库成功后消息发送失败(未能触发 onMessageSent / onMediaMessageSent),App 可以在 UI 临时展示这条发送失败的消息,并缓存 onMessageSaved 抛出的消息实例,在合适的时机重新调用 sendMessage / sendMediaMessage 发送。请注意,如果不复用该消息实例,而是重发相同内容的新消息,本地消息列表中会存储内容重复的两条消息。
- 如果入库失败,您可以检查参数是否合法,设备存储是否可正常写入。
对于客户端本地不存储的消息,如果发送失败(未能触发 onMessageSent/onMediaMessageSent),App 可缓存消息实例再重试发送,或直接新建消息实例进行发送。
如何实现转发、群发消息
转发消息:IMLib SDK 未提供转发消息接口。App 实现转发消息效果时,可调用发送消息接口发送。
群发消息:群发消息是指向多个用户发送消息。更准确地说,是向多个 Target ID?发送消息,一个 Target ID 可能代表一个用户,一个群组,或一个聊天室。客户端 SDK 未提供直接实现群发消息效果的 API。您可以考虑以下实现方式: