网易云信 IM UIKit 支持本地会话列表类（LocalConversationPage）和云端会话列表类（ConversationPage），在其他组件中需要根据您当前使用到的会话列表组件来进行对应的功能。

会话列表界面 UI 个性化定制的的相关说明，请参考 定制会话列表界面。

效果展示

会话列表是即时通讯应用中的一个重要功能模块，用于展示用户的所有聊天对话列表，包括单聊和群聊。它帮助用户快速找到和切换不同的聊天对象或群组，方便管理和查看历史消息记录。效果如下图所示：

前提条件

根据本文操作前，请确保您已经完成以下操作：

• 登录。

• 明确使用本地会话还是云端会话。如果需要使用云端会话，需要您在使用云端会话列表组件之前，打开云端会话开关。

  ////默认是本地会话，设置为 false 后代表打开云端会话
  IMKitConfigCenter.enableLocalConversation = true
  

页面路由

会话组件中的页面路由如下表所示：

页面	路由地址	页面源码
本地会话列表页面	LocalConversationPage	src/main/ets/pages/LocalConversationPage.ets
云端会话列表页面	ConversationPage	src/main/ets/pages/ConversationPage.ets

跳转本地会话列表

IM UIKit 提供的本地会话列表类名为 LocalConversationPage。您可以使用鸿蒙提供的路由 Navigation 跳转到默认本地会话列表界面 LocalConversationPage。

Navigation 原型

TypeScript//跳转到本地会话列表
this.pathStack.pushPath({ name:'LocalConversationPage' })

参数说明

参数	类型	说明
pathStack	NavPathStack	路由相关的操作都是基于页面栈 NavPathStack 提供的方法进行，每个 Navigation 都需要创建并传入一个 NavPathStack 对象，用于管理页面。主要涉及页面跳转、页面返回、页面替换、页面删除、参数获取、路由拦截等功能。 更多详情，请参考《华为官方文档》Navigation。
name	string	IM UIKit 默认注册的本地会话列表界面地址 LocalConversationPage。

跳转云端会话列表

IM UIKit 提供的云端会话列表类名为 ConversationPage。您可以使用鸿蒙提供的路由 Navigation 跳转到默认云端会话列表界面 ConversationPage。

Navigation 原型

TypeScript//跳转到云端会话列表
this.pathStack.pushPath({ name:'ConversationPage' })

参数说明

参数	类型	说明
pathStack	NavPathStack	路由相关的操作都是基于页面栈 NavPathStack 提供的方法进行，每个 Navigation 都需要创建并传入一个 NavPathStack 对象，用于管理页面。主要涉及页面跳转、页面返回、页面替换、页面删除、参数获取、路由拦截等功能。 更多详情，请参考《华为官方文档》Navigation。
name	string	IM UIKit 默认注册的云端会话列表界面地址 ConversationPage。