功能详情

即时通讯 IM 支持单聊、群聊、聊天室和超级社区会话。本文展示各类会话的主要功能、用户管理功能和离线推送功能。

单聊会话

单聊会话指两个用户一对一聊天。默认情况下，即时通讯 IM 支持两个陌生人进行聊天，即发送消息时不会验证是否为好友。即时通讯 IM 会建立会话，用户离线时会收到推送通知（若集成了第三方离线推送服务）。

消息相关

功能	描述
发送和接收消息	发送和接收各类消息，包括文本、图片、音频、视频、文件消息、位置消息、透传消息、自定义消息以及合并消息。
发送和接收流式消息	服务端支持发送流式消息，SDK 支持接收流式消息。
本地存储	接收的消息存储在本地。
历史消息	IM 服务器可存储消息。消息存储时间与你的产品套餐包相关，详见 产品套餐包功能对比。
离线消息推送	- 用户离线时，可向消息接收方发送推送通知。 - 支持离线消息存储，默认为 7 天。
搜索消息	按照关键字搜索服务端和本地会话中的各类消息。
消息撤回	撤回发送成功的消息。默认可撤回发出 2 分钟内的消息。你可以在声网控制台设置消息撤回时长，该时长不超过 7 天。
消息回执	消息送达回执和消息已读回执。
编辑消息	编辑发送成功的消息。
表情回复	对消息添加、删除表情。
转发消息	将当前会话中发送成功或接收到的消息转发至其他会话。
删除消息	单向删除服务端和本地的历史消息、清除聊天记录。
置顶消息	置顶、取消置顶消息和获取置顶消息。
翻译消息	对文本消息按需翻译和自动翻译 。
只投在线用户	只将消息投递给在线用户。
导入和插入消息	在本地导入和插入消息。
更新消息	更新当前设备本地内存和数据库中已有的消息。

会话相关

功能	描述
会话列表	从服务器或本地获取会话列表。
会话免打扰	可设置指定单聊会话，收到新消息后是否提醒。
会话未读数	获取和清零单聊会话的未读消息数。
会话置顶	将单聊会话固定在会话列表的顶部。
会话标记	对单聊会话添加标记。
会话删除	删除单聊会话。

用户关系

即时通讯 IM 默认支持陌生人之间发送单聊消息，即无需添加好友即可聊天。若仅允许好友之间发送单聊消息，你需要联系声网商务开启好友关系检查。

功能	描述
添加好友	发送、接收和处理好友请求。
移除好友	移除好友。
设置好友备注	设置单个好友的备注。
获取好友列表	SDK 通过自动同步获取最新好友数据。用户登录成功后，SDK 会自动从服务器同步好友列表及好友信息并写入本地。
黑名单	若不希望收到特定用户的消息，可将其加入到黑名单。可以将任何用户加入黑名单，不论该用户与你是否是好友关系。用户被加入黑名单后，仍在好友列表上显示，无法向你发送消息，也无法发送好友申请。

群组会话

群组是支持多人沟通的即时通讯系统，成员关系相对稳定。所有群成员可以收到群中的消息，可以在群中发送消息。群成员离线时可以收到推送消息。群组成员支持多种角色：群主、群管理员和普通成员。群组提供丰富的管理能力，如群组禁言、群公告和群文件等。

消息相关

功能	描述
发送和接收消息	发送和接收各类消息，包括文本、图片、音频、视频、文件消息、位置消息、透传消息、自定义消息以及合并消息。
发送和接收流式消息	服务端支持发送流式消息，SDK 支持接收流式消息。
本地存储	接收的消息存储在本地。
历史消息	IM 服务器可存储消息。消息存储时间与你的产品套餐包相关，详见 产品套餐包功能对比。
离线消息推送	- 用户离线时，可向消息接收方发送推送通知。 - 支持离线消息存储，默认为 7 天。
搜索消息	按照关键字搜索本地会话中的各类消息。
消息撤回	撤回发送成功的消息。默认可撤回发出 2 分钟内的消息。你可以在声网控制台设置消息撤回时长，该时长不超过 7 天。
消息回执	消息送达回执和消息已读回执。
编辑消息	编辑发送成功的消息。
表情回复	对消息添加、删除表情。
定向消息	只向群组的单个或多个指定的成员发送消息，其他成员不会收到该消息。
转发消息	将当前会话中发送成功或接收到的消息转发至其他会话。
合并消息	将多个消息合并在一起进行转发。
导入和插入消息	在本地导入和插入消息。
删除消息	单向删除服务端和本地的历史消息、清除聊天记录。
置顶消息	置顶、取消置顶消息和获取置顶消息。
翻译消息	对文本消息按需翻译和自动翻译
只投在线用户	只将消息投递给在线用户。
导入和插入消息	在本地导入和插入消息。
更新消息	更新当前设备本地内存和数据库中已有的消息。

