# SDK 初始化(必接)

# 1、初始化前提

调用初始化前必须完成:

  1. 调用 DHSteamSDK_Create 创建句柄。
  2. 调用 DHSteamSDK_SetHostPlatformParamJson 设置配置。
  3. 按需调用 DHSteamSDK_SetStoragePath、DHSteamSDK_SetEventCallback 和 DHSteamSDK_SetDebugLogLevel。

# 2、初始化接口

int result = DHSteamSDK_Init(sdk);

DHSteamSDK_Init 无额外参数。

返回值 说明
0 初始化流程已接受,等待 INIT 事件。
1 尚未配置、句柄无效、线程错误或其他同步失败。

初始化成功后不能重复调用初始化接口。初始化过程还会异步执行动态配置、货币查询和启动埋点请求,这些请求的网络结果不代表 INIT 主流程结果。

# 3、监听初始化结果

使用回调模式时,在回调中处理 DHSTEAMSDK_EVENT_INIT:

void OnDHSteamEvent(const DHSteamSDKEvent *event, void *) {
    if (event->type != DHSTEAMSDK_EVENT_INIT) {
        return;
    }

    if (event->result == 0) {
        // 初始化成功,允许调用 DHSteamSDK_Login
    } else {
        // 初始化失败,读取 event->data 中的错误 JSON
    }
}

初始化事件字段:

type code result data
1 0 0 DHSteamSDK - Init Success。
1 0 1 错误 JSON,例如 {"errorCode":"steamInitFail","msg":"...","isCancel":false}。

如果 Steam 要求从 Steam 重新启动应用,初始化失败数据中的 errorCode 为 steamRestartRequired,游戏应退出当前进程并从 Steam 重新启动。

# 4、主循环

初始化后,游戏主线程需要持续调用:

while (!ShouldExit()) {
    DHSteamSDK_RunCallbacks(sdk);
    SleepMilliseconds(16);
}

不持续调用 DHSteamSDK_RunCallbacks,SDK 不会向回调或轮询队列分发 INIT、LOGIN、PAY 和诊断事件。

Last Updated: 2026/11/11 15:12:56