账号绑定功能接入

# 账号绑定功能接入

# 一、产品介绍

为了丰富玩家数据，促进各游戏相关平台生态互通，微信游戏制定了外部账号绑定机制，方便微信和第三方平台、账号互绑和数据打通。 当前微信游戏可接入以下用户数据：

# 二、具体场景示意

# 三、名词约定

微信游戏： 微信游戏中心，主要入口：微信-> 发现-> 游戏。 第三方（平台）：与微信游戏中心账号互相绑定的、除微信游戏以外的平台。

# 四、整体流程详解

（以腾讯视频：双城之战为例）

起始为场景为绑定/授权场景（图中①），该场景为微信游戏中的场景，由微信游戏负责。该场景中会引导用户进入绑定流程。 进入绑定流程后会先展示 Loading 态的中间页（图中②），该页面由微信游戏负责提供。若用户没有绑定过账号，或者之前绑定过账号后解绑了，则可继续跳转至第三方平台的登录绑定页面（图中③）。 第三方平台的登录绑定页面（图中③），这里登录方式任意，可以是微信，手机号或者其他登录方式。注意，该页面由第三方平台负责，该页面的开发者需完成第三方平台在微信的登录授权功能以及登录完成后将第三方平台的账号和微信游戏账号进行绑定的操作。 在第三方平台完成绑定后，无论是直接关闭页面或者重定向到指定链接，一般会进入隐私授权页（图中④、⑤）。当然，第三方平台不一定需要获取微信游戏的数据，因此图中④之后可以直接到达图中⑥。 注意，图中④这个授权页（即微信游戏申请第三方平台数据）可以是第三方平台自己提供，这样第三方平台可以保存用户选择是否授权给微信游戏，从而在微信游戏向第三方平台请求数据时，根据用户的选择决定是否提供数据给微信游戏。当然也可以由微信游戏提供并管理数据。图中⑤第二个授权页则是微信游戏提供。

# 五、第三方接入详解

主要工作

1. 开发账号登录页面 需要做一个 H5 页面用于游戏账号登录，并提供登录链接地址，微信游戏侧需要配置跳转（这里我们不关心第三方的登录方式，可以是微信，手机号或者其他登录方式）。

2. 后台做绑定流程，存储用户的绑定关系 进行一个 oauth2 的授权流程拿到用户的 token 和 openid。在拿到 access_token 后需要做后台账号绑定流程，在绑定成功后需要存储用户 refresh_token，openid 和绑定关系。

3. 接入游戏行为数据并传输给微信游戏 跟微信游戏运营约定好需要传输的数据，然后开发接入对应的游戏行为数据，最后通过接口传输给微信游戏。

时序图

给第三方提供的接口

应用的含义： 微信游戏会给第三方分配一个应用，一个应用可以绑定多个游戏。绑定是以应用为维度，绑定了应用就会绑定应用下面的所有游戏。比如米哈游作为一个应用，米哈游下面绑定了原神、星铁两个游戏。用户绑定米哈游账号之后，相当于绑定原神、星铁两个游戏。如果只想绑定一个游戏，可以一个游戏单独申请一个应用，一个应用绑定哪些游戏是第三方决定，需要同步给微信游戏运营。

** 接口参数定义：**

注意这里的 game_platform_access_token 和微信开平 access_token 不是一个体系，两边是不互通的

下面接口强调需要签名的，签名方案都走：服务端 API 预分配密钥签名指南

下面的字段没有标明是可选的都是必填的字段

跳转第三方登录页面链接会带上 code，登录页面 redirect_uri 需要给到微信游戏。 跳转登录页： redirect_uri/?code=CODE&param=PARAM param：是第三方自定义的参数，微信游戏跳转只是透传 code：用户身份认证，用于第三方后台换取 game_platform_access_token

通过 code 换取网页授权 access_token

在第三方完成账号登录后，需要把 code 传给第三方后台，第三方后台进行后续的流程

这个接口需要签名

错误码： -1000001：code 过期，需要重新发起授权 -1000006：参数 game_platform_appid 和 code 编码的 game_platform_appid 不一致

game_platform_access_token 续期接口

在 game_platform_access_token过期后，需要刷新。这里会返回一个新的 refresh_token，业务需要替换旧的 refresh_token

这个接口需要签名

错误码： -1000002：game_platform_refresh_token 数据不合法 -1000003：game_platform_refresh_token 过期 -1000006：参数 game_platform_appid 和 refresh_token 编码的 game_platform_appid 不一致

绑定接口

这个接口第三方需要调用，不然微信测不知道哪些用户绑定过，后续的同步数据会失败。可选的字段可以不填

这个接口不需要签名

错误码： -40001：game_platform_access_token 过期 -200004：thirdplat_openid 已经被人绑定 -1000004：game_platform_access_token 数据非法

解除绑定接口

这个接口第三方可选，解绑功能在微信游戏设置里面有做，第三方可以不做

这个接口不需要签名

错误码： -40001：game_platform_access_token 过期 -1000004：game_platform_access_token 数据非法 -200001：thirdplat_openid 已经被人绑定

获取用户信息接口

这个接口第三方可选。绑定成功后，第三方可以保存用户的头像昵称，头像需要自己转存，链接可能会失效

这个接口不需要签名

错误码： -40001：game_platform_access_token 过期 -1000004：game_platform_access_token 数据非法

传输数据给微信游戏，生成用户事件

同步的数据项需要跟微信游戏的运营对。这里传的格式是 key-value 方式。微信游戏会有一个管理端，对 key-value 进行运算生成对应的事件

这个接口需要签名

错误码： -40001：game_platform_access_token 过期 -1000004：game_platform_access_token 数据非法

这里有设置几个通用的 key，如果要上报按下面的 key 来上报

如果是数值类型的数据，微信游戏会有一些统计项，统计项如下：

当用户回流后，通知用户来游戏圈续期绑定关

当第三方超过30天没有续期 game_platform_refresh_token，就认为用户已经流失，这个时候需要续期

当用户回流的时候，第三方可以调用这个接口，然后游戏中心会提醒用户来续期。当用户续期成功后，refreshaccesstoken 接口就会接受之前过期的 game_platform_refresh_token，返回一个新的 game_platform_refresh_token

这个接口需要签名

错误码： -1000002：game_platform_refresh_token 数据不合法 -1000008：频率限制，一个 game_platform_openid一天只能上报一次

第三方账号绑定页需具备的能力

以下两种能力至少满足一个，且请优先使用第一个

登录绑定成功后，支持关闭当前页面，可调用 wx.closeWindow，具体参考JS-SDK说明文档 。 登录绑定成功后，支持重定向到目标页面 登录页的链接可以提供重定向链接的入参，登录绑定成功后，重定向到指定链接。具体：Location.replace() 。

网址：账号绑定功能接入 http://www.mxgxt.com/news/view/963345

相关内容

账号绑定功能接入
某音MCN入驻指南：如何绑定多个账号
华为账号，怎么解除绑定？
如何解除第三方账号绑定？
拳皇全明星国际服账号怎么绑定？这样就能注册账号了
网易大神如何绑定微信账号 网易大神绑定微信账号方法【教程】
抖音企业机构账号怎么取消绑定？企业机构账号和企业账号区别是什么？
如何关闭抖音星图功能和解绑星图达人账号
小红书如何绑定关系账号？简单步骤解析
聊天宝怎么绑定微信 聊天宝账号关联微信方法介绍

随便看看