进阶用法

Activity 跳转路径设置

如果默认的 Activity 及其提供的可配置项不满足需求时，需要你继承默认的 Activity 新增需要的逻辑。如果该 Activity 为 UIKit 内部调用的页面，你可以通过下面方法修改 Activity 的跳转。

例如，若 EaseChatActivity 无法满足当前需求，可以继承 EaseChatActivity 实现新的 ChatActivity。当调用 EaseChatActivity.actionStart 跳转页面时，会通过getActivityRoute() 拦截跳转指向 ChatActivity。

提示

只有实现了 EaseIM.getCustomActivityRoute()?.getActivityRoute() 的 Activity 才可以进行拦截。

// EaseChatActivity 中的跳转实现

companion object {
    private const val REQUEST_CODE_STORAGE_PICTURE = 111
    private const val REQUEST_CODE_STORAGE_VIDEO = 112
    private const val REQUEST_CODE_STORAGE_FILE = 113

    fun actionStart(context: Context, conversationId: String, chatType: EaseChatType) {
        Intent(context, EaseChatActivity::class.java).apply {
             putExtra(EaseConstant.EXTRA_CONVERSATION_ID, conversationId)
             putExtra(EaseConstant.EXTRA_CHAT_TYPE, chatType.ordinal)
             EaseIM.getCustomActivityRoute()?.getActivityRoute(this.clone() as Intent)?.let {
                    if (it.hasRoute()) {
                    context.startActivity(it)
                    return
                }
            }
            context.startActivity(this)
        }
    }
}


// application 中路由拦截实现
EaseIM.setCustomActivityRoute(object : EaseCustomActivityRoute {
    override fun getActivityRoute(intent: Intent): Intent {
        if (intent.component?.className == EaseChatActivity::class.java.name) {
            intent.setClass(this@DemoApplication, ChatActivity::class.java)
         }
        return intent
    }
})

全局配置

单群聊 UIKit 提供了一些全局配置，可以在初始化时进行设置，示例代码如下：

val avatarConfig = EaseAvatarConfig()
// 将头像设置为圆角
avatarConfig.avatarShape = EaseImageView.ShapeType.ROUND
val config = EaseIMConfig(avatarConfig = avatarConfig)
EaseIM.init(this, options, config)

EaseAvatarConfig 提供的配置项如下表所示：

属性	描述
avatarShape	头像样式，有默认，圆形和矩形三种样式，默认样式为默认。
avatarRadius	头像圆角半径，仅在头像样式设置为矩形后有效。
avatarBorderColor	头像边框的颜色。
avatarBorderWidth	头像边框的宽度。

EaseChatConfig 提供的配置项如下表所示：

属性	描述
enableReplyMessage	消息回复功能是否可用，默认为可用。
enableModifyMessageAfterSent	消息编辑功能是否可用，默认为可用。
timePeriodCanRecallMessage	设置消息可撤回的时间，默认为 2 分钟。

EaseDateFormatConfig 提供的配置项如下表所示：

属性	描述
convTodayFormat	会话列表当天日期格式，英文环境默认为："HH:mm"。
convOtherDayFormat	会话列表其他日期的格式，英文环境默认为： "MMM dd"。
convOtherYearFormat	会话列表其他年日期的格式，英文环境默认为： "MMM dd, yyyy"。

EaseSystemMsgConfig 提供的配置项如下表所示：

属性	描述
useDefaultContactInvitedSystemMsg	是否启用系统消息功能，默认为启用。

EaseMultiDeviceEventConfig 提供的配置项如下表所示：

属性	描述
useDefaultMultiDeviceContactEvent	是否启用默认的多设备联系人事件处理。
useDefaultMultiDeviceGroupEvent	是否启用默认的多设备群组事件处理。