融云开发者文档

更新时间: 2021-03-08

# 自定义头像大小

开发者可根据业务场景自行定义会话页面头像的显示形状和大小

# 头像显示形状

属性所属类为 RCIM，默认值为矩形

@property (nonatomic) RCUserAvatarStyle globalMessageAvatarStyle;
已复制

RCUserAvatarStyle 说明:

类型名	说明
RC_USER_AVATAR_RECTANGLE	矩形
RC_USER_AVATAR_CYCLE	圆形

# 头像显示大小

属性所属类为 RCIM，默认值为 40*40

@property (nonatomic) CGSize globalMessagePortraitSize;
已复制

# 自定义聊天气泡

开发者可根据业务场景自行定义聊天气泡的样式，可以在 SDK 的资源包 (IMKit/Resources/Rongcloud.bundle) 中找到对应气泡图片，然后替换成您自己的图片即可。另外需要注意拉伸位置。

SDK 内拉升比例为:

UIEdgeInsetsMake(image.size.height * 0.8, image.size.width * 0.2, image.size.height * 0.2, image.size.width * 0.8)
已复制

bundle 内的图片资源:

# 自定义按导航按钮

# 相册列表页

左上/右上按钮:

可设置 UIBarButtonItem 的全局 tintColor 来更改。

图片右上角点击选中按钮:

可替换图片资源中的 photopicker_state_normal 和 photopicker_state_selected 来更改。

其他按钮:

可通过 color.plist 中 photoPicker 字典里的相关字段来更改。

color.plist 文件路径:IMKit/Resources/RCColor.plist

# 相册预览页

左上角返回按钮:

可替换图片资源中的 navigator_btn_back 来更改。

右上角选择按钮:

可替换图片资源中的 photo_preview_unselected 和 photo_preview_selected 来更改。

其它按钮:

可 color.plist 中 photoPreview 字典里的相关字段来更改。

选中发送原图时文字前面的选中状态:

可替换图片资源中的 selected_full 和 unselected_full 来更改。

# 位置选取页

左上、右上角按钮:

可设置 RCIM 中的 globalNavigationBarTintColor 来更改。

# 发送文件页

左上、右上角按钮:

可设置 RCIM 中的 globalNavigationBarTintColor 来更改。

右上角按钮未选择文件时颜色:

可 color.plist 中 fileSelect 字典里的相关字段来更改。

右上角按钮选中文件时的颜色:

可设置 RCIM 中的 globalNavigationBarTintColor 来更改。

# 个人名片页

左上角按钮:

可设置 RCIM 中的 globalNavigationBarTintColor 来更改。

# 未读数显示

# 右上角提示

当收到的消息超过一个屏幕时，进入会话之后，是否在右上角提示上方存在的未读消息数，开启该提示功能之后，当一个会话收到大量消息时（超过一个屏幕能显示的内容），进入该会话后，会在右上角提示用户上方存在的未读消息数，用户点击该提醒按钮，会跳转到最开始的未读消息。

是否开启:

@property (nonatomic, assign) BOOL enableUnreadMessageIcon;
已复制

提示的 UILabel :

当 unReadMessage > 10 右上角会显示未读消息数。

@property (nonatomic, strong) UILabel *unReadMessageLabel;
已复制

提示的 UIButton :

@property (nonatomic, strong) UIButton *unReadButton;
已复制

自定义:

开发者可自定义聊天页面右上角未读消息控件的字体颜色，背景图片和箭头，在聊天页子类添加以下方法，具体图片名称请根据自身业务添加


- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];
    
    //修改文本颜色
    [self.unReadMessageLabel setTextColor:[UIColor redColor]];
    
    //修改按钮整体背景图片
    [self.unReadButton setBackgroundImage:[UIImage imageNamed:@"这里添加想替换的图片名称"]
                                 forState:UIControlStateNormal];
    //修改向上箭头图片
    [self.unReadButton.subviews enumerateObjectsUsingBlock:^(__kindof UIView * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
        if ([obj isKindOfClass:[UIImageView class]]) {
            UIImageView *imageView = (UIImageView *)obj;
            UIImage *image = [UIImage imageNamed:@"这里添加想替换的图片名称"];
            image = [image resizableImageWithCapInsets:UIEdgeInsetsMake(image.size.width * 0.2, image.size.width * 0.8,
                                                                        image.size.width * 0.2, image.size.width * 0.2)
                                          resizingMode:UIImageResizingModeStretch];
            imageView.image = image;
            *stop = YES;
        }
    }];
}
已复制

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 右下角提示

当前阅读区域的下方收到消息时，是否在会话页面的右下角提示下方存在未读消息，开启该提示功能之后，当会话页面滑动到最下方时，此会话中收到消息会自动更新；当用户停留在上方某个区域阅读时，此会话收到消息时，会在右下角显示未读消息提示，而不会自动滚动到最下方，用户点击该提醒按钮，会滚动到最下方。

是否开启:

@property (nonatomic, assign) BOOL enableNewComingMessageIcon;
已复制

提示的 UILabel :

当 unReadMessage > 10 右上角会显示未读消息数。

@property (nonatomic, strong) UILabel *unReadNewMessageLabel;
已复制

文档是否解决您的问题 ?

如果遇到产品相关问题，您可提交工单寻求帮助