腾讯云即时通信IMAndroid_AI解决方案_同尘科技
本文介绍如何设置 Android 界面风格。更多实操教学视频请参见 设置样式(Android)。
设置会话列表
会话列表由标题区 TitleBarLayout 与列表区 ConversationListLayout 组成,每部分都提供了 UI 样式以及事件注册的接口可供修改。
设置标题样式
标题区除了本身作为 View 所具有的属性功能之外,还包含左、中、右三块区域,如下图所示:您可参见 ITitleBarLayout 进行自定义修改。
例如,在会话列表中,隐藏左边的 LeftGroup,设置中间的标题,隐藏右边的文本和图片按钮,代码如下:
(参见 MainActivity 中的实现)
mainTitleBar.setTitle(getResources().getString(R.string.conversation_title), ITitleBarLayout.Position.MIDDLE);mainTitleBar.getLeftGroup().setVisibility(View.GONE);mainTitleBar.getRightGroup().setVisibility(View.VISIBLE);mainTitleBar.setRightIcon(R.drawable.more_btn);
效果如下图所示:另外,您也可以定制点击事件:
Menu menu = new Menu(this, mainTitleBar);mainTitleBar.setOnRightClickListener(new View.OnClickListener() { @Override public void onClick(View v) { if (menu == null) { return; } if (menu.isShowing()) { menu.hide(); } else { menu.show(); } }});
设置会话列表样式
列表区的自定义 layout 继承自 RecyclerView,登录后 TUIKit 会根据用户名从 SDK 读取该用户的会话列表。
会话列表提供一些常用功能定制,例如,头像是否圆角、背景、字体大小、点击与长按事件等。示例代码如下:
public static void customizeConversation(final ConversationLayout layout) { // 从 ConversationLayout 获取会话列表 ConversationListLayout listLayout = layout.getConversationList(); listLayout.setItemTopTextSize(16); // 设置 item 中 top 文字大小 listLayout.setItemBottomTextSize(12);// 设置 item 中 bottom 文字大小 listLayout.setItemDateTextSize(10);// 设置 item 中 timeline 文字大小 listLayout.setItemAvatarRadius(5); // 设置 adapter item 头像圆角大小 listLayout.disableItemUnreadDot(false);// 设置 item 是否不显示未读红点,默认显示 // 长按弹出菜单 listLayout.setOnItemLongClickListener(new ConversationListLayout.OnItemLongClickListener() { @Override public void OnItemLongClick(View view, int position, ConversationInfo conversationInfo) { startPopShow(view, position, conversationInfo); } });}
设置会话列表不同的文字大小和头像圆角大小效果图如下所示:
默认样式 | 自定义样式 |
![]() |
![]() |
更多详细信息请参见 ConversationLayoutSetting.java。
设置头像的风格样式
IM SDK 不做头像存储,需要集成者有头像存储接口获取头像 URL,这里 TUIKit 通过随机头像接口进行演示,如何设置头像。
首先您需要在个人资料页面中,上传头像图片,调用修改资料接口。
V2TIMUserFullInfo v2TIMUserFullInfo = new V2TIMUserFullInfo();// 头像if (!TextUtils.isEmpty(mIconUrl)) { v2TIMUserFullInfo.setFaceUrl(mIconUrl);}V2TIMManager.getInstance().setSelfInfo(v2TIMUserFullInfo, new V2TIMCallback() { @Override public void onError(int code, String desc) { }
@Override public void onSuccess() { }});
会话列表设置头像在 ConversationCommonHolder.java 中进行获取展示:
conversationIconView.setConversation(conversation);
设置聊天窗口的样式
聊天窗口包含标题区 TitleBarLayout,用法与会话列表相同。除此之外,聊天窗口还包含三个区域,从上到下为通知区 NoticeLayout、消息区 MessageRecyclerView 和输入区 InputView,如下图所示:
/** * 获取聊天窗口 Input 区域 Layout * * @return */InputView getInputLayout();/** * 获取聊天窗口 Message 区域 Layout * * @return */MessageRecyclerView getMessageLayout();
/** * 获取聊天窗口 Notice 区域 Layout * * @return */NoticeLayout getNoticeLayout();
更多详细信息请参见 ChatLayoutSetting.java。
设置聊天列表标题栏样式
聊天列表和会话列表的标题栏都使用 TitleBarLayout。可以参见会话列表标题栏的设置方式 修改聊天列表的标题栏。如果聊天列表内置的标题栏不满足您的需求,推荐自定义标题栏,替换 聊天列表内置的标题栏。不建议直接修改 TitleBarLayout,因为 TUIKit 内的页面都使用 TitleBarLayout,修改了 TitleBarLayout 会导致其他界面的标题栏都发生变化。
设置通知区域 NoticeLayout 样式
通知区域由两个 TextView 组成,如下图所示:效果如下图所示:
// 从 ChatView 获取 NoticeLayoutNoticeLayout noticeLayout = layout.getNoticeLayout();// 可以使通知区域一致展示noticeLayout.alwaysShow(true);// 设置通知主题noticeLayout.getContent().setText("现在插播一条广告");// 设置通知提醒文字noticeLayout.getContentExtra().setText("参看有奖");// 设置通知的点击事件noticeLayout.setOnNoticeClickListener(new View.OnClickListener() { @Override public void onClick(View v) { ToastUtil.toastShortMessage("赏白银五千两"); }});
设置消息区域 MessageRecyclerView 样式
MessageRecyclerView 继承自 RecyclerView ,本文提供自定义修改聊天背景、气泡、文字、是否显示昵称等常见的用法,更多详情请参见 IMessageProperties.java。
设置聊天窗口的背景色
您可以自定义设置聊天背景色,示例代码如下:
// 从 ChatView 获取 MessageRecyclerViewMessageRecyclerView messageRecyclerView = layout.getMessageLayout();////// 设置聊天背景 //////messageRecyclerView.setBackground(new ColorDrawable(0xB0E2FF00));
设置不同的聊天窗口背景色效果图如下所示:
默认颜色 | 自定义颜色 |
![]() |
![]() |
设置发送者的头像样式
TUIKit 的界面在显示用户时,会从用户资料中读取头像地址并显示。
示例代码如下:
// 聊天界面设置头像if (!TextUtils.isEmpty(msg.getFaceUrl())) { List
如果用户没有设置头像会显示默认头像,您可以自定义设置默认头像、头像是否圆角以及头像大小等。
示例代码如下:
// 从 ChatView 获取 MessageRecyclerViewMessageRecyclerView messageRecyclerView = layout.getMessageLayout();////// 设置聊天背景 //////messageRecyclerView.setBackground(new ColorDrawable(0xFFEFE5D4));////// 设置头像 //////// 设置默认头像,默认与朋友与自己的头像相同messageRecyclerView.setAvatar(R.drawable.core_default_user_icon_light);// 设置头像圆角messageRecyclerView.setAvatarRadius(50);// 设置头像大小messageRecyclerView.setAvatarSize(new int[]{68, 68});
默认头像样式 | 自定义头像样式 |
![]() |
![]() |
设置气泡的背景色
左边为对方的气泡,右边为自己的气泡,您可以自定义设置双方的气泡背景。
示例代码如下:
// 从 ChatView 获取 MessageRecyclerViewMessageRecyclerView messageRecyclerView = layout.getMessageLayout();// 设置自己聊天气泡的背景messageRecyclerView.setRightBubble(context.getResources().getDrawable(R.drawable.chat_bubble_self_bg_lively));// 设置朋友聊天气泡的背景messageRecyclerView.setLeftBubble(context.getResources().getDrawable(R.drawable.chat_bubble_other_bg_lively));
设置气泡背景图片效果图如下所示:
默认气泡背景图片 | 自定义气泡背景图片 |
![]() |
![]() |
设置发送者的昵称样式
您可以自定义设置昵称的字体大小与颜色等,但双方昵称样式必须保持一致。
示例代码如下:
// 从 ChatView 获取 MessageRecyclerViewMessageRecyclerView messageRecyclerView = layout.getMessageLayout();////// 设置昵称样式(对方与自己的样式保持一致)//////messageRecyclerView.setNameFontSize(12);messageRecyclerView.setNameFontColor(0x8B5A2B00);
设置发送者昵称文字颜色效果图如下所示:
默认昵称颜色 | 自定义昵称颜色 |
![]() |
![]() |
设置聊天内容样式
您可以自定义设置聊天内容的字体大小、双方字体颜色等,但双方字体大小必须保持一致。
示例代码如下:
// 从 ChatView 获取 MessageRecyclerViewMessageRecyclerView messageRecyclerView = layout.getMessageLayout();// 设置聊天内容字体大小,朋友和自己用一种字体大小messageRecyclerView.setChatContextFontSize(15);// 设置自己聊天内容字体颜色messageRecyclerView.setRightChatContentFontColor(0xA9A9A900);// 设置朋友聊天内容字体颜色messageRecyclerView.setLeftChatContentFontColor(0xA020F000);
设置聊天内容字体效果图如下所示:
默认字体样式 | 自定义字体样式 |
![]() |
![]() |
设置聊天时间线样式
您可以自定义设置聊天时间线的背景、字体大小以及字体颜色等。示例代码如下:
// 从 ChatView 获取 MessageRecyclerViewMessageRecyclerView messageRecyclerView = layout.getMessageLayout();// 设置聊天时间线的背景messageRecyclerView.setChatTimeBubble(new ColorDrawable(0x8B691400));// 设置聊天时间的字体大小messageRecyclerView.setChatTimeFontSize(20);// 设置聊天时间的字体颜色messageRecyclerView.setChatTimeFontColor(0xEE00EE00);
设置时间线效果图如下所示:
默认时间线样式 | 自定义时间线样式 |
![]() |
![]() |
设置聊天的提示信息样式
您可以自定义设置提示信息的背景、字体大小以及字体颜色等。示例代码如下:
// 从 ChatView 获取 MessageRecyclerViewMessageRecyclerView messageRecyclerView = layout.getMessageLayout();// 设置提示的背景messageRecyclerView.setTipsMessageBubble(new ColorDrawable(0xA020F000));// 设置提示的字体大小messageRecyclerView.setTipsMessageFontSize(20);// 设置提示的字体颜色messageRecyclerView.setTipsMessageFontColor(0x7CFC0000);
设置提示信息效果图如下所示:
默认提示信息样式 | 自定义提示信息样式 |
![]() |
![]() |
设置输入区域 InputView
输入区域 InputView,包含语音输入、文字输入、表情输入以及更多的“+”输入。
隐藏不要的功能
您可以自定义隐藏或展示更多“+”面板的图片、拍照、摄像以及发送文件的功能。
// 从 ChatView 获取 InputLayoutInputView inputView = layout.getInputLayout();// 隐藏拍照并发送inputView.disableCaptureAction(true);// 隐藏发送文件inputView.disableSendFileAction(true);// 隐藏发送图片inputView.disableSendPhotoAction(true);// 隐藏摄像并发送inputView.disableVideoRecordAction(true);
增加自定义的功能
您可以自定义新增更多“+”面板的动作单元实现相应的功能。
本文以隐藏发送文件,增加一个动作单元且该动作单元会发送一条消息为例,示例代码如下:
// 从 ChatView 获取 InputViewInputView inputView = layout.getInputLayout();// 隐藏发送文件inputView.disableSendFileAction(true);// 定义一个动作单元InputMoreActionUnit unit = new InputMoreActionUnit();unit.setIconResId(R.drawable.default_user_icon); // 设置单元的图标unit.setTitleId(R.string.profile); // 设置单元的文字标题unit.setOnClickListener(unit.new OnActionClickListener() { // 定义点击事件 @Override public void onClick() { ToastUtil.toastShortMessage("自定义的更多功能"); TextMessageBean info = ChatMessageBuilder.buildTextMessage("我是谁"); layout.sendMessage(info, false); }});// 把定义好的单元增加到更多面板inputView.addAction(unit);
替换点击“+”的事件
您可以自定义替换更多“+”面板的各个动作单元的功能。
// 从 ChatView 获取 InputViewInputView inputView = layout.getInputLayout();// 可以用自定义的事件来替换更多功能的入口inputView.replaceMoreInput(new View.OnClickListener() { @Override public void onClick(View v) { ToastUtil.toastShortMessage("自定义的更多功能按钮事件"); TextMessageBean info = ChatMessageBuilder.buildTextMessage("自定义的消息"); layout.sendMessage(info, false); }});
替换点击“+”弹出的面板
您可以自定义更多“+”面板的样式、各个动作单元以及其对应的功能。
// 从 ChatView 获取 InputViewInputView inputView = layout.getInputLayout();// 可以用自定义的 fragment 来替换更多功能inputView.replaceMoreInput(new CustomInputFragment());
新面板 CustomInputFragment 的实现和普通的 Fragment 没有区别,在 onCreateView 时 inflate 自己的 View ,设置事件即可。本文以添加两个按钮 ,点击时弹出 toast 为例,示例代码如下:
public static class CustomInputFragment extends BaseInputFragment { @Nullable @Override public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, Bundle savedInstanceState) { View baseView = inflater.inflate(R.layout.test_chat_input_custom_fragment, container, false); Button btn1 = baseView.findViewById(R.id.test_send_message_btn1); btn1.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { ToastUtil.toastShortMessage("发送一条超链接消息"); } }); Button btn2 = baseView.findViewById(R.id.test_send_message_btn2); btn2.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { ToastUtil.toastShortMessage("发送一条视频文字混合消息"); } }); return baseView; }}
效果如下图所示:
对即时通讯IM解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?