即时通讯 IM 主要功能

# 即时通讯 IM 主要功能环信即时通讯 IM 支持消息管理、用户管理功能、离线推送和内容审核功能。

# 多平台支持环信即时通讯 IM 支持 Android、iOS、Web 等平台，而且各平台之间可互通。下表为即时通讯支持的各平台版本：

平台SDK 支持的版本Demo源码单群聊 UIKit聊天室 UIKitAndroidAndroid 5.0 或以上版本（API 级别 21 或以上）支持-支持支持iOSiOS 10.0 或以上版本支持-支持支持Web - Internet Explorer 9 或以上 - FireFox 10 或以上 - Chrome 54 或以上 Safari 6 或以上 - Edge 12 或以上 - Opera 58 或以上 - iOS Safari 7 或以上 - Android Browser 4.4 (KitKat) 或以上支持-支持支持小程序支持支持---uni-app支持--支持-HarmonyOSHarmonyOS NEXT（API 级别 12 或以上）支持---FlutterFlutter 2.10支持-支持支持React NativeReact Native 0.63.4 或以上版本支持-支持支持UnityUnity 2017 或以上版本支持---WindowsWindows 10 或以上版本支持---Electron支持----Linux支持----# 账号功能通过调用 RESTful API，可进行如下用户账号操作：

功能描述注册用户单次请求最多可注册 60 个用户 ID。获取用户详情用户名称、创建时间以及推送设置等。删除用户账号删除某个 App 下指定数量的用户账号。修改用户密码修改用户的登录密码，不需要提供原密码。封禁/解禁用户禁用用户，使其立即下线并无法登录进入环信即时通讯 IM，直到被解禁后才能恢复登录。强制用户下线将用户状态改为离线，用户需要重新登录才能正常使用。获取用户在线状态查看单个用户是在线还是离线状态。获取指定账号的在线登录设备列表获取指定账号的在线登录设备列表。# 单端/多端登录功能描述单平台登录Android、iPhone、iPad、HarmonyOS、Windows、Mac、Web 仅可有1种平台在线。多平台登录每端默认最多支持 4 个设备同时在线。使用多端登录前，你需要在 环信控制台open in new window 的 功能配置 > 基础功能 > 用户 页面上查找 多端多设备，开启该功能。开通该功能后，点击 设置，在弹出的对话框中设置各端设备的数量。

# 消息类型类型描述文本消息文本消息的内容是文本，包含超链接和表情符号等。位置消息消息内容为经纬度信息。图片消息消息内容为图片大小和 URL 地址等。 图片默认不能超过 10 MB。语音消息语音消息需要提供时长（单位为秒）和语音文件路径。 音频文件默认不能超过 10 MB。视频消息视频消息需要提供时长（单位为秒）、视频文件路径以及缩略图路径等信息。 视频文件默认不能超过 10 MB。文件消息文件消息需要提供文件 URL 地址和文件名等信息 附件大小不能超过 10 MB。命令消息通过发送命令给对方，通知对方要执行的操作，对方收到消息后系统可以自定义处理。 透传消息不会在 UI 上展示，也不存入本地数据库。自定义消息自定义消息类型，例如，红包消息、模板消息等。合并消息将多条消息合并成一条消息。一条合并消息最多包含 300 个原始消息。提示

