限制条件

最近更新时间:2021-04-01 14:58:00

本页简要介绍 AR RTM Java SDK for Android 的使用限制条件,包括调用频率、字符串大小、编码格式等。

调用频率限制

所有的调用频率都针对单个 RtmClient 实例。如果一个操作对应多个方法,则此操作在单位时间内的调用次数等于所有方法单位时间内的调用次数之和。

你可以通过创建多个实例提高 API 的调用频率。

操作方法调用频率限制
登录 AR RTM 系统login每秒 2 次
查询单个或多个频道的成员人数getChannelMemberCount每秒 1 次
每次都加入不同频道join每 3 秒 50 次
每次都加入同一个频道join每 5 秒 2 次
发送消息sendMessageToPeer
sendMessageToPeer
sendMessage
sendMessage
每 3 秒 180 次
获取频道成员列表getMembers每 2 秒 5 次
更新 tokenrenewToken每秒 2 次
查询指定用户在线状态queryPeersOnlineStatus每 5 秒 10 次
用户属性增删修改setLocalUserAttributes
addOrUpdateLocalUserAttributes
deleteLocalUserAttributesByKeys
clearLocalUserAttributes
每 5 秒 10 次
用户属性查询getUserAttributes
getUserAttributesByKeys
每 5 秒 40 次
频道属性增删修改setChannelAttributes
addOrUpdateChannelAttributes
deleteChannelAttributesByKeys
clearChannelAttributes
每 5 秒 10 次
频道属性查询getChannelAttributes
getChannelAttributesByKeys
每 5 秒 10 次
订阅指定单个或多个用户的在线状态subscribePeersOnlineStatus每 5 秒 10 次
取消订阅指定单个或多个用户的在线状态unSubscribePeersOnlineStatus每 5 秒 10 次
根据订阅内容获取用户列表queryPeersBySubscriptionOption每 5 秒 10 次

字符串大小限制

编码格式限制

  • 仅支持发送 UTF-8 编码格式的频道消息和点对点消息、呼叫邀请内容、呼叫邀请响应。

其它限制

  • 当频道人数超过 512 人时,用户进出频道的提示会被自动关闭。
  • 对于单个实例,支持单次查询最多 256 个用户的在线状态。
  • 对于单个实例,单次最多且总计只能订阅 512 人的在线状态。你无法通过多次订阅来突破人数限制。如果频道人数超过 512,SDK 会随机返回其中的 512 人。
  • 对于单个实例,每个用户最多同时加入 20 个频道。
  • 单次用户属性设置的最大值为 16 KB,单次频道属性设置的最大值为 32 KB,单条用户或频道属性(键值对)的最大值为 8 KB,单次属性操作设置的属性条目(键值对)不能超过 32 个。