打开游戏中心

业务场景

支付宝渠道：要求设首、复访打开游戏中心。
适用范围：支付宝小游戏

官方文档:https://www.yuque.com/zhifubaoxiaoyouxi-zromu/ts2ry9/chg423quavxtmolo

注意事项

  • first : 首访打开游戏中心的时候【设首】
    • success 回调代表从游戏中心回来
    • fail 回调不仅是游戏中心打开失败，还有奖励领取失败
  • repeat : 复访打开游戏中心的时候
    • success 回调代表从游戏中心回来（如果从游戏中心进入，游戏会重新启动，则没有回调）
    • fail 回调游戏中心打开失败
  • isAddAppToMyApps : 是否可以添加游戏中心到首页【设首】
    • success 回调结果为 true 代表可以显示【设首】ICON
    • fail 代表调用失败，不显示【设首】ICON

流程图

接口介绍

SDKManager.enterGameCenter(Object params)

调用示例

const isAddAppToMyApps = SDKManager.canIUse('enterGameCenter.type.isAddAppToMyApps');
// 老模式 - isAddAppToMyApps=false
SDKManager.enterGameCenter({
  type: 'first',
  onSuccess: () => {
    //成功
  },
  onFailed: (errorInfo) => {
    // 失败
  },
});

// 新模式 - isAddAppToMyApps=true
SDKManager.enterGameCenter({
  type: 'isAddAppToMyApps',
  onSuccess: () => {
    // 成功：显示【设首】ICON
    // -----
    // 用户点击【设首】ICON，响应照旧
    SDKManager.enterGameCenter({
      type: 'first',
      onSuccess: () => {
        // 成功
        // 新模式：成功回调即为添加成功
        // 老模式：需要根据启动参数判断【从这里getLaunchOptions获取】
      },
      onFailed: (errorInfo) => {
        // 失败
      },
    });
  },
  onFailed: (errorInfo) => {
    // 失败
  },
});

参数说明

入参：string type

枚举说明
first首访任务
repeat复访任务
isAddAppToMyApps是否完成首访任务【新模式】

空字符，即只是打开游戏中心，不额外携带参数

错误码

无

FAQ

Q：跳转之后没有成功回调

A：从游戏中心返回，安卓和 IOS 的表现不一定一致，所以要在 onShow 里面调用getLaunchOptions，根据返回结果判断；

  • 新模式：成功回调即为添加成功。

Q：新老模式如何处理

A：通过SDKManager.canIUse('enterGameCenter.type.isAddAppToMyApps')判断是否支持新模式，支持新模式的话，调用新模式，不支持的话，调用老模式

  • 老模式：从游戏中心返回，安卓和 IOS 的表现不一定一致，所以要在 onShow 里面调用getLaunchOptions，根据返回结果判断；
  • 新模式：成功回调即为添加成功。