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 接口。