You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
226 lines
8.0 KiB
226 lines
8.0 KiB
2 years ago
|
# 定制聊天窗口
|
||
|
|
||
|
默认的聊天窗口已经能满足大部分的需求,考虑到开发者可能有更特殊的要求,UIKit 提供非常灵活的个性定制,包括聊天窗口界面样式、会话中点击事件、自定义扩展消息类型显示、消息撤回和转发过滤器等。
|
||
|
|
||
|
## <span id="聊天界面介绍">聊天界面介绍</span>
|
||
|
|
||
|
### <span id="聊天界面代码结构">聊天界面代码结构</span>
|
||
|
聊天界面的主要实现在 `MessageFragment` 中。主要包括两个子模块 MessageListPanelEx (消息列表)和 InputPanel (输入框)。MessageFragment 与 子模块之间的交互依靠 ModuleProxy 这个代理类。MessageFragment 与子模块之间的参数传递依靠 Container 这个容器。具体结构参考如下:
|
||
|
|
||
|
![image](https://github.com/netease-im/NIM_Resources/blob/master/Android/Images/message_fragment.png)
|
||
|
|
||
|
### <span id="聊天界面布局">聊天界面布局</span>
|
||
|
|
||
|
聊天界面相关属性,如下图:
|
||
|
|
||
|
![image](https://github.com/netease-im/NIM_Resources/blob/master/Android/Images/content.png)
|
||
|
|
||
|
![image](https://github.com/netease-im/NIM_Resources/blob/master/Android/Images/input.png)
|
||
|
|
||
|
![image](https://github.com/netease-im/NIM_Resources/blob/master/Android/Images/voice_name.png)
|
||
|
|
||
|
## <span id="定制化">定制化</span>
|
||
|
|
||
|
### <span id="简单定制">简单定制</span>
|
||
|
|
||
|
直接修改组件中提供的 `UIKitOptions` 类,进行简单的开关配置,提供的功能如下:
|
||
|
|
||
|
|名称|定义|
|
||
|
|:---|:---|
|
||
|
|aitEnable|开启@功能|
|
||
|
|aitTeamMember|支持@群成员|
|
||
|
|aitIMRobot|支持在 IM 聊天中@机器人|
|
||
|
|aitChatRoomRobot|支持在 Chat Room 中@机器人|
|
||
|
|displayMsgTimeWithInterval|消息列表每隔多久显示一条消息时间信息,默认五分钟|
|
||
|
|messageCountLoadOnce|单次抓取消息条数配置|
|
||
|
|messageLeftBackground|IM 接收到的消息时,内容区域背景的drawable id|
|
||
|
|messageRightBackground|IM 发送出去的消息时,内容区域背景的drawable id|
|
||
|
|chatRoomMsgLeftBackground|chat room 接收到的消息时,内容区域背景的drawable id|
|
||
|
|chatRoomMsgRightBackground|chat room 发送出去的消息时,内容区域背景的drawable id|
|
||
|
|shouldHandleReceipt|全局是否使用消息已读,如果设置为false,UIKit 组件将不会发送、接收已读回执|
|
||
|
|maxInputTextLength|文本框最大输入字符数目|
|
||
|
|audioRecordType|录音类型,默认aac|
|
||
|
|audioRecordMaxTime|录音时长限制,单位秒,默认最长120s|
|
||
|
|disableAudioPlayedStatusIcon|不显示语音消息未读红点|
|
||
|
|disableAutoPlayNextAudio|禁止音频轮播|
|
||
|
|
||
|
### <span id="深度定制">深度定制</span>
|
||
|
|
||
|
- 深度定制可提供的配置有:
|
||
|
|
||
|
|配置项|
|
||
|
|:---|
|
||
|
|输入框更多菜单项定制|
|
||
|
|ActionBar 右侧按钮定制|
|
||
|
|自定义贴图定制|
|
||
|
|会话中点击事件的定制|
|
||
|
|
||
|
- 提供两种深度定制方式:
|
||
|
|
||
|
1\. 开发者可以通过设置默认配置,替换整个单聊和群聊的聊天界面。
|
||
|
|
||
|
2\. 开发者可以自定义每个独立的聊天界面。
|
||
|
|
||
|
- 定制步骤:
|
||
|
|
||
|
1\. 初始化并配置 SessionCustomization 对象;具体配置项如何配置,见下文。
|
||
|
|
||
|
2\. 挑选定制方式:
|
||
|
|
||
|
(1)设置默认配置。将 SessionCustomization 对象设置到默认配置项中。
|
||
|
|
||
|
```
|
||
|
// 设置单聊界面定制
|
||
|
NimUIKit.setCommonP2PSessionCustomization(commonP2PSessionCustomization);
|
||
|
|
||
|
// 设置群聊界面定制
|
||
|
NimUIKit.setCommonTeamSessionCustomization(commonTeamSessionCustomization);
|
||
|
```
|
||
|
|
||
|
(2)自定义独立的聊天界面。使用 NimUIKit#startChatting 方法,直接将 SessionCustomization 对象作为参数,打开聊天界面。
|
||
|
|
||
|
```
|
||
|
// 启动单聊
|
||
|
NimUIKit.startChatting(context, account, SessionTypeEnum.P2P, sessionCustomization);
|
||
|
|
||
|
// 启动群聊
|
||
|
NimUIKit.startChatting(context, teamId, SessionTypeEnum.Team, sessionCustomization);
|
||
|
```
|
||
|
|
||
|
#### <span id="输入框更多菜单项定制">输入框更多菜单项定制</span>
|
||
|
|
||
|
1\. 定义一个菜单项
|
||
|
|
||
|
可以进行菜单图片和文案资源的配置,并且定义图片的点击事件,以及处理回调事件。
|
||
|
|
||
|
具体步骤:
|
||
|
|
||
|
(1) 继承 BaseAction,初始化时,传入图片资源和文案资源。
|
||
|
|
||
|
(2)继承 BaseAction,根据需要重写 onClick() 或 onActivityResult() 方法
|
||
|
|
||
|
```
|
||
|
// 定义一个action
|
||
|
public class FileAction extends BaseAction {
|
||
|
|
||
|
public FileAction() {
|
||
|
super(R.drawable.message_plus_file_selector, R.string.input_panel_file);
|
||
|
}
|
||
|
|
||
|
@Override
|
||
|
public void onClick() {
|
||
|
|
||
|
}
|
||
|
|
||
|
@Override
|
||
|
public void onActivityResult(int requestCode, int resultCode, Intent data) {
|
||
|
|
||
|
}
|
||
|
}
|
||
|
```
|
||
|
|
||
|
2\. 按指定顺序添加菜单项到更多菜单视图。
|
||
|
|
||
|
步骤如下:
|
||
|
|
||
|
(1)构造 SessionCustomization 对象。
|
||
|
|
||
|
(2)构造 List<BaseAction> actions 集合,按照想要排列的顺序添加 action。
|
||
|
|
||
|
(3)设置 customization.actions
|
||
|
|
||
|
(4)调用 NimUIKit#startChatting 打开的聊天界面,即是配置好的效果。
|
||
|
|
||
|
```
|
||
|
SessionCustomization sessionCustomization = new SessionCustomization();
|
||
|
ArrayList<BaseAction> actions = new ArrayList<>();
|
||
|
actions.add(new AVChatAction(AVChatType.AUDIO));
|
||
|
actions.add(new AVChatAction(AVChatType.VIDEO));
|
||
|
actions.add(new SnapChatAction());
|
||
|
actions.add(new GuessAction());
|
||
|
actions.add(new FileAction());
|
||
|
sessionCustomization.actions = actions;
|
||
|
|
||
|
NimUIKit.startChatting(context, account, SessionTypeEnum.P2P, sessionCustomization, null);
|
||
|
```
|
||
|
|
||
|
#### <span id="ActionBar 右侧按钮定制">ActionBar 右侧按钮定制</span>
|
||
|
|
||
|
聊天界面的 ActionBar 右上角的按钮,支持自定义,包括按钮的图像,按钮的个数,按钮的点击事件。
|
||
|
|
||
|
具体步骤如下:
|
||
|
|
||
|
1\. 首先初始化对象 SessionCustomization;
|
||
|
|
||
|
2\. 初始化 ArrayList<SessionCustomization.OptionsButton> 列表 buttons;
|
||
|
|
||
|
3\. 初始化一个 SessionCustomization.OptionsButton 的 button;
|
||
|
|
||
|
4\. 设置 button的点击事件和图像资源;
|
||
|
|
||
|
5\. 将 button 添加到列表,并将列表设置到 sessionCustomization.buttons = buttons;
|
||
|
|
||
|
6\. 调用 NimUIKit#startChatting 打开的聊天界面,即是配置好的效果。
|
||
|
|
||
|
```
|
||
|
SessionCustomization sessionCustomization = new SessionCustomization();
|
||
|
ArrayList<SessionCustomization.OptionsButton> buttons = new ArrayList<>();
|
||
|
SessionCustomization.OptionsButton cloudMsgButton = new SessionCustomization.OptionsButton() {
|
||
|
@Override
|
||
|
public void onClick(Context context, View view, String sessionId) {
|
||
|
|
||
|
}
|
||
|
};
|
||
|
|
||
|
cloudMsgButton.iconId = R.drawable.nim_ic_messge_history;
|
||
|
|
||
|
buttons.add(cloudMsgButton);
|
||
|
sessionCustomization.buttons = buttons;
|
||
|
|
||
|
NimUIKit.startChatting(context, account, SessionTypeEnum.P2P, sessionCustomization, null);
|
||
|
```
|
||
|
|
||
|
#### <span id="自定义贴图定制">自定义贴图定制</span>
|
||
|
|
||
|
1\. 是否显示贴图表情开关
|
||
|
|
||
|
构造 SessionCustomization 对象,设置 withSticker,显示表情为 true,不显示表情为 false。再调用 NimUIKit#startChatting 函数即可。
|
||
|
|
||
|
```
|
||
|
SessionCustomization sessionCustomization = new SessionCustomization();
|
||
|
sessionCustomization.withSticker = true;
|
||
|
|
||
|
NimUIKit.startChatting(context, account, SessionTypeEnum.P2P, sessionCustomization, null);
|
||
|
```
|
||
|
|
||
|
2\. 贴图表情配置
|
||
|
|
||
|
替换 demo/assets/sticker 下的资源文件,并修改 StickerManager 中的数据源。
|
||
|
|
||
|
3\. 默认emoji表情图片及文案配置
|
||
|
|
||
|
替换 uikit/assets/emoji/default 文件夹下的资源文件 和 emoji.xml 中相应的设置。
|
||
|
|
||
|
#### <span id="会话中点击事件的定制">会话中点击事件的定制</span>
|
||
|
|
||
|
会话窗口消息列表提供一些点击事件的响应处理函数,见 SessionEventListener:
|
||
|
|
||
|
头像点击事件处理,一般用于打开用户资料页面
|
||
|
头像长按事件处理,一般用于群组@功能,或者弹出菜单,做拉黑,加好友等功能
|
||
|
|
||
|
```
|
||
|
SessionEventListener listener = new SessionEventListener() {
|
||
|
@Override
|
||
|
public void onAvatarClicked(Context context, IMMessage message) {
|
||
|
// 一般用于打开用户资料页面
|
||
|
}
|
||
|
|
||
|
@Override
|
||
|
public void onAvatarLongClicked(Context context, IMMessage message) {
|
||
|
// 一般用于群组@功能,或者弹出菜单,做拉黑,加好友等功能
|
||
|
}
|
||
|
};
|
||
|
|
||
|
// 在Application初始化中设置
|
||
|
NimUIKit.setSessionListener(listener);
|
||
|
```
|