logo
当前页

消息组件

IMKit 的消息组件提供了消息列表和消息传输功能。

注意
如果您不需要会话列表,可以直接使用消息组件。
  • 消息列表:允许您查看聊天的消息历史记录。
  • 消息传输:允许您发送或接收一对一消息和群组消息。

将消息组件集成到您的项目中

前提条件

将 IMKit SDK 集成到您的项目中(需要完成初始化和登录)。更多信息,请参考快速开始

显示消息组件

IMKit 允许您将消息组件集成到您的 Activity 中,可以作为 Activity 或 Fragment。

Warning
  • 对于 Activity 模式,标题栏和右上角的重定向到群组管理页面的按钮是根据类型包含的。对于 Fragment 模式,只包含与消息相关的内容。
  • 要重定向到群组管理页面,需要引入ZIMKitGroup模块。否则,会报错因为找不到相应的 Activity 。如果群组功能可用,但不需要重定向到群组管理页面,则需要修改源代码以隐藏右上角的按钮。

直接重定向到 Activity

MyZIMKitActivity.java

import android.os.Bundle;

import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;

import im.zego.zimkitcommon.enums.ZIMKitConversationType;
import im.zego.zimkitcommon.ZIMKitRouter;

public class MyZIMKitActivity extends AppCompatActivity {
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    }

    public void buttonClick() {
        String id = ; // 用户ID或群组ID或会话ID。
        ZIMKitConversationType type = ; // ZIMKitConversationType.ZIMKitConversationTypeGroup 或 ZIMKitConversationType.ZIMKitConversationTypePeer
        toMessageActivity(id,type);
    }
    
    private void toMessageActivity(String id,ZIMKitConversationType type){
        // 您可以通过 Kit 层的路由器将页面重定向到相应的页面。
        ZIMKitRouter.toMessageActivity(this, id, type);
    }
}
1
Copied!

将消息页面集成到您的 Activity 中作为一个 Fragment

您可以通过两种方式将消息组件添加到 activity 的视图层次结构中:一种是在 activity 的布局文件中定义 fragment,另一种是在 activity 的布局文件中定义一个 fragment 容器,然后在 activity 中以编程方式添加 fragment。

定制功能

如果默认的与消息相关的特性和行为不能完全满足您的需求,您可以通过我们在本节中提到的配置进行灵活的定制。

API

Previous

会话组件

Next

与 音视频通话 UIKit 一起使用