设置会话列表页面

会话列表 ConversationsView 是 ChatUIKit 提供的主要组件, 用于展示当前用户的所有会话，包含单聊和群组聊天（不包括聊天室），并且提供会话搜索、删除、置顶和免打扰功能。单条会话展示用户会话列表，包括会话名称、最后一条消息、最后一条消息的时间以及置顶和禁言状态等。

ConversationsView 可以直接使用，也可以通过路由使用。

对于单聊和群聊, 会话展示的名称为你设置的 Profile 中的昵称，若未获取到昵称，则展示 ID；会话头像为你设置的 Profile 中的头像，如果没有设置，则使用默认头像。

添加会话列表

添加会话列表时，只需要将 ConversationsView 添加到页面上即可。

@override
Widget build(BuildContext context) {
  return const ConversationsView();
}

自定义会话列表

如果需要自定义会话列表，可以修改以下参数：

参数	描述
final ConversationListViewController? controller	会话列表控制器， 如果不传内部会使用默认的控制器。
final ChatUIKitAppBarModel? appBarModel	会话列表的 AppBar 模型，用于自定义 AppBar。
final void Function(List<ConversationModel> data)? onSearchTap	会话列表搜索点击事件回调，点击后会把当前所有的会话回调出来，如果不设置会有默认实现。
final List<Widget>? beforeWidgets	展示在会话列表前面的 widget。
final List<Widget>? afterWidgets	展示在会话列表后面的 widget。
final ConversationItemBuilder? itemBuilder	会话列表 item builder。如果需要重写会话列表，在此处实现。
final void Function(BuildContext context, ConversationItemModel info)? onItemTap	点击会话列表的回调，点击后会把当前的会话数据传递过来。如果不是设置默认会跳转到消息页面。
final ConversationsViewItemLongPressHandler? onItemLongPressHandler	长按会话列表的回调，如果不设置默认会弹出默认的长按菜单。如果设置长按时会把默认的弹出菜单项传给你，你需要调整后返回来，返回来的数据会用于菜单显示，如果返回 null 将不会显示菜单。
final String? searchBarHideText	搜索框中默认展示的文字内容。
final bool enableSearchBar	是否使用搜索。 - （默认）true：使用； - false：不使用。
final Widget? listViewBackground	列表为空时展示的背景图。
final bool enableAppBar	是否开启 AppBar，默认开启。关闭后将不再显示 AppBar，传入的 AppBar 也不再生效。
final String? attributes	扩展参数，会传入到下一个页面。
final ChatUIKitViewObserver? viewObserver	用于刷新页面的 Observer。
final AppBarMoreActionsBuilder? appBarMoreActionsBuilder	默认 AppBar 右上角更多按钮点击回调, 会提供一个默认操作列表，返回一个新的操作列表。
final bool enablePinHighlight	是否开启置顶消息点击高亮，默认为 true。如果设置为 false 将不会显示置顶高亮。

自定义 AppBar

可通过 enableAppBar 设置是否显示 AppBar，也可通过 appBarModel 对 AppBar 进行自定义。

ConversationsView(
  appBarModel: ChatUIKitAppBarModel(
    title: 'Title',
    subtitle: 'Subtitle',
  ),
);

关于 AppBar 的自定义详细描述，参见进阶用法文档。

设置会话列表项

可以通过 itemBuilder 自定义列表项，model 是 ConversationItemModel 对象。返回的 Widget 会替换原有显示，如果返回 null, 则使用默认样式显示。

ConversationsView(
  itemBuilder: (context, model) {
    return ListTile(
      title: Text('title'),
      subtitle: Text('subtitle'),
      onTap: () {},
    );
  },
);

设置头像和昵称

会话列表展示遵循 ChatUIKitProvider 原则，如果需要设置头像和昵称，可以查看头像和昵称设置。若需设置头像和昵称是否显示，可通过 showMessageItemAvatar 和 showMessageItemNickname 进行设置。

对于头像的圆角、默认头像等设置，详见全局配置项文档。

更多

• 获取未读消息数(不包括免打扰会话)，一般用于显示会话页面的总未读数。

try {
  // withoutIds: 需要排除的id列表，可以是群组 ID 或者用户 ID。 如果不传，则为获取所有非免打扰会话的总消息未读数。
  // unreadCount: 返回的未读数, 除了 'withoutIds` 的其他非免打扰会话未读消息总数。
  int unreadCount = await ChatUIKit.instance.getUnreadMessageCount(
    withoutIds: [
      'userId1',
      'groupId1',
    ],
  );
} catch (e) {
  // 错误
}

• 获取指定会话未读消息数(包括免打扰会话), 一般用于显示聚合会话的总未读数。

try {
  // appointIds: 会话 ID。
  // unreadCount: `appointIds`中会话 ID 的未读消息总数，包含设置了免打扰会话的消息未读数。
  int unreadCount = await ChatUIKit.instance.getAppointUnreadCount(
    appointIds: [
      'userId1',
      'groupId1',
    ],
  );
} catch (e) {
  // 错误
}

• 获取指定会话中有未读消息的会话数量, 一般用于显示聚合会话中有新消息的会话数。

try {
  // appointIds: 指定要获取是否包含新消息的会话范围。
  // hasUnreadMessagesConversationCount: 返回传入的 `appointIds` 中有新消息的会话数量，该返回包含了设置免打扰的会话。
  int hasUnreadMessagesConversationCount =
      await ChatUIKit.instance.appointNewMessageConversationCount(
    appointIds: [
      'conversationId1',
      'conversationId2',
      'conversationId3',
    ],
  );
} catch (e) {
  // 错误
}