IM UIKit 的会话模块（NEChatUIKit）提供会话界面 UI 的自定义配置项，助您快速实现该界面的 UI 个性化定制。会话消息模块（NEChatUIKit）提供以下两种方式对会话消息的 UI 进行个性化定制。

• 通过接口配置的方式自定义 UI。

• 通过源码修改的方式自定义 UI。

  请优先使用接口配置方式。如果接口中的配置项满足您的界面个性化需求，请优先使用接口配置方式。

自定义功能概述

UI 元素自定义

会话消息界面可自定义的 UI 元素包括但不限于下图中的标注项。

ChatUIConfig 是整个会话消息的配置文件，其中 UI 实例化对象类型为 ChatUIConfig。

您可通过 ChatUIConfig 中的个性化配置项修改会话界面 UI 元素，如消息体、输入按钮和消息长按菜单等，具体如下：

界面布局自定义

除了界面的 UI 元素，您也可对界面的布局进行自定义。 在 NEChatUIKit 模块中，所有的 Cell 都继承于 NEChatBaseCell。 以基础版皮肤中的文本消息为例，其继承链路为：ChatMessageTextCell -> NormalChatMessageBaseCell -> NEBaseChatMessageCell -> NEChatBaseCell。

会话界面的默认布局如下图所示：

该界面各视图的说明如下：

通过配置项自定义 UI 示例

使用系统导航栏（不推荐）

UIKit 默认使用自定义导航栏，如果你需要使用系统导航栏，请在会话消息界面加载之前完成如下配置：

Swift// import NECommonUIKit
NEConfigManager.instance.setParameter(key: useSystemNav, value: true)

Objective-C// #import <NECommonUIKit/NECommonUIKit-Swift.h>
[NEConfigManager.instance setParameterWithKey:@"useSystemNav" value:YES];

修改界面标题栏右侧图标

• 示例代码

  Swift

  SwiftChatUIConfig.shared.ui.messageProperties.titleBarRightRes = UIImage(named: "image name")
  

  Objective-C

  Objective-CChatUIConfig.shared.ui.messageProperties.titleBarRightRes = [UIImage imageNamed:@"image name"];
  

• 效果对比

  默认	自定义后

隐藏界面标题栏

• 示例代码

  Swift

  SwiftChatUIConfig.shared.ui.messageProperties.showTitleBar = false
  

  Objective-C

  objChatUIConfig.shared.ui.messageProperties.showTitleBar = NO;
  

• 效果对比

  默认	自定义后

修改会话界面背景色

• 示例代码

  Swift

  SwiftChatUIConfig.shared.ui.messageProperties.chatViewBackground = UIColor.red
  

  Objective-C

  Objective-CChatUIConfig.shared.ui.messageProperties.chatViewBackground = [UIColor redColor];
  

• 效果对比

  默认	自定义后

修改消息体背景色

• 示例代码

  Swift

  Swift//修改自己消息体背景色
  ChatUIConfig.shared.ui.messageProperties.selfMessageBgColor = UIColor.green
  ChatUIConfig.shared.ui.messageProperties.selfMessageBgImage = UIImage() // 隐藏气泡
  //修改对方消息体背景色
  ChatUIConfig.shared.ui.messageProperties.receiveMessageBgColor = UIColor.gray
  ChatUIConfig.shared.ui.messageProperties.receiveMessageBgImage = UIImage() // 隐藏气泡
  

  Objective-C

  Objective-C//修改自己消息体背景色
  ChatUIConfig.shared.ui.messageProperties.selfMessageBgColor = [UIColor blueColor];
  ChatUIConfig.shared.ui.messageProperties.selfMessageBgImage = [UIImage new]; // 隐藏气泡
  //修改对方消息体背景色
  ChatUIConfig.shared.ui.messageProperties.receiveMessageBgColor = [UIColor blueColor];
  ChatUIConfig.shared.ui.messageProperties.receiveMessageBgImage = [UIImage new]; // 隐藏气泡
  

  会话消息的消息体背景色与气泡共存，若只需要实现纯色背景色效果，请将默认气泡图片隐藏（置为 nil）

