使用限制

更新时间:2022-06-28

本文简要介绍环信即时通讯 IM 的使用限制条件,包括调用频率、字符串大小和编码格式等。

  • username 用户 ID:长度不可超过 64 个字节长度。不可设置为空。支持以下字符集:
    • 26 个小写英文字母 a-z;
    • 26 个大写英文字母 A-Z;
    • 10 个数字 0-9;
    • “_”, “-”, “.”。
    注意:
    • 该参数不区分大小写,因此 Aaaa 为相同用户名;
    • 请确保同一个 app 下,username 唯一;
    username 用户 ID 是会公开的信息,请勿使用 UUID、邮箱地址、手机号等敏感信息。
  • 批量注册每次最多 60 个用户 ID。

根据不同的套餐版本,用户好友数有如下限制:

套餐版本好友人数上限
免费版 100
专业版 3,000
旗舰版 无上限
尊享版 无上限

根据不同的套餐版本,消息存储时长有如下限制:

套餐版本 消息存储时长
免费版 3 天
专业版 7 天
旗舰版 90 天
尊享版 180 天

根据不同的套餐版本,群组有如下限制:

套餐版本 群组总数 群成员数 用户可加入群组数
免费版 100 100 100
专业版 100,000 300 600
旗舰版 无上限 3,000 无上限
尊享版 无上限 8,000 无上限

群组名称,用户自定义,字符串类型,最大长度为 128 字符。 群组描述,用户自定义,字符串类型,最大长度为 512 字符。 群组扩展信息,例如可以给群组添加业务相关的标记,最大长度为 1,024 字符。

根据不同的套餐版本,聊天室有如下限制:

套餐版本 聊天室总数 聊天室成员数 用户可加入聊天室数
免费版
专业版 100 无上限 无上限
旗舰版 无上限 无上限 无上限
尊享版 无上限 无上限 无上限

聊天室名称,用户自定义,字符串类型,最大长度为 128 字符。 聊天室描述,用户自定义,字符串类型,最大长度为 512 字符。

每秒频道发消息数量不能超过 100。

对于不同的消息类型,消息长度限制如下:

消息类型 消息长度限制 相关 API
文本消息 3 KB createTxtSendMessage
图片消息 10 MB createImageSendMessage
语音消息 10 MB createVoiceSendMessage
视频消息 10 MB createVideoSendMessage
文件消息 10 MB createFileSendMessage
透传消息 3 KB createSendMessage
消息自定义扩展 扩展消息大小不能超过原类型消息的大小 createSendMessage
自定义消息 3 KB createSendMessage

默认单一用户的属性总长不得超过 2 KB,默认一个 app 下所有用户的属性总长度不得超过 10 GB。