环信 IM即时通讯

子区消息是发生在子区内的消息。

子区是建立在群组内一条消息上的支持多人沟通的即时通讯系统，子区成员是群组成员的子集。

用户在线状态（即 Presence）包含用户的在线、离线以及自定义状态。即时通讯服务提供发布、订阅和查询用户的在线状态的功能。

发者自定义的消息类型，例如红包消息、石头剪刀布等形式的消息。

用户将不会接收黑名单中用户发送的消息。

同 username，是 App Key 内用户的唯一标识，不同于即时通讯系统服务器为用户创建的 uuid。

语音数据属于附件类型，需要提供时长信息，以秒为单位。最大支持 10 MB。

用户属性指用户的信息，如用户昵称、头像、邮箱、电话、性别、签名、生日等。 比如：在招聘场景下，利用用户属性功能，可以存储性别、邮箱、用户类型（面试者）、职位类型（web 研发）等。当查看用户信息时，可以直接查询服务器存储的用户属性信息。

在单聊和群聊中对消息添加、删除表情。表情可以直观地表达情绪，利用 Reaction 可以提升用户的使用体验。同时在群组中，利用 Reaction 可以发起投票，根据不同表情的追加数量来确认投票。

当基础的消息类型不满足需求时，可以使用消息自定义扩展增强基础消息类型。 使用扩展后，消息大小不能超过原类型消息的大小。 消息自定义扩展的使用场景：例如消息中需要携带被回复的消息内容。 消息自定义扩展作为消息内容会存入本地数据库。

将用户发送的单聊、群聊、聊天室消息存储到聊天服务器，方便用户在更换设备或删除本地消息后，通过服务端获取历史消息，默认单群聊消息服务端最多保存 6 个月，聊天室消息最多保存 2 个月。

消息回调，即聊天服务器会在事件发生之前或之后，向客户的应用服务器发送请求，应用服务器可据此进行必要的数据同步，或者根据业务需求干预事件的后续处理流程。

消息内容为文件的 URL 地址、大小、格式等信息，格式不限，默认支持 10 MB。

消息内容为地理位置标题、经度和纬度信息。

消息内容是普通文本，其中可以包括超链接，客户端收到消息后存入数据库、计入未读消息数。表情消息为开发者自定义。实质上是发文本消息。接收方收到文本消息后，首先查询文本消息是否是表情消息，如果是，则显示该文本消息为对应的表情图片。

即时通讯服务器为 App Key 内用户创建的唯一 ID，不同于用户 ID。

透传消息可视为一条指令，通过发送这条指令给对方，通知对方要执行的操作，对方收到消息可自定义处理。（透传消息不会存入本地数据库中，在 UI 上不显示，也不计入未读消息）。具体功能可以根据自身业务需求自定义，例如实现头像或昵称的更新等。

图片消息内容属于附件类型消息，内容图片 URL 地址、尺寸、图片大小等信息。最大支持 10 MB。

推送是指当应用被杀死时，通过厂商推送接收消息。iOS 设备使用苹果的 APNs（Apple Push Notification service）推送服务、Android 设备为谷歌 FCM（Firebase Cloud Messaging）推送服务。

消息内容为视频文件的 URL 地址、时长、大小、格式等信息，默认支持 10 MB。