IM UIKit 提供统一路由 IMKitRouter，实现界面的跳转和模块之间的解耦。

IM UIKit 内置界面跳转

IM UIKit 内置的任意界面都可以通过路由地址跳转到其他指定界面。

如何使用路由进行跳转

调用 Navigator 方法进行界面跳转。

方法原型如下：

dart//带参数的界面跳转
Navigator.pushNamed(context, path, arguments: {'paramKey': param});
//不带参数的界面跳转
Navigator.pushNamed(context, path);

内部路由地址概览

dartimport 'package:common_ui/router/imkit_router_factory.dart';

跳转至用户信息界面

• 示例代码

  dart// 封装好的接口
  goToContactDetail(context, accId);
  // 使用路由跳转
  Navigator.pushNamed(context, RouterConstants.PATH_USER_INFO_PAGE, arguments: {'accId': accId});
  

• 参数说明

  参数	类型	说明
  RouterConstants.PATH_USER_INFO_PAGE	String	用户信息界面的跳转地址。
  accId	String	查看用户资料的用户 ID。
  context	BuildContext	组件上下文。

跳转至聊天界面

• 示例代码

  dart// 封装好的接口，跳转单聊
  goToP2pChat(context, userId);
  // 封装好的接口，跳转群聊
  goToTeamChat(context, teamId);
  // 使用路由跳转
  Navigator.pushNamed(context, RouterConstants.PATH_CHAT_PAGE, arguments: {'conversationId': conversationId,
          'conversationType': conversationType});
  

• 参数说明

  参数	类型	说明
  RouterConstants.PATH_CHAT_PAGE	String	聊天界面的跳转地址。
  conversationId	String	用户的 ID/群组的 ID，必传。
  conversationType	NIMConversationType	会话类型，必传。 NIMConversationType.p2p：单聊会话 NIMConversationType.team：群聊会话
  context	BuildContext	组件上下文。
  customPopActions	PopMenuAction?	自定义消息弹框事件，非必传。
  onTapAvatar	Function(String? userID, {bool isSelf})?	头像点击事件，非必传。
  chatUIConfig	ChatUIConfig?	聊天页面定制化配置，非必传。
  messageBuilder	ChatKitMessageBuilder?	聊天自定义消息构建，非必传。

跳转至群聊搜索界面

• 示例代码

  dartNavigator.pushNamed(context, RouterConstants.PATH_CHAT_SEARCH_PAGE, arguments: {'teamId': teamId});
  

• 参数说明

  参数	类型	说明
  RouterConstants.PATH_CHAT_SEARCH_PAGE	String	群聊搜索界面的跳转地址。
  teamId	String	群组的 ID。
  context	BuildContext	组件上下文。

跳转至群聊设置界面

• 示例代码

  dartNavigator.pushNamed(context, RouterConstants.PATH_TEAM_SETTING_PAGE, arguments: {'teamId': teamId});
  

• 参数说明

  参数	类型	说明
  RouterConstants.PATH_TEAM_SETTING_PAGE	String	群聊搜索界面的跳转地址。
  teamId	String	群组的 ID。
  context	BuildContext	组件上下文。

跳转至新增界面

IM UIKit 提供的路由能力，支持根据您的业务需求新增界面，并支持从其他界面跳转至新增界面。在通过路由实现跳转前，需调用 registerRouter 方法注册该新增界面的路由地址。

如果需要传递参数，需要使用 getArgumentFormMap 方法获取对应类型的参数。

方法原型如下：

dartIMKitRouter.instance.registerRouter(String name, WidgetBuilder builder, {Map<String, Object>? arguments,bool cover = false})

示例代码

dart// 注册群聊设置页面路由
IMKitRouter.instance.registerRouter(
        RouterConstants.PATH_TEAM_SETTING_PAGE,
        (context) => TeamSettingPage(
            UIKitRouter.getArgumentFormMap<String>(context, 'teamId')!));