# 登录接口(必接)

# 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 保留对象 用户扩展信息。
Last Updated: 2026/11/11 15:12:56