• 效果对比

  默认	自定义后

会话消息标题栏下方扩展视图

可在标题栏和消息详情中间插入扩展视图，例如显示群聊人数、在线状态，插入温馨提示等。

• 示例代码

  Swift

  Swift/// 消息列表的视图控制器回调，回调中会返回消息列表的视图控制器
  /// customTopView：自定义视图
  ChatUIConfig.shared.customController = { viewController in
      // 顶部bodyTopView中添加自定义view（需要设置bodyTopView的高度）
      self.customTopView.button.setTitle("通过配置项添加", for: .normal)
      viewController.bodyTopView.backgroundColor = .purple
      viewController.bodyTopView.addSubview(customTopView)
      viewController.bodyTopViewHeight = 80
  }
  

  Objective-C

  Objective-C/// 消息列表的视图控制器回调，回调中会返回消息列表的视图控制器
  /// customTopView：自定义视图
  ChatUIConfig.shared.customController = ^(ChatViewController * _Nonnull viewController) {
      // 顶部bodyTopView中添加自定义view（需要设置bodyTopView的高度）
      [self.customTopView setTitle:@"通过配置项添加" forState:UIControlStateNormal];
      viewController.bodyTopView.backgroundColor = UIColor.purpleColor;
      [viewController.bodyTopView addSubview:customTopView];
      viewController.bodyTopViewHeight = 80;
  };
  

• 效果对比

  默认	自定义后

输入框上方区域扩展视图

可在输入框上方插入扩展视图，例如添加候选词条、个性化功能等。

• 示例代码

  Swift

  Swift/// 消息列表的视图控制器回调，回调中会返回消息列表的视图控制器
  /// customTopView：自定义视图
  ChatUIConfig.shared.customController = { viewController in
  // 底部bodyBottomView中添加自定义view（需要设置bodyBottomView的高度）
  self.customBottomView.button.setTitle("通过配置项添加", for: .normal)
  viewController.bodyBottomView.backgroundColor = .purple
  viewController.bodyBottomView.addSubview(customBottomView)
  viewController.bodyBottomViewHeight = 60
  }
  

  Objective-C

  Objective-C/// 消息列表的视图控制器回调，回调中会返回消息列表的视图控制器
  /// customTopView：自定义视图
  ChatUIConfig.shared.customController = ^(ChatViewController * _Nonnull viewController) {
      // 底部bodyBottomView中添加自定义view（需要设置bodyBottomView的高度）
      [self.customTopView setTitle:@"通过配置项添加" forState:UIControlStateNormal];
      viewController.bodyBottomView.backgroundColor = UIColor.purpleColor;
      [viewController.bodyBottomView addSubview:customTopView];
      viewController.bodyBottomViewHeight = 60;
  };
  

• 效果对比

  默认	自定义后

源码介绍

会话消息

ChatViewController 为会话消息的基类，内部封装了 UITableView。

所有类型的消息都以 Cell 形式展示，需要在 cellRegisterDic 注册列表中声明不同消息体对应的 Cell 类，用于 UITableView 的 Cell 注册。利用面向对象语言的多态性，不同类型的 Cell 重写了父类的 setModel 方法，且每种类型的 Cell 都有与之对应的数据模型。

默认的 cellRegisterDic 注册方法请参考 ChatMessageHelper 工具类中的 getChatCellRegisterDic 方法

对应关系如下:

赋值处理

1. 根据 V2NIMMessage 的 messageType 类型，判断消息类型。