提示

在消息方面，群聊会话与单聊会话的区别在于群聊支持定向消息。

会话相关

功能	描述
会话列表	从服务器或本地获取会话列表。
会话免打扰	可设置指定群聊会话，收到新消息后是否提醒。
会话未读数	获取和清零群聊会话的未读消息数。
会话置顶	将群聊会话固定在会话列表的顶部。
会话标记	对群聊会话添加标记。
会话删除	删除群聊会话。

创建和管理群组

功能	描述
创建群组	任何用户均可创建群组。群组创建者为群主。
解散群组	只有群主才能解散群组。
封禁/解禁群组	对群组封禁和解禁。
屏蔽和解除屏蔽群消息	所有群组成员都可以屏蔽（不收群组消息）和取消屏蔽群组消息。

查询群组信息

功能	描述
获取群组详情	群成员可以从内存获取群组详情，例如群组 ID、群组名称、群组描述。
修改群组详情	修改群组详情，例如群组名称、描述和扩展信息。
获取群成员列表	从服务器获取群组成员的分页列表。
获取 app 中的群组列表	调用 REST API 分页获取应用下的群组的信息。
获取群组列表	用户可以获取自己创建或加入的群组列表。
查询当前用户已加入的群组数量	用户可以从服务器获取当前用户已加入的群组数量。
获取单个用户加入的群组列表	根据用户 ID 获取指定用户加入的所有群组。也可设置登录后获取最新的已加入群组数据。
查看指定用户是否已加入群组	调用 REST API 查看单个用户是否已加入了指定的群组。

群属性管理

功能	描述
修改群组信息	群主和群管理员可修改群名称、头像、描述和扩展字段。
修改/获取群公告	群主和群管理员可设置群公告，群成员可获取群公告。
管理共享文件	群成员上传、下载和管理群组内的共享文件。群主和群管理员可上传文件并删除所有群共享文件，群成员只能删除自己上传的文件。

群成员管理

功能	描述
加入群组	- 对于公开群和私有群，群主和管理员均可以邀请用户加入群。 - 对于公开群，用户也可以申请加入。
退出群组	主动退群和被群主或群管理员踢出群。 群主不支持退群操作，只能解散群。
变更群主	群主可以将群组的所有权转让给指定的组成员。
添加/移除/获取群管理员	群主可以添加成员到群组管理员列表，将管理员移出该列表。
群组白名单	群主和管理员可以将群成员加入或移出白名单。 白名单成员可在全员禁言状态下发送群消息。
群组黑名单	群主和群管理员可以将群成员加入或移出黑名单。 黑名单中的成员将被移出群且无法再次加入群。
群组禁言	- 群主和管理员可以将群成员加入或移出禁言列表，禁言列表中的成员无法发送群消息，但可以接收群消息。 - 支持开启或关闭全员禁言。
管理群成员的自定义属性	支持设置群成员自定义属性和获取单个群成员的自定义属性，例如设置群组昵称和头像等。 群主可修改所有群成员的自定义属性，其他群成员只能修改自己的自定义属性。

消息话题（Thread）

消息话题可由群成员基于一条群组消息创建，是群组的子集，该条群组消息称为消息话题的父消息。

消息话题管理

功能	描述
创建消息话题	所有群成员均可基于一条群组消息新建消息话题。
解散消息话题	仅消息话题所在群组的群主和群管理员可以解散消息话题。
加入消息话题	消息话题所在群组的所有成员均可以加入消息话题。你可以调用 REST API 批量加入消息话题。
退出消息话题	消息话题成员可主动退出消息话题或被群主和群管理员移除消息话题。
修改消息话题名称	仅群主和群管理员以及消息话题创建者可以修改消息话题名称。
获取消息话题详情	消息话题所属群组的所有成员均可以从服务器获取消息话题详情。
获取消息话题成员列表	消息话题所属群组的所有成员均可以从服务器分页获取消息话题成员列表。
获取消息话题列表	从服务器分页获取 app 中或单个群组中自己加入和创建的消息话题列表。
批量获取消息话题中的最新消息	用户可以从服务器批量获取消息话题中的最新一条消息。
获取消息话题	获取 app 下的所有消息话题、单个用户加入的所有消息话题以及在指定群组中加入的所有消息话题。

