1. ChatUIKit简介

为了方便快速二次开发，和快速集成，我们提供了ChatUIKit，ChatUIKit提供了大量可重用的UI组件。

ChatUIKit依赖于ChatClient。当ChatClient调用connect后（调用connect就直接打开了数据库，不用等待成功连上），ChatUIKit就可以使用。

ChatUIKit包含以下页面：

• 会话列表界面
• 消息列表界面
• 输入框的处理
• 好友界面
• 好友请求处理界面
• 会话设置界面
• 个人信息界面
• 群组信息界面
• 频道信息界面
• 音视频通话界面

消息类型的支持：

• 文本
• 图片
• 语音
• 视频
• 文件
• 动态表情
• 输入状态
• 地理位置
• 通知消息
• 自定义消息，可以自己添加任意类型消息

2. 开发

1. 自定义消息

   1. 继承MessageContent，并添加ContentTag注解，用于标识消息类型和消息存储类型。自定义消息类型要求大于1000。消息类型，参考MessageContentType；消息存储类型，参考PersistFlag。

      一定保证自定义消息类，包含一个无参构造函数!!!

   2. 调用ChatManager#registerMessageContent注册新消息类型，或者直接修改ClientService#onCreate进行消息注册

2. 自定义消息UI

   1. 根据消息类型，继承相应的基类，并添加MessageContentType和LayoutRes注解，参考TextMessageContentViewHolder

   2. 普通消息，靠边显示，显示发送者。

      继承NormalMessageContentViewHolder，并添加相应注解，

   3. 通知消息，居中显示，不显示消息发送者。

      1. 简单/小灰条通知，界面只显示一个小灰条

         自定义通知类消息后，将其加入到SimpleNotificationMessageContentViewHolder的MessageContentType里面即可

      2. 复杂通知，支持定义UI，显示比较复杂的界面

         继承NotificationMessageContentViewHolder，实现相关方法，并添加对应的MessageContent和布局注解，请参考ExampleRichNotificationMessageContentViewHolder

   4. 响应用户动作

      1. 单击

         用@OnClick注解单击的响应方法，用法和butterknife一致。参考ExampleRichNotificationMessageContentViewHolder#onClick，支持点击消息的不同UI作出不同的响应。

      2. 长按

         用@MessageContextMenuItem注解长按响应方法，当有多个长按响应时，会弹出选择对话框，让用户选择选择目标响应，可参考ExampleRichNotificationMessageContentViewHolder#forwardMessage。另外，支持根据不同的消息、会话，过滤长按菜单选项，可参考ExampleRichNotificationMessageContentViewHolder#contextMenuItemFilter

      3. 双击，目前尚未支持

   5. 注册自定义消息UI

      调用MessageViewHolderManager#registerMessageViewHolder注册新的消息UI，或者直接修改MessageViewHolderManager#init进行注册。

3. 自定义会话类型

   1. 野火通根据会话类型和会话线路唯一标识一种会话类型，故可以采用相应会话类型(单聊、群里等)组合不同会话线路实现自定义会话

   2. 继承ConversationViewHolder自定义会话类型UI，添加ConversationInfoType和@EnableContextMenu注解，其中@EnableContextMenu可选，表示是否允许长按操作。

   3. 注册定义会话类型UI

      调动ConversationViewHolderManager#registerConversationViewHolder，或者直接修改ConversationViewHolderManager进行自定义会话类型UI的注册。

4. 自定义会话扩展

   会话扩展指的是：会话界面，点击+号，弹出的那些快捷功能。

   1. 自定义扩展

      继承ConversationExt，并实现设置icon等相关方法，用ExtContextMenuItem注解需要响应点击的方法，当有多个时，会弹出选择对话框。如果需要使用startActivityForResult方法，需用ConversationExt#startActivityForResult，以保证正确回调onActivityResult，可参考FileExt

   2. 如果需要实现类似微信语音输入的扩展，可参考ExampleAudioInputExt

   3. 注册扩展

      调用ConversationExtManager#registerExt，或直接修改ConversationExtManager#init进行扩展注册。

5. 自定义会话列表状态通知

   1. 继承StatusNotification，并实现其方法，
   2. 调用ConversationListFragment#showNotification显示通知，调用ConversationListFragment#clearNotification清除通知。

6. 修改会话列表长按菜单

   参考ConversationViewHolder#removeConversation和ConversationViewHolder#contextMenuItemFilter

7. 自定义搜索

   1. 继承SearchableModule，并实现其方法，参考GroupSearchViewModule
   2. 参考SearchPortalActivity#initSearchModule配置当前想进行的搜索项，参考SearchPortalActivity#search开始搜索

8. 推送集成

   参考push-server