文档概览/
Chat/
UIKit/
Android/
构建基础界面/
会话列表/

会话列表

本文会引导您构建会话列表界面。

效果展示

加载会话列表效果如下所示：



开发环境要求

Android Studio-Giraffe
Gradle-7.2
Android Gradle Plugin Version-7.0.0
kotlin-gradle-plugin-1.5.31

前置条件

在构建界面之前，请确保您已经完成了以下 4 件事：
1. 在控制台创建了一个应用。
2. 在控制台创建了一些用户账号。
3. 集成了 TUIKit 或 TUIConversation。
4. 调用 TUILogin 的 login 接口登录组件。
注意：
1. 所有组件都是这个登录接口。每次启动应用，登录一次即可。
2. 请确保登录成功，我们建议您在登录成功的回调里进行下文的操作。
如果您尚未完成以上 4 步，请先参考 快速开始 中的对应步骤完成，否则在实现下文功能时可能遭遇阻碍。
如果您已经完成，请继续阅读下文。

步骤说明

构建会话列表只需要把会话列表对应的 Fragment 添加到您的 Activity 中即可。添加后，Fragment 会自动读取最近的会话。如果同时集成了聊天界面，用户点击会话列表中的某一行，会自动跳转到相应的聊天界面。
MainActivity 布局文件：
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <FrameLayout
        android:id="@+id/conversation_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</FrameLayout>
MainActivity Java 文件：
简约版
经典版
public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main_activity);
        TUIConversationMinimalistFragment fragment = new TUIConversationMinimalistFragment();
        getSupportFragmentManager()
                .beginTransaction()
                .add(R.id.conversation_view, fragment)
                .commitAllowingStateLoss();
    }
}
public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main_activity);
        TUIConversationFragment fragment = new TUIConversationFragment();
        getSupportFragmentManager()
                .beginTransaction()
                .add(R.id.conversation_view, fragment)
                .commitAllowingStateLoss();
    }
}
注意：
如果您事先没有跟任何人、任何群组发送过消息，是不会产生会话的，此时添加 TUIConversationMinimalistFragment，列表为空。为了体验效果，建议您先给一些账号发送消息，触发会话的产生。如果您想了解如何在聊天界面发送消息，请参考文档：构建聊天界面。

更多实践

您可以本地 运行 TUIKitDemo 源码，探索更多的界面实现。

联系我们

如果您对本文有疑问，欢迎加入Telegram 技术交流群，您将获得可靠的技术支持。