限制条件

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

频道消息限制

对于单个频道每秒发送的频道消息数量限制如下：

如果每秒消息数量超过限制，延迟会大幅增加，可能导致以下结果：

• 用户无法收发消息。
• 用户长期处于 RECONNECTING 状态或在 RECONNECTING 与 CONNECTED 状态间不断切换。在其他用户看来，该用户可能显示为离线状态。

声网可以提供定制化服务，在不影响延迟和稳定性的前提下大幅提高每秒消息数量。请联系技术支持。

频道人数限制

当频道人数超过 512 人时，用户进出频道的提示会被自动关闭。声网建议你在自己的业务服务器调用获取用户加入或离开频道事件 RESTful API 获取进出频道通知。

调用频率限制

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

字符串大小限制

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

编码格式限制

• 仅支持发送 UTF-8 编码格式的频道消息和点对点消息、呼叫邀请内容、呼叫邀请响应。
• 以下方法的 filePath 参数都必须是 UTF-8 编码格式：
  • createFileMessageByUploading
  • createImageMessageByUploading
  • downloadMediaToFile

其它限制

• 当频道人数超过 512 人时，用户进出频道的提示会被自动关闭。声网建议你在自己的业务服务器调用获取用户加入或离开频道事件 RESTful API 获取进出频道通知。
• 对于单个实例，支持单次查询最多 256 个用户的在线状态。
• 对于单个实例，单次最多且总计只能订阅 512 人的在线状态。你无法通过多次订阅来突破人数限制。如果频道人数超过 512，SDK 会随机返回其中的 512 人。
• 对于单个实例，每个用户最多同时加入 20 个频道。
• 单次用户属性设置的最大值为 16 KB，单次频道属性设置的最大值为 32 KB，单条用户或频道属性（键值对）的最大值为 8 KB，单次属性操作设置的属性条目（键值对）不能超过 32 个。
• 每个上传文件或图片在声网服务器上的保存时间最长为 7 天，上传文件或图片所对应的 media ID 有效期也为 7 天。
• 每个上传文件或图片不得超过 30 MB。
• 对于单个实例，同时最多支持 9 个上传和下载进程。