# 其他接口
# 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 | 网络、存储和遥测诊断事件。 |
← 查询接口 小游戏 SDK 接入 Skill →