sendBroadcastMessage method
- String roomID,
- String message
发送房间广播消息。
支持版本:1.2.1 及以上。
详情描述:向房间发送广播消息,已经登录相同房间的用户能收到消息,消息可靠。
业务场景:一般在直播房间人数不超过 500 时使用。
调用时机:调用 loginRoom
登录房间之后。
使用限制:房间在线人数超过 500 时不支持,如果需要提高限制,请联系 ZEGO 技术支持申请评估。同一房间内的广播消息发送频率不能高于 10条/s。单个用户在客户端调用此接口的最大QPS为2,关于此函数的使用限制,请参考 https://doc-zh.zego.im/article/7581 或联系 ZEGO 技术支持。
相关回调:可通过 onIMRecvBroadcastMessage 接收到房间广播消息。
相关接口:可通过 sendBarrageMessage 函数发送弹幕消息,可通过 sendCustomCommand 函数发送自定义信令。
roomID
房间 ID,不得为空,最大长度为 128 字节的字符串。 注意事项: 1.房间 ID 由您自己定义。- 仅支持数字,英文字符 和 '~', '!', '@', '#', '$', '%', '^', '&', '*', '(', ')', '_', '+', '=', '-', '`', ';', '’', ',', '.', '<', '>', ''。
- 如果需要与 Web SDK 互通,请不要使用 '%'。
message
消息内容。是否必填:是。取值范围:长度不超过 1024 字节。- Returns 发送广播消息结果通知。是否必填:否。注意事项:传
null
则意味着不接收回调通知。
Implementation
Future<ZegoIMSendBroadcastMessageResult> sendBroadcastMessage(
String roomID, String message) async {
return await ZegoExpressImpl.instance.sendBroadcastMessage(roomID, message);
}