各类消息大小不能超过 5 KB。支持消息扩展字段，传递自定义内容，例如，消息中需要携带被回复的消息内容或者是图文消息等场景。# 消息功能功能描述发送和接收消息发送和接收各类消息，包括文本、图片、音频、视频、文件消息、位置消息、命令消息、自定义消息以及合并消息。本地存储接收的消息存储在本地。历史消息环信服务器可存储消息。消息存储时间与你的产品套餐包相关，详见 产品价格open in new window。离线消息推送 - 用户离线时，可向消息接收方发送推送通知。 - 支持离线消息存储，默认为 7 天。多端同步多端多设备消息同步，同时收到消息。本地搜索按照关键字搜索本地会话中的各类消息。消息撤回撤回发送成功的消息。默认可撤回发出 2 分钟内的消息。你可以在环信控制台设置消息撤回时长，该时长不超过 7 天。消息回执消息送达回执和消息已读回执。修改消息编辑发送成功的消息。表情回复对消息添加、删除表情。定向消息指向群组或聊天室的单个或多个指定的成员发送消息，其他成员不会收到该消息。全局广播向 app 所有用户或聊天室发送广播消息。正在输入可通过透传消息实现。导入和插入消息在本地导入和插入消息。删除消息单向删除服务端和本地的历史消息、清除聊天记录。置顶消息置顶、取消置顶消息和获取置顶消息。翻译消息对文本消息按需翻译和自动翻译只投在线用户只将消息投递给在线用户。消息审核（举报）举报违规消息。获取消息流量统计本地消息的流量统计# 会话相关功能描述会话列表从服务器或本地获取会话列表。会话免打扰可设置指定群聊会话，收到新消息后是否提醒。会话已读回执接收方阅读会话中的所有消息后向服务器发送会话已读回执。与单聊会话不同，群聊会话已读回执只用于清空服务端的群聊会话的未读数，消息发送方不会通过回调收到会话已读回执。会话未读数获取和清零群聊会话的未读消息数。会话置顶将群聊会话固定在会话列表的顶部。会话标记对群聊会话添加标记。会话删除删除群聊会话。# 用户属性功能描述设置用户属性设置用户昵称、头像、邮箱、电话等。获取用户属性获取指定一个或多个用户的全部用户属性。获取 app 下用户属性总大小（仅服务端）获取该 app 下所有用户的属性数据大小，单位为字节。删除用户属性删除单个用户的所有属性。# 用户关系环信即时通讯 IM 默认支持陌生人之间发送单聊消息，即无需添加好友即可聊天。若仅允许好友之间发送单聊消息，你需要在 环信控制台open in new window开启好友关系检查。

功能描述添加好友发送、接收和处理好友请求。移除好友移除好友。同意/拒绝好友申请收到好友请求后，可接受或拒绝。移除好友移除好友。设置好友备注设置单个好友的备注。获取好友列表从服务端或本地获取好友列表。添加用户到黑名单将用户添加至黑名单。可以将任何用户加入黑名单，不论该用户与你是否是好友关系。将好友移除黑名单将用户从黑名单移除，用户发送消息等行为将恢复。获取黑名单列表从服务端获取黑名单列表。# 群组和聊天室对于免费峰值群组和聊天室数，体验版支持 100 个/月，专业版 100000 个/月，旗舰版 100000 个/月。

功能群组聊天室使用场景类似于 Signal，Skype 里的群聊，所有加入的用户拥有固定的关系类似 Twitch 的直播间，成员间没有固定关系，离开即退出分类分为公开群和私有群，创建群组时可设置入群是否需获得群主和群管理员的同意没有公开和私有之分，所有用户均可自由加入或退出群组/聊天室总数上限 - 体验版：100 - 专业版：无限制 - 旗舰版：无限制 -体验版：不支持 - 专业版：无限制 - 旗舰版：无限制成员数上限 -体验版：100 人/群 - 专业版：300人/群（可调*） - 旗舰版：3000人/群（可调*） -体验版：不支持 - 专业版：10,000 人/聊天室 - 旗舰版：10,000 人/聊天室成员列表所有成员均可见所有成员均可见创建所有 app 用户都可以创建群组仅聊天室超级管理员可在客户端创建解散群主聊天室所有者申请加入支持支持加群审批支持支持邀请加入支持不支持群主/所有者退出不支持支持设置管理员支持支持移除成员 - 群主 - 群管理员 - 聊天室所有者 - 聊天室管理员成员禁言支持支持白名单支持支持黑名单支持支持成员变更通知邀请进群/申请进群/踢人/退群，默认下发通知主动离开和被踢，默认下发通知角色变更通知添加/移除群管理员，群主变更，默认下发通知添加/移除聊天室管理员，聊天室所有者变更，默认下发通知群/聊天室属性变更通知群组名称、描述和公告变更时，默认下发通知聊天室名称、描述和公告以及自定义属性变更时，默认下发通知群/聊天室成员状态变更通知成员被禁言和添加至黑名单或白名单、群管理员变更，默认下发通知成员被禁言和添加至黑名单或白名单、聊天室管理员变更，默认下发通知消息功能 - 支持消息发送、消息漫游、修改、撤回、置顶、回执、表情回复、翻译、合并、转发、只投在线用户等特性。 - 支持定向消息（仅向某个或某些成员发消息）。 - 支持群组消息的大部分功能（包括定向消息）。 - 要使用消息漫游，需升级 SDK 到指定版本并联系商务开通。 - 不支持消息表情回复、离线消息。历史消息存储支持支持查看漫游消息默认开通联系商务开通是否支持查看加入前漫游消息支持支持（联系商务开通）消息未读计数支持不支持默认消息接收接收在线推送消息，支持离线推送只接收在线消息，不支持离线推送离线消息存储支持不支持消息可靠性群组中发送的所有消息，用户都会收到当消息量大时，聊天室中超过阈值（每秒 100 条）的消息会被丢弃# 环信控制台你可以在 环信控制台open in new window 对你的应用进行配置和管理。

