快捷获取 openid

部分客户的小游戏属于单机游戏，没有配套的后端开发人员或者服务器，这种情况下想获取 openid 就较为繁琐，因此引力 SDK 提供了快速获取小游戏 openid 的方法，非 Unity SDK 各平台的具体调用方式见下文，本文档对此进行说明。

微信、抖音、TikTok、快手、B 站、支付宝六个平台的差异仅在于：引力后台需要填写的凭据、小游戏官方的登录方法、引力 SDK 提供的获取方法名。下文为各平台非 Unity SDK 的调用流程，Unity SDK 请参考 Unity SDK 快捷获取 openid。

1. 更新记录

2. 微信小游戏

2.1 前置要求

1. 在引力后台「设置 → 应用管理 → 配置 → 微信开发者」中，添加小游戏的 AppSecret。

2. 升级引力 SDK 到 4.8.18 及以上版本。

2.2 调用流程

每次冷启动过程中，GravityEngine 的实例化方法 new GravityEngine() 与初始化方法 setupAndStart() 均只能被调用一次，clientId 参数必须在这两个方法的其中一个传入。

1. 先 new GravityEngine()，此时传入的 config 可以不填 clientId。

2. 然后调用 ge.getWechatOpenId 方法获取 openid。

3. 然后在获取成功的回调里调用 setupAndStart，传入上面获取的 openid：

   setupAndStart({ clientId: "xxx" })

4. 然后继续调用 initialize 方法。

调用示例：

wx.login({
  success: (res) => {
    ge.getWechatOpenId(res.code).then((res) => {
      // 这里返回的 res 和官方文档返回的 resp 保持一致，具体请查看下方列出的官方文档中的返回值
      console.log(res);
    }).catch(err => {
      console.log(err);
    })
  }
})

2.3 参考文档

• 微信小游戏快速集成
• 微信 Access Token
• code2Session（微信官方）

3. 抖音小游戏

3.1 前置要求

1. 在引力后台「设置 → 应用管理 → 配置 → 抖音开发者」中，添加小游戏的 AppSecret。

2. 升级引力 SDK 到 4.8.18 及以上版本。

3.2 调用流程

每次冷启动过程中，GravityEngine 的实例化方法 new GravityEngine() 与初始化方法 setupAndStart() 均只能被调用一次，clientId 参数必须在这两个方法的其中一个传入。

1. 先 new GravityEngine()，此时传入的 config 可以不填 clientId。

2. 然后调用 ge.getDouyinOpenId 方法获取 openid。

3. 然后在获取成功的回调里调用 setupAndStart，传入上面获取的 openid：

   setupAndStart({ clientId: "xxx" })

4. 然后继续调用 initialize 方法。

调用示例：

tt.login({
  success: (res) => {
    ge.getDouyinOpenId(res.code).then((res) => {
      // 这里返回的 res 和官方文档返回的 resp 保持一致，具体请查看下方列出的官方文档中的返回值
      console.log(res);
    }).catch(err => {
      console.log(err);
    })
  }
})

3.3 参考文档

• 抖音小游戏快速集成
• 抖音 Access Token
• code2Session（抖音官方）

4. 快手小游戏

4.1 前置要求

1. 在引力后台「设置 → 应用管理 → 配置 → 快手开发者」中，添加小游戏的 AppSecret。

2. 升级引力 SDK 到 4.8.18 及以上版本。

4.2 调用流程

每次冷启动过程中，GravityEngine 的实例化方法 new GravityEngine() 与初始化方法 setupAndStart() 均只能被调用一次，clientId 参数必须在这两个方法的其中一个传入。

1. 先 new GravityEngine()，此时传入的 config 可以不填 clientId。

2. 然后调用 ge.getKuaishouOpenId 方法获取 openid。

3. 然后在获取成功的回调里调用 setupAndStart，传入上面获取的 openid：

   setupAndStart({ clientId: "xxx" })

4. 然后继续调用 initialize 方法。

调用示例：

ks.login({
  success: (res) => {
    ge.getKuaishouOpenId(res.code).then((res) => {
      // 这里返回的 res 和官方文档返回的 resp 保持一致，具体请查看下方列出的官方文档中的返回值
      console.log(res);
    }).catch(err => {
      console.log(err);
    })
  }
})

4.3 参考文档

