功能说明

2020-02-15 02:21 更新

展示“更多游戏”弹窗,支持点击游戏列表中的游戏进行跳转。


“更多游戏”弹窗

“更多游戏”弹窗提供一个游戏列表展示开发者在 game.json 文件中配置需要跳转的小游戏

⚠️ 基于交互统一性和规范性的要求,跳转小游戏数量至少要 4 个,最多 10 个。

在 game.json 文件中,ttNavigateToMiniGameAppIdList 字段配置跳转的小游戏列表。

{
  "ttNavigateToMiniGameAppIdList": [
    "ttXXXXXX1",
    "ttXXXXXX2",
    "ttXXXXXX3",
    "ttXXXXXX4",
    "ttXXXXXX5",
    // 至少4个,最多10个
  ]
}

用户点击任意小游戏,完成如下的二次确认后即可跳转到对应小游戏。


展示“更多游戏”弹窗

⚠️ 推荐使用 tt.showMoreGamesModal
API功能支持版本
tt.showMoreGamesModal直接展示更多游戏弹窗1.33.0
tt.createMoreGamesButton创建更多游戏按钮,按钮置于页面顶层需要手动点击触发,点击后打开弹窗1.23.0

通过 tt.showMoreGamesModal

支持这个功能的最低基础库版本为 1.33.0 版本,开发者需要对低版本进行兼容处理。

代码示例

// 监听弹窗关闭
tt.onMoreGamesModalClose(function(res) {
  console.log("modal closed", res);
});
// 监听小游戏跳转
tt.onNavigateToMiniProgram(function(res) {
  console.log(res.errCode);
  console.log(res.errMsg);
});

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);
    }
  });
}

通过 tt.createMoreGamesButton

支持这个功能的最低基础库版本为 1.23.0 版本,开发者需要对低版本进行兼容处理。

  • 创建更多游戏按钮代码示例如下。
const btn = tt.createMoreGamesButton({
  type: "image",
  image: "images/more_games_btn.png",
  style: {
    left: 20,
    top: 40,
    width: 150,
    height: 40,
    lineHeight: 40,
    backgroundColor: "#ff0000",
    textColor: "#ffffff",
    textAlign: "center",
    fontSize: 16,
    borderRadius: 4,
    borderWidth: 1,
    borderColor: "#ff0000"
  },
  appLaunchOptions: [
    {
      appId: "ttXXXXXX",
      query: "foo=bar&baz=qux",
      extraData: {}
    }
    // {...}
  ],
  onNavigateToMiniGame(res) {
    console.log("跳转其他小游戏", res);
  }
});

btn.onTap(() => {
  console.log("点击更多游戏");
});
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号