功能描述创建应用创建你的应用升级套餐包自助开通专业版或旗舰版 IM订阅增值服务开通内容审核、实时音视频、即时推送等 增值服务账户中心查看订单记录和消费账单开通功能开通服务端会话列表或多端多设备等功能应用概览展示你的服务版本、域名配置等推送配置包括各厂商推送证书管理和推送模板管理消息回调发送前回调和发送后回调规则配置IP 白名单允许你赋给特定 IP 地址调用 RESTful API 的权限用户管理创建、封禁、删除用户，添加好友等群组管理创建、删除群组、查看群成员和黑名单聊天室管理创建、删除聊天室，查看聊天室成员、管理员和禁言列表和黑名单等数据统计用户、群组和聊天室相关数据统计以及消息量统计实时查询实时活跃的用户数、群组数和聊天室数等，请求质量、热点数据、IM 消息投递查询等内容审核配置消息审核规则、查看审核记录、基于关键词审核等# 数据统计功能描述用户数据用户数量统计，包括注册用户总数、今日活跃用户数、今日新增用户数群组数据群组统计，包括群组总数、活跃群组数、新增群组数、解散群组数聊天室数据聊天室统计，包括聊天室总数、活跃聊天室数、新增聊天室数、解散聊天室数、聊天室同时在线人数Server 数据Server 统计，包括 Server 总数、今日活跃 Server 数、今日新增 Server 数、Channel 总数,、今日新增 Channel 数消息量统计消息统计包含单聊、群聊、聊天室场景下各类消息量的总数统计和趋势分析。# 实时查询功能描述请求质量概览提供质量数据的阶段性分析，帮助你掌握用量变化趋势、跟踪产品质量情况。热点数据查询提供最小以分钟粒度的TOP 50 的活跃用户、活跃群组、活跃聊天室信息。IM 消息投递查询可以查询最近三天的消息投递情况。IM 用户连接状态通过用户 ID 查询最近三天的历史连接状态。IM 用户设备日志查询用户设备端的日志，或将设备端的日志上传到环信日志服务器。聊天室消息速率可根据聊天室 ID 查询聊天室内每分钟的消息上下行数量。# 内容审核支持使用 IM 内容审核服务对消息内容进行多样化场景检测，帮助你对应用消息内容进行管控，规避内容违规风险。

功能描述多消息类型审核智能识别文本、图片和音视频文件。自定义消息处置规则自定义消息下发或拦截的策略。消息审核结果可回调支持将消息审核结果回调至客户服务器。一站式内容审核后台提供可视化的内容审核后台，支持查询审核记录、审核数据统计。# 私有化环信即时通讯私有化服务是基于 IM 核心技术实现的可私有化部署解决方案。该方案可适配内网物理服务器集群、公有云以及私有云等任意部署环境，提供功能完备、安全可靠、易于扩展的即时通讯平台。更多详情，请参见私有化服务文档open in new window。