tt.showMoreGamesModal
基础库 1.33.0 开始支持本方法,低版本需做兼容处理。
tt.showMoreGamesModal 仅 Android 支持,iOS 不支持,开发者需做相应兼容处理。
在不支持小游戏盒子的宿主端该 API 调用后会展示“更多游戏”弹窗
弹出小游戏盒子界面,盒子中包含开发者预先配置的小游戏列表,以及其他游戏推荐
语法
tt.showMoreGamesModal(options);
参数说明
options 为 object 类型,属性如下:
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
appLaunchOptions | Array<object> | [ ] | 是 | 小游戏的启动参数 |
success | Function | 否 | 接口调用成功的回调函数 | |
fail | Function | 否 | 接口调用失败的回调函数 | |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
appLaunchOptions 参数说明
Array<object> 类型,结构如下:
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
appId | string | 是 | 推荐游戏列表中要打开的小游戏 appId | |
query | string | 否 | 查询字符串,必须是 key1=val1&key2=val2 的格式。可通过tt.getLaunchOptionSync或tt.onShow 获取启动参数中的 query | |
extraData | object | 否 | 需要传递给目标小游戏的数据。可通过tt.getLaunchOptionSync或tt.onShow字段获取对应数据 |
回调成功
object 类型,属性如下:
属性 | 类型 | 说明 |
---|---|---|
errMsg | string | 跳转成功时的提示信息 |
回调失败
object 类型,属性如下:
属性 | 类型 | 说明 |
---|---|---|
errMsg | string | 跳转失败时的提示信息 |
回调结束
object 类型,属性如下:
属性 | 类型 | 说明 |
---|---|---|
errMsg | string | 跳转结束时的提示信息 |
代码示例
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
无
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助