CreateQueryUGCDetailsRequest:按项目 ID 创建详情查询

CreateQueryUGCDetailsRequest:按项目 ID 创建详情查询

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

工坊分发与加载流程

函数声明

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

UGCQueryHandle_t CreateQueryUGCDetailsRequest( PublishedFileId_t *pvecPublishedFileID, uint32 unNumPublishedFileIDs );

参数

参数 类型 说明
pvecPublishedFileID PublishedFileId_t * 输入:需要查询详情的工坊项目 ID 数组。
unNumPublishedFileIDs uint32 输入:ID 数组的元素个数。

返回与完成机制

成功时返回查询句柄,创建失败返回 k_UGCQueryHandleInvalid。句柄只是请求的本地标识;发送后还需等待异步查询完成,最后调用释放接口。

调用规则与注意事项

传入一个或多个已发布项目 ID,适合为当前界面提供详情。文档列出的单次上限为 1000 项,数量小于 1 会返回无效句柄;不必为只显示少量条目的界面一次请求全部 ID。

创建只准备查询,尚未发出网络请求。可按需要设置筛选和返回字段,随后调用 SendQueryUGCRequest;完成读取或处理失败后释放句柄。

相关站内接口

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

资料依据:Steamworks ISteamUGC 接口。