跳到主要内容
Gravity Engine 引力引擎客户端 SDK 集成
Gravity Engine 引力引擎

快捷获取 openid

介绍在没有自建后端的情况下,如何通过引力 SDK 快捷获取微信、抖音、TikTok、快手、B 站、支付宝小游戏的 openid,包含后台凭据配置、调用流程与示例。

查看 Markdown

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

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

1. 更新记录

更新日期更新内容
2026-10-206.0.17 版本新增支持 TikTok 小游戏快捷获取 openid,方法名为 getTiktokOpenId。
2026-10-106.0.15 版本新增支持支付宝小游戏快捷获取 openid。

2. 微信小游戏

2.1 前置要求

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

在引力后台添加微信小游戏 AppSecret

  1. 升级引力 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 参考文档

3. 抖音小游戏

3.1 前置要求

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

在引力后台添加抖音小游戏 AppSecret

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

3.2 调用流程

平台层的流程是先用 tt.login 获取临时凭证,再由服务端调用 code2Session 换取用户标识。抖音明确要求 AppSecret 只在服务端使用,会话密钥不能下发到小游戏,登录凭证只能使用一次,依据见 抖音小游戏 code2Session 官方说明。下文的 getDouyinOpenId 是引力 SDK 封装,不能将 AppSecret 写入客户端代码。

每次冷启动过程中,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 参考文档

4. 快手小游戏

4.1 前置要求

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

在引力后台添加快手小游戏 AppSecret

  1. 升级引力 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 参考文档

5. B 站小游戏

5.1 前置要求

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

在引力后台添加 B 站小游戏 Secret Key

  1. 升级引力 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 参考文档

6. 支付宝小游戏

6.1 前置要求

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

在引力后台添加支付宝小游戏 AppSecret

  1. 升级引力 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 参考文档

7. TikTok 小游戏

7.1 前置要求

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

在引力后台添加 TikTok 小游戏 Secret Key

  1. 升级引力 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" })
  1. 然后继续调用 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 参考文档

8. Unity SDK

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

文档维护:Gravity Engine

文档修改日期:

本页内容