2. 针对不同的消息类型，使用对应的数据模型进行解析。

   swiftpublic class ChatMessageHelper: NSObject {
       public static func modelFromMessage(message: NIMMessage) -> MessageModel {
           var model: MessageModel
           switch message.messageType {
           case .MESSAGE_TYPE_VIDEO:
           model = MessageVideoModel(message: message)
           case .MESSAGE_TYPE_TEXT:
           model = MessageTextModel(message: message)
           case .MESSAGE_TYPE_IMAGE:
           model = MessageImageModel(message: message)
           case .MESSAGE_TYPE_AUDIO:
           model = MessageAudioModel(message: message)
           case .MESSAGE_TYPE_NOTIFICATION, .MESSAGE_TYPE_TIP:
           model = MessageTipsModel(message: message)
           case .MESSAGE_TYPE_FILE:
           model = MessageFileModel(message: message)
           case .MESSAGE_TYPE_LOCATION:
           model = MessageLocationModel(message: message)
           case .MESSAGE_TYPE_CALL:
           model = MessageCallRecordModel(message: message)
           case .MESSAGE_TYPE_CUSTOM:
           if let type = NECustomAttachment.typeOfCustomMessage(message.attachment) {
               if type == customMultiForwardType {
               return MessageCustomModel(message: message, contentHeight: Int(customMultiForwardCellHeight))
               }
               if type == customRichTextType {
               return MessageRichTextModel(message: message)
               }
   
               // 注册过的自定义消息类型
               return MessageCustomModel(message: message, contentHeight: Int(customMultiForwardCellHeight))
           }
           fallthrough
           default:
           // 未识别的消息类型，默认为文本消息类型，text 为未知消息体
           message.text = chatLocalizable("msg_unknown")
           model = MessageTextModel(message: message)
           }
           return model
       }
   }
   

3. 在 ChatViewController 的 Cell 展示数据源方法中进行赋值。

   swiftopen func tableView(_ tableView: UITableView,
                       cellForRowAt indexPath: IndexPath) -> UITableViewCell {
       let model = viewModel.messages[indexPath.row]
       var reuseId = "\(NEBaseChatMessageCell.self)"
       if model.replyedModel?.isReplay == true,
           model.isRevoked == false {
           if model.customType == customRichTextType {
               reuseId = "\(MessageType.richText.rawValue)"
           } else {
               reuseId = "\(MessageType.reply.rawValue)"
           }
       } else {
           let key = "\(model.type.rawValue)"
           if model.type == .custom {
               if model.customType == customMultiForwardType {
               reuseId = "\(MessageType.multiForward.rawValue)"
               } else if model.customType == customRichTextType {
               reuseId = "\(MessageType.richText.rawValue)"
               } else if NEChatUIKitClient.instance.getRegisterCustomCell()["\(model.customType)"] != nil {
               reuseId = "\(model.customType)"
               } else {
               reuseId = "\(NEBaseChatMessageCell.self)"
               }
           } else if model.type == .notification || model.type == .tip {
               reuseId = "\(MessageType.time.rawValue)"
           } else if cellRegisterDic[key] != nil {
               reuseId = key
           } else {
               reuseId = "\(NEBaseChatMessageCell.self)"
           }
       }
   
       let cell = tableView.dequeueReusableCell(withIdentifier: reuseId, for: indexPath)
       if let c = cell as? NEBaseChatMessageTipCell {
           if let m = model as? MessageTipsModel {
               c.setModel(m)
           }
           return c
       } else if let c = cell as? NEBaseChatMessageCell {
           c.delegate = self
   
           ...
   
           if let m = model as? MessageContentModel {
               c.setModel(m, m.message?.isSelf ?? false)
               c.setSelect(m, isMutilSelect)
           }
   
           return c
       } else if let c = cell as? NEChatBaseCell, let m = model as? MessageContentModel {
           c.setModel(m, m.message?.isSelf ?? false)
           return cell
       } else {
           return NEBaseChatMessageCell()
       }
   }
   

子类继承

协同版皮肤下，P2PChatViewController 和 TeamChatViewController 均继承于 NormalChatViewController，NormalChatViewController 则继承于 ChatViewController

这里以 P2PChatViewController 为例，具体如下:

swift@objcMembers
open class P2PChatViewController: NormalChatViewController {

    /// 重写父类的构造方法
    /// - Parameter conversationId: 会话 ID
    /// - Parameter anchor: 锚点消息
    public init(conversationId: String, anchor: V2NIMMessage?) {
        super.init(conversationId: conversationId)
        viewModel = P2PChatViewModel(conversationId: conversationId, anchor: anchor)
    }
    ...
}

swift@objcMembers
open class NormalChatViewController: ChatViewController {

