进阶用法

大约 2 分钟

进阶用法

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是否启用默认的多设备群组事件处理。