本页简要介绍 Agora RTM Web SDK 的使用限制条件,包括调用频率、字符串大小、编码格式等。
对于单个频道每秒发送的频道消息数量限制如下:
单个频道同时在线人数 | 每秒频道消息数量 |
---|---|
< 1,000 | < 200 |
≥ 1,000 且 < 10,000 | < 100 |
≥ 10,000 | < 30 |
如果每秒消息数量超过限制,延迟会大幅增加,可能导致以下结果:
RECONNECTING
状态或在 RECONNECTING
与 CONNECTED
状态间不断切换。在其他用户看来,该用户可能显示为离线状态。声网可以提供定制化服务,在不影响延迟和稳定性的前提下大幅提高每秒消息数量。请联系技术支持。
当频道人数超过 512 人时,用户进出频道的提示会被自动关闭。声网建议你在自己的业务服务器调用获取用户加入或离开频道事件 RESTful API 获取进出频道通知。
所有的调用频率都针对单个 RtmClient
实例。如果一个操作对应多个方法,则此操作在单位时间内的调用次数等于所有方法单位时间内的调用次数之和。
操作 | 方法 | 调用频率上限 |
---|---|---|
登录到声网 RTM 系统 | login |
每秒 2 次 |
查询单个或多个频道的成员人数 | getChannelMemberCount |
每秒 1 次 |
每次加入同一个频道 | join |
每 5 秒 2 次 |
每次加入不同频道 | join |
每 3 秒 50 次 |
发送消息 | sendMessageToPeer SendMessage |
每 3 秒 180 次 |
获取频道成员列表 | getMembers |
每 2 秒 5 次 |
更新 Token | renewToken |
每秒 2 次 |
查询指定用户在线状态 | queryPeersOnlineStatus |
每 5 秒 10 次 |
用户属性增删修改 | setLocalUserAttributes addOrUpdateLocalUserAttributes deleteLocalUserAttributesByKeys clearLocalUserAttributes |
每 5 秒 10 次 |
用户属性查询 | getUserAttributes getUserAttributesByKeys |
每 5 秒 40 次 |
频道属性增删修改 | setChannelAttributes addOrUpdateChannelAttributes deleteChannelAttributesByKeys clearAttributes |
每 5 秒 10 次 |
频道属性查询 | getChannelAttributes getChannelAttributesByKeys |
每 5 秒 10 次 |
订阅指定单个或多个用户的在线状态 | subscribePeersOnlineStatus |
每 5 秒 10 次 |
取消订阅指定单个或多个用户的在线状态 | unSubscribePeersOnlineStatus |
每 5 秒 10 次 |
根据订阅内容获取用户列表 | queryPeersBySubscriptionOption |
每 5 秒 10 次 |
RtmMessage.text
。LocalInvitation.content
。RemoteInvitation.response
。仅支持发送 UTF-8 编码格式的频道消息和点对点消息、呼叫邀请内容、呼叫邀请响应。
详见开发环境要求。
RtmClient
实例,支持单次查询最多 256 个用户的在线状态。RtmClient
实例,单次最多且总计只能订阅 512 人的在线状态。你无法通过多次订阅来突破人数限制。如果频道人数超过 512,SDK 会随机返回其中的 512 人。RtmClient
实例,每个用户最多同时加入 20 个频道。RtmClient
实例,同时最多支持 9 个上传和下载进程。