• IMLib / IMKit >
 
• 含 UI SDK（IMKit） >
 
• 聊天界面 >
 
• 输入区域

输入区域

IMKit 的输入区域是通过 RCChatSessionInputBarControl 统一创建和控制的，支持自定义输入模式、自定义扩展区域（插件）、以及自定义表情。

修改输入栏组合模式

IMKit 输入栏提供语音/文本切换、内容输入、扩展区域功能，并支持修改输入组合模式。例如，您可以移除语音/文本切换按钮和扩展面板，仅保留内容输入功能。

IMKit 在 RCChatSessionInputBarControlStyle 中定义了多种排列组合模式：

您可以在会话页面 RCConversationViewController 的 viewDidLoad 之后改变输入栏的样式。使用 chatSessionInputBarControl 的 setInputBarType 方法调整顺序或禁用部分输入模式等。IMKit 在 RCChatSessionInputBarControlStyle 提供了多种排列组合。

 
RCChatSessionInputBarControlStyle style = RC_CHAT_INPUT_BAR_STYLE_SWITCH_CONTAINER_EXTENTION;
[self.yourChatVC.chatSessionInputBarControl setInputBarType:RCChatSessionInputBarControlDefaultType style:style];
              

                
已复制
                复制代码
              
              
1
2

隐藏输入栏中的表情面板按钮

输入栏中的表情按钮是表情面板的入口。在 App 不需要提供表情输入功能时，可隐藏该入口。在会话页面显示前设置 hideEmojiButton 隐藏表情面板入口。

 
[self.yourChatVC.chatSessionInputBarControl.inputContainerView.hideEmojiButton = YES];
              

                
已复制
                复制代码
              
              
1

输入区域扩展面板

融云将点击输入栏 + 号按钮时展示的面板称为扩展面板，扩展面板上展示当前可用的插件。

扩展面板插件列表

IMKit 完整插件列表如下所示。扩展面板中默认仅包含内置插件（照片、文件）。如需其他插件，请集成 IMKit 提供的插件库。

添加语音转文字插件

IMKit 基于讯飞 SDK 开发了语音转文字插件库 IFly。IMKit 集成 IFLY 库后，在扩展面板会自动生成语音输入功能入口。用户点击语音输入可以将录入的语音转成文字并展示在输入栏。

IMKit 的 IFly 库依赖于讯飞语音库 SDK iflyMSC.framework。讯飞语音库是收费业务，因此插件中不含讯飞 App Key。由于讯飞的 App Key 和 iflyMSC.framework 是强绑定关系，所以 App 在集成时必须替换 iflyMSC.framework。

请自行去讯飞官网下载 iflyMSC.framework SDK，用于替换语音输入插件中的 iflyMSC.framework。

语音插件（IFly）仅支持以源码方式导入。如需使用语音插件，必须同样以源码方式集成 IMKit SDK。参见导入SDK。

 
pod 'RongCloudOpenSource/IFly','~> x.y.z'            # 语音输入
              

                
已复制
                复制代码
              
              
1

集成步骤如下:

1. 前往讯飞官网，申请账号并下载 SDK。

2. 设置讯飞 App Key。

   1. 引用语音输入模块。

       
      #import <RongCloudOpenSource/RongiFlyKit.h>
                    
      
                      
      已复制
                      复制代码
                    
                    
      1
      
      
      

   2. 请在 RCIM 的 initWithAppKey 前调用下面接口。

       
      [RCiFlyKit setiFlyAppKey:@"讯飞 appkey"];
                    
      
                      
      已复制
                      复制代码
                    
                    
      1
      
      
      

3. 删除 RongCloudOpenSource 里的 iflyMSC.framework。iflyMSC.framework 在 Xcode 项目路径为 ：Pods -> Pods -> RongCloudOpenSource -> IFly -> Frameworks -> iflyMSC.framework

   

4. 配置 App 依赖您自行下载的 iflyMSC.framework。

   

添加其他插件

要了解如何在扩展面板添加其他插件，请参阅以下文档：

• 语音消息
• 小视频消息
• 位置消息
• 名片消息
• 集成 CallKit 通话功能

动态配置扩展面板插件

App 可以添加、删除、更新扩展面板上展示的项目，或自定义点击事件。

SDK 默认的扩展项的唯一标识符为 1XXX。如果您添加自定义扩展项，tag 值请勿使用 1XXX，否则会与 SDK 预留的扩展项唯一标识符重复。

更多标识定义请参考 RCChatSessionInputBarControl 类。

添加扩展项

您可以在 RCConversationViewController 子类的 viewdidload 触发后，添加自定义的扩展项。向扩展功能面板中插入扩展项。请勿使用 1XXX 范围的 tag 值，否则会与 SDK 预留的扩展项唯一标识符重复。

 
[self.chatSessionInputBarControl.pluginBoardView insertItem:[UIImage imageNamed:@"plugin_item_poke"] highlightedImage:[UIImage imageNamed:@"plugin_item_poke_highlighted"] title:RCDLocalizedString(@"Poke") tag:20090];
              

                
已复制
                复制代码
              
              
1

更新指定扩展项

根据 tag 更新扩展功能面板中的指定扩展项，支持更新融云提供的扩展项或 App 自定义的扩展项。

 
[self.chatSessionInputBarControl.pluginBoardView updateItemWithTag:101 normalImage:[UIImage imageNamed:@"plugin_item_poke"] highlightedImage:[UIImage imageNamed:@"plugin_item_poke_highlighted"] title:newTitle];
              

                
已复制
                复制代码
              
              
1

删除指定扩展项

根据 tag 删除扩展功能面板中的指定扩展项，支持删除融云提供的扩展项或 App 自定义的扩展项。

 
[self.chatSessionInputBarControl.pluginBoardView removeItemWithTag:PLUGIN_BOARD_ITEM_LOCATION_TAG];
              

                
已复制
                复制代码
              
              
1

处理扩展项点击事件

在会话页面重写下面方法，根据 tag 判断是否为自定义的扩展项点击事件。如果不是，则需要调用 super，否则会影响默认扩展功能的点击功能。

 
- (void)pluginBoardView:(RCPluginBoardView *)pluginBoardView clickedItemWithTag:(NSInteger)tag;
              

                
已复制
                复制代码
              
              
1