# 登录接口(必接)
# 1、调用前提
调用登录前必须收到 DHSTEAMSDK_EVENT_INIT 且 result == 0 的初始化成功事件。
# 2、调用登录
int result = DHSteamSDK_Login(sdk);
DHSteamSDK_Login 无额外参数。
| 返回值 | 说明 |
|---|---|
0 | 登录流程已接受;登录结果通过 LOGIN 事件返回。 |
1 | 尚未初始化、句柄无效、线程错误或其他同步失败。 |
SDK 会优先尝试本地缓存 token;缓存不可用或失效时重新申请 Steam 会话票据并登录。登录进行中重复调用不会启动重复登录流程,已经登录时会重新投递当前登录结果事件。
# 3、监听登录结果
void OnDHSteamEvent(const DHSteamSDKEvent *event, void *) {
if (event->type != DHSTEAMSDK_EVENT_LOGIN) {
return;
}
if (event->result == 0) {
const char *loginJson = event->data;
// 保存登录结果,允许调用 DHSteamSDK_Pay
} else {
const char *errorJson = event->data;
// 处理登录失败
}
}
登录事件字段:
| type | code | result | data |
|---|---|---|---|
2 | 1 | 0 | 登录成功 JSON。 |
2 | 1 | 1 | 错误 JSON,例如 {"errorCode":"network","msg":"...","isCancel":false}。 |
# 4、登录成功返回值
{
"accountName": "9721534",
"accountId": 9721534,
"accountView": "765***11",
"sign": "example-sign",
"token": "example-token",
"qdtoken": "example-qdtoken",
"region": 1,
"loginType": "LoginType_Quick_History",
"loginTimestamp": "1795155015",
"userExtraInfo": {
}
}
| 服务端字段 | 返回字段 | 类型处理 | 说明 |
|---|---|---|---|
account | accountName | 保留原类型 | 账号名称。 |
accountid | accountId | 保留原类型 | 账号 ID。 |
accountview | accountView | 保留原类型 | 账号展示名称。 |
logintype | loginType | 保留原类型 | 登录类型,例如 LoginType_Quick_History。 |
timestamp | loginTimestamp | 保留原类型 | 登录时间。 |
expiretimestamp | expireTimestamp | 保留原类型 | 服务端提供时返回,SDK 不补造。 |
userinfo | userExtraInfo | 保留对象 | 用户扩展信息。 |
← SDK 初始化(必接) 支付接口(必接) →