bl.navigateToMiniProgram(Object object)
打开另一个小游戏
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 | 
|---|---|---|---|---|
| appId | string | 是 | 要打开的小游戏 appId | |
| vAppId | string | 是 | 要打开的小游戏 vAppId | |
| path | string | 否 | 打开的页面路径,如果为空则打开首页 | |
| extraData | object | 否 | 需要传递给目标小游戏的数据,目标小游戏可在 App.onLaunch,App.onShow 中获取到这份数据。 | |
| envVersion | string | 否 | 要打开的小游戏版本。仅在当前小游戏为开发版或体验版时此参数有效。如果当前小游戏是正式版,则打开的小游戏必定是正式版。 | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | 
envVersion 的合法值
| 值 | 说明 | 版本 | 
|---|---|---|
| dev | 开发版 | |
| predev | 开发体验版 | |
| precheck | 审核体验版 | |
| 空 | 正式版 | 
使用限制
需要用户确认跳转
在跳转至其他小游戏前,将统一增加弹窗,询问是否跳转,用户确认后才可以跳转其他小游戏。如果用户点击取消,则回调 fail cancel。
每个小游戏可跳转的其他小游戏数量限制为不超过 10 个
如使用了跳转其他小游戏功能,则需要在代码配置中声明将要跳转的小游戏名单,限定不超过 10 个,否则将无法通过审核。该名单可在发布新版时更新,不支持动态修改。配置方法详见 配置。调用此接口时,所跳转的 appId 必须在配置列表中,否则回调 fail appId "${appId}" is not in navigateToMiniProgramAppIdList。
示例代码
bl.navigateToMiniProgram({
  appId: '',
  path: 'page/index/index?id=123',
  extraData: {
    foo: 'bar'
  },
  success(res) {
    // 打开成功
  }
})