RequestUGCDetails:处理旧版详情查询

RequestUGCDetails:处理旧版详情查询

ISteamUGC::RequestUGCDetails 用于处理旧版详情查询。本页面向 Steam 创意工坊浏览器与工具开发者,说明该调用的参数、结果以及它在查询流程中的使用条件。

工坊分发与加载流程

函数声明

以下声明记录了当前参考页面的接口形式;不同 SDK 版本应以项目实际使用的头文件为准。通过初始化成功后的 SteamUGC() 访问该接口。

SteamAPICall_t RequestUGCDetails( PublishedFileId_t nPublishedFileID, uint32 unMaxAgeSeconds );

参数

参数 类型 说明
nPublishedFileID PublishedFileId_t 输入:目标工坊项目 ID。
unMaxAgeSeconds uint32 输入:缓存可接受的最大年龄,单位为秒。

返回与完成机制

返回 SteamAPICall_t,它标识一次异步调用,不是查询数据本身。应用需绑定对应调用结果并驱动 Steam 回调;处理完成后再使用结果或处理失败。

调用规则与注意事项

该接口已弃用,新代码应使用 CreateQueryUGCDetailsRequest 创建查询并通过 SendQueryUGCRequest 发送。旧调用以 SteamUGCRequestUGCDetailsResult_t 交付异步结果;官方没有给两个参数提供进一步的有效性说明,旧项目应对照目标 SDK。

旧接口直接返回异步调用句柄,并不返回 UGC 查询句柄;应保持调用结果接收对象存活并运行回调。改用新版详情查询时,才按新版查询句柄的生命周期发送和释放。

相关站内接口

CreateQueryUGCDetailsRequest、SendQueryUGCRequest;数据结构与枚举可参阅 回调、结构体与枚举。

站内字段参考

SteamUGCRequestUGCDetailsResult_t。

资料依据:Steamworks ISteamUGC 接口。