发送消息
本文介绍了 IMLib 如何发送消息。
客户端 SDK 发送消息存在频率限制,每秒最多只能发送 5 条消息。
前置条件
在发送消息前,需完成以下前置条件:
一、完成 SDK 初始化
需先完成融云 SDK 的初始化配置,确保应用已正确集成融云服务并完成基础参数设置(如 App Key 等)。具体操作请参考《 SDK 初始化指南》。
二、建立与融云服务端的连接
确保客户端已通过有效 Token 成功连接至融云服务端。连接状态可通过监听 SDK 提供的连接状态回调判断。若连接失败,需排查 Token 有效性、网络环境等问题。
三、创建待发送的消息实体
根据消息类型(如文本、图片、语音等),创建对应的消息对象。具体可参考消息介绍,了解各类消息的构造方法及参数要求(如 RCIMIWTextMessage 的文本内容、RCIMIWImageMessage 的图片路径等)。
完成以上步骤后, 方可调用融云 SDK 的消息发送接口(如 sendMessage)执行消息发送操作。
发送普通消息
开发者在发送文本消息、引用消息、自定义消息时,可以使用下面接口发送。
方法
TypeScript
sendMessage(
message: RCIMIWMessage,
callback: RCIMIWSendMessageCallback
): Promise<number>;
参数说明
参数名 | 参数类型 | 描述 |
---|---|---|
message | RCIMIWMessage | 发送的消息实体 |
callback | RCIMIWSendMessageCallback | 发送消息的事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。 |
返回值
返回值 | 描述 |
---|---|
Promise<number> | 当次接口操作的状态码。0 代表接口调用成功,具体业务结果需要从接口回调获取,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考状态码文档。 |
代码示例
TypeScript
let callback = {
onMessageSaved:(res) => {
//...
},
onMessageSent:(res) => {
//...
}};
let code = await engine.sendMessage(message, callback);
发送媒体消息
开发者在发送图片消息、语音消息、视频消息、文件消息、GIF 消息时,可以使用下面接口发送。
方法
TypeScript
sendMediaMessage(
message: RCIMIWMediaMessage,
listener: RCIMIWSendMediaMessageListener
): Promise<number>;
参数说明
参数名 | 参数类型 | 描述 |
---|---|---|
message | RCIMIWMediaMessage | 发送的媒体消息实体 |
listener | RCIMIWSendMediaMessageListener | 发送媒体消息的事件监听 |
返回值
返回值 | 描述 |
---|---|
Promise<number> | 当次接口操作的状态码。0 代表接口调用成功,具体业务结果需要从接口回调获取,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考状态码文档。 |