普通小游戏开发
开放能力(必读)
社交转发裂变
数据分析
视频拍摄器
API
多端支持

tt.showMoreGamesModal

基础库 1.33.0 开始支持本方法,低版本需做兼容处理

tt.showMoreGamesModal 仅 Android 支持,iOS 不支持,开发者需做相应兼容处理。

在不支持小游戏盒子的宿主端该 API 调用后会展示“更多游戏”弹窗

弹出小游戏盒子界面,盒子中包含开发者预先配置的小游戏列表,以及其他游戏推荐

语法

tt.showMoreGamesModal(options);

参数说明

options 为 object 类型,属性如下:

属性类型默认值必填说明
appLaunchOptionsArray<object>[ ]小游戏的启动参数
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

appLaunchOptions 参数说明

Array<object> 类型,结构如下:

属性类型默认值必填说明
appIdstring推荐游戏列表中要打开的小游戏 appId
querystring查询字符串,必须是 key1=val1&key2=val2 的格式。可通过tt.getLaunchOptionSynctt.onShow 获取启动参数中的 query
extraDataobject需要传递给目标小游戏的数据。可通过tt.getLaunchOptionSynctt.onShow字段获取对应数据

回调成功

object 类型,属性如下:

属性类型说明
errMsgstring跳转成功时的提示信息

回调失败

object 类型,属性如下:

属性类型说明
errMsgstring跳转失败时的提示信息

回调结束

object 类型,属性如下:

属性类型说明
errMsgstring跳转结束时的提示信息

代码示例

const systemInfo = tt.getSystemInfoSync();
// iOS 不支持,建议先检测再使用
if (systemInfo.platform !== "ios") {
  // 打开互跳弹窗
  tt.showMoreGamesModal({
    appLaunchOptions: [
      {
        appId: "ttXXXXXX",
        query: "foo=bar&baz=qux",
        extraData: {},
      },
      // {...}
    ],
    success(res) {
      console.log("success", res.errMsg);
    },
    fail(res) {
      console.log("fail", res.errMsg);
    },
  });
} else {
  tt.showToast({
    title: " iOS不支持此功能",
  });
}

Bug&Tip

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助