消息话题中的消息管理

功能	描述
发送消息话题中的消息	发送消息话题中的消息和发送群组消息的方法基本一致。唯一不同的是，发送消息话题中的消息需要指定是否是消息话题的标记。
接收消息话题中的消息	接收消息话题中的消息与接收单聊、群聊和聊天室相同。
撤回消息话题中的消息	撤回消息话题中的消息的逻辑与撤回单聊、群聊和聊天室相同。
获取消息话题中的消息	从服务器或本地获取单个消息话题的消息。

聊天室会话

聊天室是支持多人加入的类似 Twitch 的组织，可以应用于直播、消息广播等。聊天室中的成员没有固定关系，一旦离线后，不会收到聊天室中的任何消息。 聊天室成员数上限（包括聊天室所有者）默认最大值为 10,000，如需调整请联系商务。

消息相关

功能	描述
发送和接收消息	发送和接收各类消息，包括文本、图片、音频、视频、文件消息、位置消息、透传消息、自定义消息以及合并消息。
发送和接收流式消息	服务端支持发送流式消息，SDK 支持接收流式消息。
历史消息	IM 服务器可存储消息。消息存储时间与你的产品套餐包相关，详见 产品套餐包功能对比。要从服务器拉取聊天室的历史消息，需升级 SDK 到特定版本，并联系商务经理开通。
消息撤回	撤回发送成功的消息。默认可撤回发出 2 分钟内的消息。你可以在声网控制台设置消息撤回时长，该时长不超过 7 天。
编辑消息	编辑发送成功的消息。
定向消息	只向聊天室的单个或多个指定的成员发送消息，其他成员不会收到该消息。
合并消息	将多个消息合并在一起进行转发。
删除消息	单向删除服务端的历史消息、清除聊天记录。
置顶消息	置顶、取消置顶消息和获取置顶消息。要从服务器拉取聊天室的历史消息，需升级 SDK 到特定版本，并联系商务经理开通。
翻译消息	对文本消息按需翻译和自动翻译。
导入和插入消息	在本地导入和插入消息。
更新消息	更新当前设备本地内存和数据库中已有的消息。

提示

与单聊和群组聊天不同，聊天室不支持离线消息推送和本地消息操作。

创建和管理聊天室

功能	描述
创建聊天室	只有被赋予 超级管理员 权限的用户有权限创建聊天室。建议 调用 REST 接口创建聊天室。
加入聊天室	没有被加入黑名单的所有 app 用户可自由加入聊天室。
离开聊天室	主动退出聊天室或被移出聊天室。
解散聊天室	聊天室所有者可解散聊天室。
获取聊天室详情	所有聊天室成员有权限获取聊天室详情，例如聊天室 ID、名称，和描述等。
实时更新聊天室成员人数	聊天室短时间内有成员频繁加入或退出时，可实时更新聊天室成员人数。

聊天室成员管理

功能	描述
获取聊天室成员列表	所有聊天室成员均可获取当前聊天室成员列表。
变更聊天室所有者	聊天室所有者可以将聊天室的所有权转让给指定的聊天室成员。
聊天室禁言列表	聊天室所有者或管理员可对单个聊天室成员进行禁言或移出禁言。
聊天室全员禁言	聊天室所有者或管理员可进行全员禁言。默认聊天室所有者和管理员不禁言。
聊天室按标签禁言（服务端）	设置用户在聊天室中的标签，按标签对用户禁言。
聊天室白名单	聊天室所有者或管理员可将成员加入或移出白名单。全员禁言时，白名单的成员可以发消息。
聊天室黑名单	聊天室所有者或管理员可将成员加入或移出黑名单。 黑名单中的成员需要聊天室所有者主动从黑名单移除后才能再次加入聊天室。
管理聊天室管理员	仅聊天室所有者可添加或移除管理员。

聊天室属性管理

