跳到主要内容

登录(启动)

一、后端对接

请完成后端登录的接入,在后端实现 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

启动参数说明

参数类型说明
authKeystring游戏方提供的用户访问令牌,用于作身份校验(authKey 后端来源
userIdstring平台的用户 ID(由平台提供)
extstring游戏方的透传数据(ext 后端来源
xlDatastring平台的用户数据(由平台提供),查看数据结构
extinfostring平台提供的额外数据。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