# SDK 初始化(必接)
# 1、初始化前提
调用初始化前必须完成:
- 调用
DHSteamSDK_Create创建句柄。 - 调用
DHSteamSDK_SetHostPlatformParamJson设置配置。 - 按需调用
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 和诊断事件。