• 快手小游戏快速集成
• code2Session（快手官方）

5. B 站小游戏

5.1 前置要求

1. 在引力后台「设置 → 应用管理 → 配置 → B站营销」中，添加小游戏的 Secret Key。

2. 升级引力 SDK 到 4.8.18 及以上版本。

5.2 调用流程

每次冷启动过程中，GravityEngine 的实例化方法 new GravityEngine() 与初始化方法 setupAndStart() 均只能被调用一次，clientId 参数必须在这两个方法的其中一个传入。

1. 先 new GravityEngine()，此时传入的 config 可以不填 clientId。

2. 然后调用 ge.getBilibiliOpenId 方法获取 openid。

3. 然后在获取成功的回调里调用 setupAndStart，传入上面获取的 openid：

   setupAndStart({ clientId: "xxx" })

4. 然后继续调用 initialize 方法。

调用示例：

bl.login({
  success: (res) => {
    ge.getBilibiliOpenId(res.code).then((res) => {
      // 这里返回的 res 和官方文档返回的 resp 保持一致，具体请查看下方列出的官方文档中的返回值
      console.log(res);
    }).catch(err => {
      console.log(err);
    })
  }
})

5.3 参考文档

• B 站小游戏快速集成
• 登录接口（B 站官方）

6. 支付宝小游戏

6.1 前置要求

1. 在引力后台「设置 → 应用管理 → 配置 → 支付宝开发者」中，添加小游戏的 AppSecret。

2. 升级引力 SDK 到 6.0.15 及以上版本。

6.2 调用流程

每次冷启动过程中，GravityEngine 的实例化方法 new GravityEngine() 与初始化方法 setupAndStart() 均只能被调用一次，clientId 参数必须在这两个方法的其中一个传入。

1. 先 new GravityEngine()，此时传入的 config 可以不填 clientId。

2. 然后调用 ge.getAliOpenId 方法获取 openid。

3. 然后在获取成功的回调里调用 setupAndStart，传入上面获取的 openid：

   setupAndStart({ clientId: "xxx" })

4. 然后继续调用 initialize 方法。

调用示例：

my.getAuthCode({
  scopes: 'auth_base',
  success: (res) => {
    ge.getAliOpenId(res.authCode).then((res) => {
      // 这里返回的 res 和官方文档返回的 resp 保持一致，具体请查看下方列出的官方文档中的返回值
      console.log(res);
    }).catch(err => {
      console.log(err);
    })
  }
})

6.3 参考文档

• 支付宝小游戏快速集成
• 获取会员基础信息 / getAuthCode（支付宝官方）

7. TikTok 小游戏

7.1 前置要求

1. 在引力后台「设置 → 应用管理 → 配置 → TikTok开发者」中，添加小游戏的 Secret Key。

2. 升级引力 SDK 到 6.0.17 及以上版本。

7.2 调用流程

每次冷启动过程中，GravityEngine 的实例化方法 new GravityEngine() 与初始化方法 setupAndStart() 均只能被调用一次，clientId 参数必须在这两个方法的其中一个传入。

1. 先 new GravityEngine()，此时传入的 config 可以不填 clientId。

2. 然后调用 ge.getTiktokOpenId 方法获取 openid。

3. 然后在获取成功的回调里调用 setupAndStart，传入上面获取的 openid：

setupAndStart({ clientId: "xxx" })

4. 然后继续调用 initialize 方法。

调用示例：

TTMinis.game.login({
  success: (result) => {
    // 登录并授权成功，拿到 code 后换取 openid
    let code = result.code;
    ge.getTiktokOpenId(code).then((res) => {
      // 这里返回的 res 和官方文档返回的 resp 保持一致，具体请查看下方列出的官方文档中的返回值
      console.log(res);
    }).catch(err => {
      console.log(err);
    })
  },
  fail: (error) => {
    // 其他错误或用户取消授权，此时 code 为 null
  },
  complete: () => {
    // success 和 fail 都会触发该回调
  }
});

7.3 参考文档

• TikTok 小游戏快速集成
• TikTok Mini Games Login Integration Guide（官方）

8. Unity SDK

Unity SDK 的调用方式六个平台完全一致，且需要自行调用 GravityHelper.GetOpenId 方法，请参考 Unity SDK 快捷获取 openid。