术语表

更新时间：2022-02-28

单聊即一对一聊天，支持全类型消息。参与聊天的双方可以是好友也可以是陌生人。

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

禁止用户使用环信即时通讯 IM 服务， 封禁后，用户无法连接环信即时通讯 IM 服务器。

广播消息是指通过 Rest API 对应用内的所有用户发送消息。当用户离线时，消息会自动转换为系统离线推送。

环信即时通讯 IM SDK 是环信提供的用于实现即时通讯，比如：单聊、群聊、聊天室的 SDK。

IMKit 是环信即时通讯 IM SDK 的一个开源 UI 组件，提供应用内聊天的常用页面和 UI 组件，帮助开发者快速构建应用的 UI。

CallKit 是环信即时通讯 IM SDK 的一个开源 UI 组件，提供应用内聊天中音视频通话的页面和 UI 组件，帮助开发者快速构建应用的 UI。

环信通讯云控制台是环信提供给开发者管理环信各项服务的工具。

会话是一个单聊、群聊或者聊天室所有消息的集合。用户需在会话中发送消息或查看历史消息，还可进行会话置顶、清空聊天记录等操作。

会话列表是指会话依照一定顺序排列的列表，会话的排列顺序依赖于置顶、会话中最近一条消息的接收时间等因素。

聊天室是支持多人加入的组织。聊天室中的成员没有固定关系，用户离线后，超过 5 分钟会自动退出聊天室。聊天室成员在离线后，不会收到推送消息。聊天室可以应用于直播、消息广播等。

聊天室创建者和管理员可以将聊天室成员加入黑名单，被加入聊天室黑名单的用户不能在聊天室中发送消息。

聊天室创建者和管理员可以将聊天室成员加入白名单，在聊天室开启全局禁言的情况下，只有白名单中的用户可以在聊天室中发送消息。

聊天室的创建者，在聊天室中拥有最高权限。可以指定管理员、解散聊天室、更改聊天室信息、对聊天室成员进行管理。

由聊天室所有者授权，协助进行管理，拥有一定管理权限。可以对聊天室成员进行管理。

聊天室的普通成员，不具备聊天室管理权限。

当接收方不在线时，环信即时通讯 IM 服务器会暂时保存消息，用户上线时，会接收到服务器保存的离线消息。不同套餐版本的离线消息保存时长不同。单聊和群聊支持离线消息，聊天室不支持离线消息。

离线是指用户成功登出环信即时通讯 IM 系统或与环信即时通讯 IM 系统断开连接后的状态。用户登出环信即时通讯 IM 系统之后，无法发送和接受消息，在下次登录后可以接收到离线消息。

环信即时通讯 IM 服务器会保存历史消息以供查询。开发者可以通过 REST API 下载历史消息压缩包文件。

多端登录时，用户在其中一端发送的消息会同步到所有其他客户端，此类消息成为漫游消息。

群组是支持多人沟通的即时通讯系统，成员关系相对稳定。所有群成员可在群中收发送消息。当群成员离线时，可以收到推送消息。群组分为公开群和私有群，公开群可以被搜索到，非群成员可以加入；私有群不能被搜索到，需要群主或群管理员添加非群成员进入。群组成员支持多种角色：群主、群管理员、群成员。群组提供丰富的管理能力，如：群组禁言、群公告、群文件等。

群组创建者和管理员可以将群组成员加入黑名单，加入群黑名单的用户不能在群中发送消息。

群组创建者和管理员可以将群组成员加入白名单，在群组开启全局禁言的情况下，只有白名单中的用户可以在群组中发送消息。

群组的创建者，在群组中拥有最高权限。可以指定管理员、解散群组、更改群组信息以及对群组成员进行管理。

由群组所有者授权，协助进行管理，拥有一定管理权限。可以对群组成员进行管理。

群组的普通成员，不具备群组管理权限。

环信即时通讯 IM 的服务器端接口都是通过 REST 服务方式提供的，REST API 基于最简单的 HTTP 协议，在各个编程语言中都提供了良好的支持。

环信即时通讯 IM REST 平台提供一个多租户用户体系，资源以集合（Collection）的形式描述，这里的 Collection 包括 Database、企业（orgs）、应用（apps）、Chat 用户（users）、群组（chatgroups）、消息（chatmessages）和文件（chatfiles）等等。

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

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

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

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

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

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

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

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

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

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

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

你给用户在环信即时通讯服务中创建的唯一账号，用于登录等。

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

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