    override public init(conversationId: String) {
        super.init(conversationId: conversationId)
        navigationView.backgroundColor = .white
        navigationController?.navigationBar.backgroundColor = .white
        cellRegisterDic = ChatMessageHelper.getChatCellRegisterDic(isFun: false)

        topMessageView.topImageView.image = UIImage.ne_imageNamed(name: "top_message_image")
        topMessageView.layer.borderColor = UIColor(hexString: "#E8EAED").cgColor
        topMessageView.layer.borderWidth = 1
    }
    ...
}

通过源码自定义 UI

布局中的内容概略如下：

swift//这里以 ChatMessageTextCell 为例。
open class ChatMessageTextCell: NormalChatMessageBaseCell {
    override public init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        commonUI()
    }

    public required init?(coder: NSCoder) {
        super.init(coder: coder)
    }

    open func commonUI() {
        bubbleImageLeft.addSubview(contentLabelLeft)
        NSLayoutConstraint.activate([
        contentLabelLeft.rightAnchor.constraint(equalTo: bubbleImageLeft.rightAnchor, constant: -chat_content_margin),
        contentLabelLeft.leftAnchor.constraint(equalTo: bubbleImageLeft.leftAnchor, constant: chat_content_margin),
        contentLabelLeft.topAnchor.constraint(equalTo: bubbleImageLeft.topAnchor, constant: chat_content_margin),
        contentLabelLeft.bottomAnchor.constraint(equalTo: bubbleImageLeft.bottomAnchor, constant: -chat_content_margin),
        ])

        bubbleImageRight.addSubview(contentLabelRight)
        NSLayoutConstraint.activate([
        contentLabelRight.rightAnchor.constraint(equalTo: bubbleImageRight.rightAnchor, constant: -chat_content_margin),
        contentLabelRight.leftAnchor.constraint(equalTo: bubbleImageRight.leftAnchor, constant: chat_content_margin),
        contentLabelRight.topAnchor.constraint(equalTo: bubbleImageRight.topAnchor, constant: chat_content_margin),
        contentLabelRight.bottomAnchor.constraint(equalTo: bubbleImageRight.bottomAnchor, constant: -chat_content_margin),
        ])
    }

    override open func showLeftOrRight(showRight: Bool) {
        super.showLeftOrRight(showRight: showRight)
        contentLabelLeft.isHidden = showRight
        contentLabelRight.isHidden = !showRight
    }

    override open func setModel(_ model: MessageContentModel, _ isSend: Bool) {
        super.setModel(model, isSend)
        let contentLabel = isSend ? contentLabelRight : contentLabelLeft
        if let m = model as? MessageTextModel {
        contentLabel.attributedText = m.attributeStr
        contentLabel.accessibilityValue = m.message?.text
        }
    }
}

自定义标题栏按钮

自定义导航栏需要使用 navigationView 来实现。

navigationView 采用固定按钮，包括左侧的返回按钮（backButton）和右侧的更多按钮（moreButton），此外还包含中间的导航栏标题（navTitle）和底部分割线(titleBarBottomLine)，具体定义请参考 NENavigationView 类，所有控件均可访问修改。