功能	描述
修改聊天室名称	仅聊天室所有者可修改聊天室名称。
获取/更新聊天室公告	仅聊天室所有者可更新公告、删除公告。 所有成员可获取公告。
管理聊天室自定义属性（key-value）	设置、获取和删除以及强制设置和强制删除聊天室自定义属性。

消息话题管理

功能	描述
创建消息话题	频道成员可以在频道中创建消息话题。
加入消息话题	频道成员可以加入频道下的消息话题。
退出消息话题	消息话题成员可以主动退出或被移出自己加入的消息话题。
删除消息话题	社区所有者可以删除该频道中的消息话题。
获取消息话题详情	频道成员可以获取消息话题的详情。
获取频道下创建的消息话题列表	频道成员可以获取在指定频道下创建的消息话题列表。
获取频道下加入的消息话题列表	频道成员可以获取频道下加入的消息话题。
获取频道的消息话题列表	频道成员获取频道的所有消息话题的列表。
修改消息话题名称	社区所有者、社区管理员和消息话题的创建者可以修改消息话题的名称。

用户相关

用户账号管理

通过调用 RESTful API，可进行如下用户账号操作：

功能	描述
注册用户	单次请求最多可注册 60 个用户 ID。
获取用户详情	用户名称、创建时间以及推送设置等。
删除用户账号	删除某个 App 下指定数量的用户账号。
修改用户密码	修改用户的登录密码，不需要提供原密码。
封禁/解禁用户	禁用用户，使其立即下线并无法登录进入即时通讯 IM，直到被解禁后才能恢复登录。
强制用户下线	将用户状态改为离线，用户需要重新登录才能正常使用。
获取用户在线状态	查看单个用户是在线还是离线状态。
获取指定账号的在线登录设备列表	获取指定账号的在线登录设备列表。

用户属性

功能	描述
设置用户属性	设置用户昵称、头像、邮箱、电话等。
获取用户属性	获取指定一个或多个用户的全部用户属性。
获取 app 下用户属性总大小（仅服务端）	获取该 app 下所有用户的属性数据大小，单位为字节。
订阅非好友用户的属性变更	订阅后，指定非好友用户的属性发生变化时，应用可以及时收到通知。
删除用户属性	删除单个用户的所有属性。

在线状态订阅

功能	描述
订阅指定用户的在线状态	每个用户 ID 订阅的用户数不超过 3000。
发布自定义在线状态	发布自定义在线状态。
取消订阅指定用户的在线状态	不再订阅指定用户的在线状态。
查询被订阅用户列表	分页查询自己订阅的用户列表。
获取用户的当前在线状态	获取用户当前的在线状态，包括未订阅的用户的状态。

用户全局禁言

你可以调用 RESTful API 实现用户全局禁言：

功能	描述
设置用户全局禁言	对单个用户 ID 在所有单聊、群组或聊天室中禁言，使其无法发送消息。
查询单个用户 ID 全局禁言	查询单个用户的单聊、群聊和聊天室的全局禁言详情。
查询 app 下的所有全局禁言的用户	查询 app 下所有全局禁言的用户及其禁言剩余时间。

离线推送

即时通讯 IM 的 Android、iOS、uni-app 和 React Native SDK 支持离线推送，支持的手机厂商推送服务包括 APNs、Google FCM、华为、荣耀、小米、OPPO、VIVO 和魅族。

功能	描述
绑定和解绑推送信息	将设备与推送信息会进行绑定获解绑，包括设备 ID、推送证书和 device token。
设置推送标题和推送内容	可以通过以下方式设置推送的标题和内容： - 调用方法设置； - 使用推送模板 - 使用消息扩展字段
设置推送昵称	设置离线推送时通知栏中显示的消息发送方的昵称。
设置通知方式	包括三种方式： - 接收所有离线消息的推送通知。 - 仅接收提及某些用户的消息的推送通知。 - 不接收离线消息的推送通知。
设置免打扰模式	设置免打扰时间段和免打扰时长。
设置推送通知的首选语言	若启用了翻译功能，SDK 会同时发送原始消息和翻译后的消息。如果翻译消息的语言符合你的设置，则翻译消息显示在推送通知中；否则，将显示原始消息。
设置推送扩展功能	利用扩展字段实现自定义推送设置，例如强制推送和发送静默消息。
查询离线推送结果统计数据	可以通过 声网控制台 查询离线推送的结果。