登录(接口鉴权)
鉴权方式
本章节内容使用的鉴权方式为 接口鉴权 ,请确认这是您想要的鉴权方式,详见选择鉴权方式。
一、后端对接
请完成后端登录的接入,在后端实现 AUTH_KEY 接口后,再执行下一步操作。
若未实现 AUTH_KEY 接口就进行页面对接,页面会提示 AUTH_KEY 接口错误,而无法提供正确的游戏页面 URL。
二、前端对接
游戏启动时,平台会调用游戏方的 AUTH_KEY 接口,接口会返回 auth_key 和 ext 参数。然后,平台会把 auth_key 和 ext 的值将作为 authKey 和 ext 参数拼接到游戏启动链接中。
游戏方通过获取链接中的 authKey 参数可以进行登录态校验,还可以通过 ext 参数进行额外的数据透传。
这一步骤对应上方时序图的 6、7、8 部分。
举个例子
游戏方提供的游戏启动链接为 https:///a.example.com/game001
用户打开游戏时,实际的启动链接可能为
https:///a.example.com/game001?authKey=81636f32e194af7fd1b662f15afd1eb4&client=1&userId=12345678&ext=example-property%3Dexample-value&server_id=12345678&xlData=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleGFtcGxlLXByb3BlcnR5IjoiZXhhbXBsZS12YWx1ZSJ9.PDa2FaDhwnkXhC-2JR1BG2hpotpq4GaMM1zeGeC3DKs
以下是游戏启动链接可能携带的参数:
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
| authKey | string | 是 | 游戏方提供的用户访问令牌,用于作身份校验(authKey 后端来源) |
| client | string | 否 | 平台的运行环境(由平台提供),1 表示浏览器,2 表示迅雷游戏客户端,目前仅 PC 游戏中心存在此字段 |
| ext | string | 是 | 游戏方的透传数据(ext 后端来源) |
| server_id | string | 否 | 游戏的区服 ID,仅页游接入需要(区服 ID 后端来源) |
| userId | string | 是 | 平台的用户 ID(由平台提供) |
| xlData | string | 是 | 平台的用户数据(由平台提供),查看数据结构 |