# 其他接口

# 1、事件结构

typedef struct DHSteamSDKEvent {
    uint64_t sequence;
    int32_t type;
    int32_t code;
    int32_t result;
    const char *data;
} DHSteamSDKEvent;
字段 说明
sequence SDK 事件递增序号。
type 事件类型。
code 事件业务代码。
result 0 表示成功,1 表示失败。
data 事件数据字符串。回调模式下只在当前回调期间有效。

# 2、推进回调

DHSteamSDK_RunCallbacks(sdk);

游戏主线程需要持续调用。该接口负责推进后台网络完成任务、Steam 回调和 SDK 事件分发,没有返回值。

# 3、轮询事件

不使用 DHSteamSDK_SetEventCallback 时,可以使用轮询模式:

DHSteamSDKEvent event{};
while (DHSteamSDK_PollEvent(sdk, &event) == 1) {
    HandleEvent(event.type, event.code, event.result,
                event.data == nullptr ? "" : event.data);
    DHSteamSDK_FreeEvent(&event);
}
返回值 说明
1 成功取出一个事件。
0 当前没有事件,或句柄、事件参数、线程无效。

DHSteamSDK_FreeEvent 只用于释放 DHSteamSDK_PollEvent 填充的事件数据,释放后事件结构会被清零。回调模式下不调用该接口释放回调参数。

# 4、读取同步错误

const char *error = DHSteamSDK_GetLastError(sdk);

返回 SDK 管理的最近一次同步错误字符串,不需要释放,只在句柄存活期间有效;下一次 SDK 调用可能覆盖内容。异步业务失败请读取事件 data。

# 5、销毁 SDK

DHSteamSDK_Destroy(sdk);
sdk = nullptr;

销毁没有返回值。必须在 owner thread 且不在 SDK 事件回调中调用。销毁会停止后台任务,并在已初始化时关闭 Steam SDK 生命周期。

# 6、事件类型

宏 数值 说明
DHSTEAMSDK_EVENT_INIT 1 初始化事件。
DHSTEAMSDK_EVENT_LOGIN 2 登录事件。
DHSTEAMSDK_EVENT_PAY 3 支付/Steam 授权事件。
DHSTEAMSDK_EVENT_QUERY_SKUS 20 商品查询保留事件,当前不会产生。
DHSTEAMSDK_EVENT_TRACK 30 Track 保留事件。
DHSTEAMSDK_EVENT_LOG 31 Log 保留事件。
DHSTEAMSDK_EVENT_DIAGNOSTIC 100 网络、存储和遥测诊断事件。
Last Updated: 2026/11/11 15:12:56