API 参考
圈组

发送群消息

更新时间: 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 实现” 这个场景为例,展示实现群聊消息收发的流程。

uml diagram

实现流程

本节仅对上述时序图中标为橙色的流程步骤进行详细说明。其他流程步骤请参考相关服务端 API 文档或 SDK 文档。

  1. 接收方注册对应平台/框架 SDK 的会话消息监听接口,监听 IM 服务端投递至 SDK 端的群聊消息。

    平台/框架 群聊消息监听接口
    Android observeReceiveMessage
    iOS onRecvMessages:
    Web
    • NIM Web SDK:监听onMsg事件
    • 含圈组版 NIM Web SDK:监听msg事件
    Windows/macOS
    Flutter onMessage
    Unity

    注册消息接收监听接口相关示例代码,请参见各平台/框架 SDK 文档的《消息收发》章节。

  2. 发送方调用msg/sendMsg.action 发送群聊消息,调用时将参数ope设置为1(表示发送的为群聊消息),将参数to设置为群 ID。

  3. IM 服务端将群聊消息投递至 SDK 端,SDK 端触发群聊消息接收回调,将群聊消息投递至接收方。

若消息的发送方不在群组内,会返回 414 错误码。

此文档是否对你有帮助?
有帮助
去反馈
  • API 使用限制
  • 前提条件
  • 实现群聊消息收发