转发消息

IMKit 支持对单条消息转发，和对多条消息的逐条转发/合并转发的功能，允许用户在聊天页面中将消息转发到其他会话中。转发后消息将出现在目标会话页面的消息列表组件中。

提示

IMKit 默认未启用合并转发功能。您可以按需启用合并转发功能。

局限

• 并非所有消息类型均支持合并转发。
  • 支持的消息类型：文本、图片、图文、GIF、动态表情（RC:StkMsg）、名片、位置、小视频、文件、普通语音、高清语音、音视频通话（RC:VCSummary）。
  • 不支持的情况：未在支持列表中的消息类型，例如引用消息，以及未发送成功的消息等特殊情况不支持转发。自定义消息均不支持合并转发。
• 合并转发支持合并最多 100 条消息。

用法

IMKit 会话页面默认已启用转发功能。用户在会话页面长按消息，在弹框里选择更多，即可展示转发消息选项。

• 逐条转发：默认开启。可转发单聊或多条消息至目标会话。
• 合并转发：默认关闭，不展示。如果合并转发，SDK 会将选中的消息合并为一条合并转发消息，包含消息内容对象 CombineMessage（类型标识：RC:CombineMsg）。合并转发的消息默认折叠显示，可点击展开。

启用合并转发功能

IMKit 支持合并转发功能，该功能默认关闭。您可以修改全局配置，打开 IMKit 的合并转发功能。

Java

RongConfigCenter.conversationConfig().rc_enable_send_combine_message = true;

如果通过 XML 资源修改 IMKit 默认配置，可在应用 res/values 目录下创建 rc_config.xml 文件，添加以下配置：

xml

<bool name="rc_enable_send_combine_message">true</bool>

定制化

修改单次转发消息数量

转发消息数量受消息多选功能。IMKit 默认实现消息多选能力，您可以修改多选消息数量上限。修改方法详见会话页面。注意，合并转发功能支持最多合并 100 条，无法通过配置上调限制。

跳转自定义的转发会话列表

IMKit 中选中逐条转发或合并转发后，默认跳转的页面是 SDK 本地存储的最近会话列表。

如果需要 SDK 在转发选择会话时跳转应用程序自定义页面，调用 SDK 内置路由 RouteUtils 的以下方法将自定义 Activity 注册给 SDK 即可。

在进入会话页面之前配置：

Java

//此处以自定义页面为 MyForwardSelectActivity 为例。
RouteUtils.registerActivity(RouteUtils.RongActivityType.ForwardSelectConversationActivity, MyForwardSelectActivity.class);

关闭转发功能

如果不需要转发功能，可以直接将长按消息弹窗中的「更多」选项隐藏。方法详见会话页面。