• 示例代码

  Swift

  Swift// 修改标题
  navigationView.navTitle.text = "title"
  
  // 修改右侧按钮文案
  navigationView.setMoreButtonTitle("clear")
  
  // 修改右侧按钮文案颜色
  navigationView.moreButton.setTitleColor(.red, for: .normal)
  
  // 修改右侧按钮单击事件
  navigationView.moreButton.addTarget(self, action: #selector(clearMessage), for: .touchUpInside)
  

  Objective-C

  Objective-C// 修改标题
  navigationView.navTitle.text = @"title";
  
  // 修改右侧按钮文案
  [navigationView setMoreButtonTitle:@"clear"];
  
  // 修改右侧按钮文案颜色
  [navigationView.moreButton setTitleColor:[UIColor redColor] forState:UIControlStateNormal];
  
  // 修改右侧按钮单击事件
  [navigationView.moreButton addTarget:self action:@selector(clearMessage) forControlEvents:UIControlEventTouchUpInside];
  

• 效果对比

  默认	自定义后

自定义标题栏标题

• 示例代码（Swfit）

  swiftclass CustomP2PChatViewController: P2PChatViewController {
      override func viewDidLoad() {
          super.viewDidLoad()
  
          // Do any additional setup after loading the view.
      }
  
      // 自定义标题
      override func getSessionInfo(sessionId: String, _ completion: @escaping () -> Void) {
          super.getSessionInfo(sessionId: sessionId) {
          self.title = "小易助手"
          completion()
          }
      }
  }
  

  网易云信 IM 默认会在数据加载完成后设置会话消息页面标题，如需自定义标题，请重写 getSessionInfo 方法，并在父类方法调用之后设置其值。

• 效果对比

  默认	自定义后

会话消息标题栏下方扩展视图

可在标题栏和消息详情中间插入扩展视图，例如插入 温馨提示。

• 示例代码（Swfit）

  swiftclass CustomP2PChatViewController: P2PChatViewController {
      public lazy var customTopView: CustomView = {
          let view = CustomView(frame: CGRect(x: 0, y: 10, width: NEConstant.screenWidth, height: 40))
          view.backgroundColor = .blue
          return view
      }()
  
      override func viewDidLoad() {
          super.viewDidLoad()
          ...
  
          // 聊天页顶部导航栏下方扩展视图示例
          customTopView.btn.setTitle( **通过重写方式添加** , for: .normal)
          bodyTopView.addSubview(customTopView)
          bodyTopView.backgroundColor = .yellow
          bodyTopViewHeight = 80
      }
  }
  

  示例代码中 bodyTopView 为聊天页顶部标题栏下方预留的扩展视图，bodyTopViewHeight 为该扩展视图的高度，更改此变量会刷新页面布局。

• 效果对比

  默认	自定义后

输入框上方区域扩展视图

用户可继承聊天界面详情页（P2PChatViewController/TeamChatViewController），在父类渲染页面之前更改输入框上方区域。

• 示例代码（Swfit）

  swiftclass CustomP2PChatViewController: P2PChatViewController {
      override func viewDidLoad() {
          super.viewDidLoad()
          ...
  
          // 输入框上区域扩展视图示例
          customBottomView.btn.setTitle("通过重写方式添加", for: .normal)
          bodyBottomView.addSubview(customBottomView)
          bodyBottomView.backgroundColor = .yellow
          bodyBottomViewHeight = 60
      }
  }
  

  示例代码中 bodyBottomView 为输入框上方预留的扩展视图，bodyBottomViewHeight 为该扩展视图的高度，更改此变量会刷新页面布局。

• 效果对比

  默认	自定义后

自定义输入框左右间距

用户可自定义输入框左右间距，从而实现在输入框左右添加控件。

• 示例代码（Swfit）

  swiftclass CustomP2PChatViewController: P2PChatViewController {
      override func viewDidLoad() {
          super.viewDidLoad()
          ...
          // 聊天页输入框左右间距自定义
          chatInputView.textviewLeftConstraint?.constant = 100
          chatInputView.textviewRightConstraint?.constant = -100
      }
  }
  

  示例代码中 textviewLeftConstraint/textviewRightConstraint 表示输入框左侧/右侧距页面左边框/右边框的距离，即输入框左右间距，更改此变量会刷新页面布局。

• 效果对比

  默认	自定义后

自定义底部工具条

用户可自定义输入框底部工具条的按钮样式和单击事件。

• 示例代码（Swfit）

  swift// 通过配置项实现
      class CustomP2PChatViewController: P2PChatViewController {
          
          override func viewDidLoad() {
  
          /// 文本输入框下方 tab 按钮定制
          ChatUIConfig.shared.ui.chatInputBar = { [weak self] item in
          // 修改
          let takePicBtn = item[2]
          takePicBtn.setImage(nil, for: .normal)
          takePicBtn.setTitle("拍照", for: .normal)
          takePicBtn.setTitleColor(.blue, for: .normal)
          takePicBtn.removeTarget(takePicBtn.superview, action: nil, for: .allEvents)
          takePicBtn.addTarget(self, action: #selector(self?.customClick), for: .touchUpInside)
  
          // 新增
          let button = UIButton(type: .custom)
          button.setTitle("新增", for: .normal)
          button.setTitleColor(.blue, for: .normal)
          button.addTarget(self, action: #selector(self?.customClick), for: .touchUpInside)
          item.append(button)
          }
  
          ...
  
          super.viewDidLoad()
          }
      }
  

  swift// 通过重写实现
  class CustomP2PChatViewController: P2PChatViewController {
      override func viewDidLoad() {
          super.viewDidLoad()
          ...
  
          let subviews = chatInputView.stackView.subviews
          subviews.forEach { view in
              view.removeFromSuperview()
              chatInputView.stackView.removeArrangedSubview(view)
          }
  
              let titles = ["表情", "语音", "照片", "更多"]
          for i in 0 ..< titles.count {
              let button = UIButton(type: .custom)
              let title = titles[i]
              button.translatesAutoresizingMaskIntoConstraints = false
              button.addTarget(self, action: #selector(buttonEvent), for: .touchUpInside)
              button.tag = i
              button.setTitle(title, for: .normal)
              button.setTitleColor(.blue, for: .normal)
              chatInputView.stackView.addArrangedSubview(button)
          }
      }
  
          @objc func buttonEvent(_ btn: UIButton) {
          if btn.tag == 0 { // 表情
          layoutInputView(offset: bottomExanpndHeight, true)
          chatInputView.addEmojiView()
          } else if btn.tag == 1 { // 语音
          layoutInputView(offset: bottomExanpndHeight, true)
          chatInputView.addRecordView()
          } else if btn.tag == 2 { // 照片
          goPhotoAlbumWithVideo(self)
          } else if btn.tag == 3 { // 更多
          layoutInputView(offset: bottomExanpndHeight, true)
          chatInputView.addMoreActionView()
          }
      }
  }
  

  示例代码中，chatInputView 为输入框视图，chatInputView.stackView 为输入框底部工具栏视图，代码先将工具栏视图中的所有子视图（按钮）移除，然后依次添加自定义的子视图（按钮），并为按钮绑定单击事件 buttonEvent。buttonEvent 中利用 tag 对按钮进行区分，实现具体的逻辑。

• 效果对比

  默认	自定义后

自定义“更多”功能页

用户可根据业务需求，自定义聊天输入区域的 更多 功能区。

• 示例代码（Swfit）

  swift// 通过配置项实现
  class CustomP2PChatViewController: P2PChatViewController {
  
      /// 更多区域功能列表自定义示例
      ChatUIConfig.shared.ui.chatInputMenu = { [weak self] menuList in
          // 新增未知类型
          let itemNew = NEMoreItemModel()
          itemNew.customImage = UIImage(named: "mine_collection")
          itemNew.customDelegate = self
          itemNew.action = #selector(self?.customClick)
          itemNew.title = "新增"
          menuList.append(itemNew)
  
          // 覆盖已有类型
          // 遍历 menuList，根据 type 覆盖已有类型
          for item in menuList {
              if item.type == .rtc {
              item.customImage = UIImage(named: "mine_setting")
              item.customDelegate = self
              item.action = #selector(self?.customClick)
              item.type = .rtc
              item.title = "覆盖"
              }
          }
  
          // 移除已有类型
          // 遍历 menuList，根据 type 移除已有类型
          for (i, item) in menuList.enumerated() {
              if item.type == .file {
              menuList.remove(at: i)
              }
          }
      }
  
  ...
  
      // 需要在父类视图加载之前完成自定义
      super.viewDidLoad()
  }
  

  swift// 通过重写方式实现
  class CustomP2PChatViewController: P2PChatViewController {
      override func viewDidLoad() {
          /// **更多** 区域功能列表自定义示例
  
          // 新增未知类型
          let itemNew = NEMoreItemModel()
          itemNew.customImage = UIImage(named: "mine_collection")
          itemNew.customDelegate = self
          itemNew.action = #selector(customClick)
          itemNew.title = "新增"
          NEChatUIKitClient.instance.moreAction.append(itemNew)
  
          // 覆盖已有类型
          // 遍历 NEChatUIKitClient.instance.moreAction，根据 type 覆盖已有类型
          for (i, item) in NEChatUIKitClient.instance.moreAction.enumerated() {
              if item.type == .rtc {
                  let itemReplace = NEChatUIKitClient.instance.moreAction[i]
                  itemReplace.customImage = UIImage(named: "mine_setting")
                  itemReplace.customDelegate = self
                  itemReplace.action = #selector(customClick)
                  itemReplace.type = .rtc
                  itemReplace.title = "覆盖"
              }
          }
  
          // 移除已有类型
          // 遍历 NEChatUIKitClient.instance.moreAction，根据 type 移除已有类型
          for (i, item) in NEChatUIKitClient.instance.moreAction.enumerated() {
              if item.type == .file {
                  NEChatUIKitClient.instance.moreAction.remove(at: i)
              }
          }
  
          ...
  
          // 需要在父类视图加载之前完成自定义
          super.viewDidLoad()
      }
  }
  

  上述代码中的 NEChatUIKitClient.instance.moreAction 为全局 更多 功能列表，通过 itemNew.customImage 和 itemNew.customDelegate 共同组合来实现按钮的自定义单击事件。IM UIKit 默认实现的能力如下表所示，内部对这些类型的单击事件做了默认实现，可根据业务需要来决定是否覆盖。

  标识 Action	说明
  NEMoreActionType.takePicture	拍照
  NEMoreActionType.file	发送文件
  NEMoreActionType.rtc	音视频通话
  NEMoreActionType.location	地理位置

• 效果对比

  默认	自定义后

消息长按菜单过滤部分能力

长按消息功能弹窗可设置全局过滤列表或者针对单个功能项进行修改。

• 示例代码

  swiftclass CustomP2PChatViewController: P2PChatViewController {
      override func viewDidLoad() {
          ...
          // 长按消息功能弹窗过滤列表（过滤列表中的能力会在整个页面中禁用）
          operationCellFilter = [.delete]
      }
  
      // 长按消息功能弹窗列表自定义（可针对不同 type 消息自定义长按功能项）
      override func setOperationItems(items: inout [OperationItem], model: MessageContentModel?) {
          if model?.type == .rtcCallRecord {
          items.append(OperationItem.replayItem())
          }
      }
  }
  

• 代码解读

  • 示例代码中的 operationCellFilter 为长按菜单过滤列表，其中的类型在整个会话详情页不会显示，最终的效果表现为：整个会话详情页的所有消息类型的长按菜单中均不显示 删除 功能。

  • 示例代码中的 setOperationItems 方法会返回每条消息的长按功能弹窗列表，可针对单条消息或者某种类型的消息进行长按功能项的自定义

• 效果对比

  默认	自定义后

消息长按弹出菜单自定义

• 示例代码

  swiftclass CustomP2PChatViewController: P2PChatViewController {
      override func viewDidLoad() {
          ...
  
          /// 消息长按弹出菜单自定义
          ChatUIConfig.shared.ui.chatPopMenu = { menuList, model in
              // 遍历 menuList，根据 type 覆盖已有类型
              // 将所有文本消息的 **复制** 替换成 **粘贴**
              if model?.type == .text {
                  for item in menuList {
                  if item.type == .copy {
                      item.text = "粘贴"
                  }
                  }
              }
          }
  
          /// 消息长按弹出菜单的单击事件回调，根据按钮类型进行区分
          ChatUIConfig.shared.ui.popMenuClick = { [weak self] item in
              switch item.type {
              case .copy:
                  // 更改 **复制** 类型按钮的单击事件
                  self?.customClick()
              default:
                  break
              }
          }
      }
  }
  

• 代码解读

  示例代码中的 chatPopMenu 为消息长按弹出菜单回调、popMenuClick 为消息长按弹出菜单的单击事件回调，可以根据 type 类型进行区分进而实现自定义。

• 效果对比

  默认	自定义后