发送房间内广播消息 SendBroadcast--实时音视频-火山引擎

文档中心

立即注册

实时音视频

请输入

实时消息通信

发送房间内广播消息 SendBroadcast

在你的音视频应用中，当你需要从业务服务端，向指定一个 RTC 房间内的所有用户广播消息时，你可以使用 SendBroadcast 这个 OpenAPI 实现这一功能。

使用说明

接口行为

你可以调用 SendBroadcast 接口，指定你所属的 AppId，通过服务端向指定 roomId 的房间广播消息。

注：
消息可以是文本消息，也可以是二进制消息。
文本消息大小不能超过 64 KB，二进制消息大小不能超过 64 KB。

消息发送成功后，用户会通过以下回调收到该消息：

	Android	iOS	Windows
文本消息	onRoomMessageReceived	rtcEngine:onRoomMessageReceived:message	OnRoomMessageReceived
二进制消息	onRoomBinaryMessageReceived	rtcEngine:onRoomBinaryMessageReceived:message:	OnUserBinaryMessageReceived

注意事项

请求频率：对于每个 accountID，调用 SendUnicast、SendRoomUnicast、SendBroadcast与BatchSendRoomUnicast的频率上限之和是 500 次每秒。

请求说明

请求方式：POST
请求地址：https://rtc.volcengineapi.com?Action=SendBroadcast&Version=2020-12-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`SendBroadcast`	接口名称。当前 API 的名称为 `SendBroadcast`。
Version	String	是	`2020-12-01`	接口版本。当前 API 的版本为 `2020-12-01`。

Body

参数	类型	是否必选	示例值	描述
AppId	String	是	`You****pId`	应用的唯一标志
RoomId	String	是	`RoomId`	房间的 ID，是房间的唯一标志
From	String	是	`from_server_id`	业务服务端的唯一标识。命名规则符合正则表达式：`[a-zA-Z0-9_@\-\.]{1,128}`。在一个 `AppID` 下，不能和真实用户用于实时消息通信的 `user_ID` 重复；建议使用固定的 `ID` 的发送消息。
Binary	Boolean	是	`false`	字段为 `true`，发送二进制消息；字段为 `false`，发送文本消息。
Message	String	是	`hello`	广播消息内容。如果是二进制消息，需进行 base64 编码

返回参数

下表仅列出本接口特有的返回参数，公共返回参数请参见返回结构。

参数	类型	示例值	描述
Message	String	`success`	仅在请求成功时返回消息 `Success`，失败时为空。

请求示例

POST https://rtc.volcengineapi.com?Action=SendBroadcast&Version=2020-12-01
{
    "AppId": "You****pId",
    "RoomId": "Your_RoomId",
    "From": "from_user_id",
    "Message": "hello",
    "Binary": true
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "Your_****estId",
        "Action": "SendBroadcast",
        "Version": "2020-12-01",
        "Service": "rtc",
        "Region": "cn-north-1"
    },
    "Result": {
        "Message": "Success"
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。

最近更新时间：2025.11.10 19:15:08

这个页面对您有帮助吗？

有用

无用