发送群消息
更新时间: 2024/07/17 17:57:35
在群组(高级群)内发送消息的服务端 API 与发送单聊消息的 API 相同(msg/sendMsg.action
)。该 API 通过ope
参数区分发送的为单聊消息还是群聊消息。
本文介绍如何通过该 API 发送群聊消息,并在 SDK 端成功接收。
API 使用限制
单个应用中 1 秒内默认最多调用该 API 100 次。如超限,将被屏蔽 10 秒。
前提条件
通过 IM 服务端 API 发送群消息前,请确保:
- 已通过 IM 服务端 API 或者 SDK API 创建高级群,获取群 ID。
- 群聊消息发送方和接收方已加入同一高级群。
实现群聊消息收发
时序图
以下时序图仅以 “发送方为高级群创建者,且创建群组和拉人入群均通过调用服务端 API 实现” 这个场景为例,展示实现群聊消息收发的流程。
实现流程
本节仅对上述时序图中标为橙色的流程步骤进行详细说明。其他流程步骤请参考相关服务端 API 文档或 SDK 文档。
-
接收方注册对应平台/框架 SDK 的会话消息监听接口,监听 IM 服务端投递至 SDK 端的群聊消息。
平台/框架 群聊消息监听接口 Android observeReceiveMessage
iOS onRecvMessages:
Web - NIM Web SDK:监听
onMsg
事件 - 含圈组版 NIM Web SDK:监听
msg
事件
Windows/macOS - C++:
- 在线消息接收:
RegReceiveCb
- 离线同步漫游消息接收:
RegReceiveMessagesCb
- 在线消息接收:
- C:
- 在线消息接收:
nim_talk_reg_receive_cb
- 离线同步漫游消息接收:
nim_talk_reg_receive_msgs_cb
- 在线消息接收:
Flutter onMessage
Unity - 在线消息接收:
OnReceiveMessageHandler
- 离线同步漫游消息接收:
RegReceiveBatchMessagesCb
注册消息接收监听接口相关示例代码,请参见各平台/框架 SDK 文档的《消息收发》章节。
- NIM Web SDK:监听
-
发送方调用
msg/sendMsg.action
发送群聊消息,调用时将参数ope
设置为1
(表示发送的为群聊消息),将参数to
设置为群 ID。 -
IM 服务端将群聊消息投递至 SDK 端,SDK 端触发群聊消息接收回调,将群聊消息投递至接收方。
若消息的发送方不在群组内,会返回 414 错误码。
此文档是否对你有帮助?