限制条件

本页简要介绍 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 次
更新 token	renewToken	每秒 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 次

字符串大小限制

• 点对点或频道消息的字符串最大为 32 KB。详见 RtmMessage.setText。
• 呼叫邀请内容的字符串最大为 8 KB。 详见 LocalInvitation.setContent。
• 呼叫邀请响应的字符串最大为 8 KB。 详见 RemoteInvitation.setResponse。

编码格式限制

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

其它限制

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