tencent cloud

文档反馈

最后更新时间:2024-01-31 12:27:26
    本文介绍如何设置 iOS 界面风格。

    设置头像的样式

    设置缺省的头像图片

    TUIKit 的界面在显示用户时,会从用户资料中读取头像地址并显示。如果用户没有设置头像,则显示默认头像。 您可以在 TUIKit 初始化前,自定义默认头像的图片,示例代码如下:
    TUIConfig *config = [TUIConfig defaultConfig];
    // 修改默认头像
    config.defaultAvatarImage = [UIImage imageNamed:@"your image"];
    // 修改默认群组头像
    config.defaultGroupAvatarImage = [UIImage imageNamed:@"your group image"];
    // 禁用群组九宫格头像
    config.enableGroupGridAvatar = NO;
    说明:
    群组头像默认展示九宫格头像。九宫格头像是 TUIKit 使用群成员的头像合成的,如果九宫格合成失败或群组里只有一个成员,TUIKit 会展示 defaultGroupAvatarImage。 如果您不想使用九宫格头像,可以禁用九宫格头像。

    设置头像的形状

    TUIKit 提供 3 种头像类型:矩形直角头像、圆形头像和矩形圆角头像。
    typedef NS_ENUM(NSInteger, TUIKitAvatarType) {
    TAvatarTypeNone, /*矩形直角头像*/
    TAvatarTypeRounded, /*圆形头像*/
    TAvatarTypeRadiusCorner, /*圆角头像*/
    };
    您可以在 TUIKit 初始化前,选择头像类型,示例代码如下:
    TUIConfig *config = [TUIConfig defaultConfig];
    // 修改头像类型为圆角矩形,圆角大小为 5
    config.avatarType = TAvatarTypeRadiusCorner;
    config.avatarCornerRadius = 5.f;

    设置聊天窗口的样式

    设置聊天窗口的背景色

    您可以在初始化聊天窗口前,自定义窗口背景色,示例代码如下:
    [TUIChatConfig defaultConfig].backgroudColor = [UIColor greenColor];

    设置聊天窗口的背景图片

    您可以在初始化聊天窗口前,自定义窗口背景图片,示例代码如下:
    [TUIChatConfig defaultConfig].backgroudImage = [UIImage imageNamed:@"your chat background image"];

    设置消息气泡的样式

    聊天界面消息 View 的组合方式如下图所示:
    

    设置消息的字体和颜色

    文字消息的数据来自于 TUITextMessageCellData 类,通过它的接口可以修改文字消息的字体和颜色。 您可以在初始化聊天窗口前,自定义消息的字体和颜色,示例代码如下:
    // 设置发送文字消息的字体和颜色
    [TUITextMessageCellData setOutgoingTextFont:[UIFont systemFontOfSize:20]];
    [TUITextMessageCellData setOutgoingTextColor:[UIColor blueColor]];
    // 设置接收文字消息的字体和颜色
    [TUITextMessageCellData setIncommingTextFont:[UIFont systemFontOfSize:20]];
    [TUITextMessageCellData setIncommingTextColor:[UIColor purpleColor]];

    设置气泡的背景图片

    气泡 Cell 显示的图片从 TUIBubbleMessageCellData 获取,该对象提供了类方法可以设置图片。 您可以在初始化聊天窗口前,自定义气泡背景图片,示例代码如下:
    // 设置发送气泡,包括普通状态和选中状态
    [TUIBubbleMessageCellData setOutgoingBubble:[UIImage imageNamed:@"outgoing_bubble"]];
    [TUIBubbleMessageCellData setOutgoingHighlightedBubble:[UIImage imageNamed:@"outgoing_bubble_highlighted"]];
    // 设置接收气泡,包括普通状态和选中状态
    [TUIBubbleMessageCellData setIncommingBubble:[UIImage imageNamed:@"incoming_bubble"]];
    [TUIBubbleMessageCellData setIncommingHighlightedBubble:[UIImage imageNamed:@"incoming_bubble_highlighted"]];

    设置气泡的边距

    在 TUIKit 中,文字和声音都会用气泡显示,TUIMessageCellLayout 提供了类方法设置 bubbleInsets。 您可以在初始化聊天窗口前,自定义气泡边距,示例代码如下:
    // 设置发送消息的气泡边距
    [TUIMessageCellLayout outgoingTextMessageLayout].bubbleInsets = UIEdgeInsetsMake(20, 20, 24, 24);
    // 设置接收消息的气泡边距
    [TUIMessageCellLayout incommingTextMessageLayout].bubbleInsets = UIEdgeInsetsMake(20, 20, 24, 24);

    设置发送者的头像样式

    修改 TUIMessageCellLayout 的相关属性,可设置发送者的头像样式。 您可以在初始化聊天窗口前,自定义发送者的头像样式,示例代码如下:
    // 设置发送者头像大小和位置
    [TUIMessageCellLayout outgoingTextMessageLayout].avatarSize = CGSizeMake(80, 80);
    [TUIMessageCellLayout outgoingTextMessageLayout].avatarInsets = UIEdgeInsetsMake(10, 10, 20, 20);
    // 设置接收者头像大小和位置
    [TUIMessageCellLayout incommingTextMessageLayout].avatarSize = CGSizeMake(80, 80);
    [TUIMessageCellLayout incommingTextMessageLayout].avatarInsets = UIEdgeInsetsMake(10, 10, 20, 20);
    注意:
    其他消息类型请获取对应的 layout 实例设置头像的大小和位置。

    设置消息的昵称样式

    修改 TUIMessageCellLayout 的相关属性,可设置消息的发送方昵称字体和颜色。 您可以在初始化聊天窗口前,自定义消息的昵称样式,示例代码如下:
    // 设置收到的消息的昵称字体及颜色
    [TUIMessageCellData setIncommingNameFont:[UIFont systemFontOfSize:20]];
    [TUIMessageCellData setIncommingNameColor:[UIColor blueColor]];
    // 设置自己的昵称字体及颜色,默认情况下不显示自己的昵称
    [TUIMessageCellData setOutgoingNameFont:[UIFont systemFontOfSize:20]];
    [TUIMessageCellData setOutgoingNameColor:[UIColor purpleColor]];
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持