登录(启动)

一、后端对接
请完成后端登录的接入,在后端实现 AUTH_KEY 接口后,再执行下一步操作。
若未实现 AUTH_KEY 接口就进行启动对接,启动游戏时,游戏平台的页面会提示 AUTH_KEY 接口错误,而不会启动端游。
二、客户端对接
用户在平台客户端点击启动 Windows 端游,平台客户端会以 Windows 命令行方式启动游戏方的 exe 文件,同时携带与游戏用户相关的启动参数
启动命令行示例
"D:\Thunder\gamebox\clientgame\190032113\CPLauncher.exe"
userId=c9f1f97b211d4b8a78b903d3e34d82b0
authKey=xBTBDx1pG9GAKNbLseY70UpeX5d9NLC3
ext=extdata
xlData=eyJhbnRpX2FkZGljdGlvbiI6eyJhcHBpZCI6IiIsImJpemlkIjoiIn0sImF1ZCI6IjE0MzI5MTQxOTk1MDMxNzk3NzYiLCJleHAiOjE2MzUwMzM2MDAsImlhdCI6MTYzMjgzNzA0MSwiaXNzIjoiaHR0cHM6Ly95b3V4aS54dW5sZWkuY29tIiwibmJmIjoxNjMyODM3MDQxLCJzdWIiOiJjOWYxZjk3YjIxMWQ0YjhhNzhiOTAzZDNlMzRkODJiMCIsInVzZXJfaW5mbyI6eyJhdmF0YXIiOiJodHRwczovL3hmaWxlMi5hLjg4Y2RuLmNvbS9maWxlL2svNTAxL2F2YXRhci8xNTM2NzI3NDQxLmpwZyIsIm5pY2tuYW1lIjoienpoaCIsInVuaWNrbmFtZSI6Inp6aGgifSwidmlwX2luZm8iOnsibGV2ZWwiOjZ9LCJhbGciOiJIUzI1NiJ9.e30.vLhAfaap8Zz3zCeHmpNxoYe6uK179swVRNTfaluDAv8
extinfo=eyJyZWZlcmZyb20iOiJ0ZXN0MTExIiwiYWlkZnJvbSI6InRlc3QxMTEiLCJhY3Rmcm9tIjoidGVzdDMzMyJ9
启动参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| authKey | string | 游戏方提供的用户访问令牌,用于作身份校验(authKey 后端来源) |
| userId | string | 平台的用户 ID(由平台提供) |
| ext | string | 游戏方的透传数据(ext 后端来源) |
| xlData | string | 平台的用户数据(由平台提供),查看数据结构 |
| extinfo | string | 平台提供的额外数据。extinfo 是一个 base64 的字符串,可以解析得到一个 JSON 字符串,JSON 示例:{"referfrom":"test111","aidfrom":"test111","actfrom":"test333"} |
其它资源
查看启动参数
查看 Windows 系统进程启动参数的方法很多,以下提供 2 种方式供参考:
# 在 PowerShell 中使用下方命令,下方的 "XLGame.exe" 需要替换为游戏方的 exe 文件名
Get-CimInstance -ClassName Win32_Process | Where-Object { $_.Name -eq "XLGame.exe" } | ForEach-Object { Write-Host "$($_.Name) (PID:$($_.ProcessId)) 启动命令行:$($_.CommandLine)" `n }
:: 在 Cmd 中使用以下命令,下方的 "XLGame.exe" 需要替换为游戏方的 exe 文件名
wmic process where caption="XLGame.exe" get caption,commandline /value