ISteamUGC::GetItemState：检查项目状态

GetItemState 用于读取当前客户端所追踪项目的安装、订阅及下载状态，帮助游戏决定是否需要等待或更新。本页面向 Steamworks 游戏和工具开发者，说明接口声明、参数、返回方式以及与工坊内容生命周期相关的注意事项。

函数声明

客户端通过初始化成功后的 SteamUGC() 接口访问；游戏服务器使用服务器上下文的 SteamGameServerUGC()。以下声明按本次核对的官方接口整理，编译时应以项目实际使用的 SDK 头文件为准。

uint32 GetItemState( PublishedFileId_t nPublishedFileID );

参数

返回值与完成方式

返回 uint32 位标志，应与 EItemState 的标记做按位判断。多个状态可能同时存在，不能按单个枚举值比较。

读取返回值后，应按其实际含义处理计数或位标志；涉及输出数组时只遍历实际写入的元素，不要把缓冲区容量误当作结果数量。

调用规则与排查

Installed 可能与 NeedsUpdate 同时出现，说明已有本地内容但不是最新；Downloading 和 DownloadPending 表示下载正在进行或等待。仅有 Subscribed 不代表文件可读。若调用 DownloadItem 返回 true，应先等待下载结果再访问磁盘。

使用场景

例如，游戏发现某项目同时带有已安装和需要更新标志时，可以显示已有内容正在更新，而不立即读取旧文件。如果只有订阅标志，游戏应继续等待安装；安装或下载通知到来后重新读取状态，再决定是否取得路径和加载内容。

相关接口

GetItemInstallInfo、GetItemDownloadInfo、DownloadItem。回调、状态与类型参考整理了相关结构体和枚举，适合在处理结果时对照使用。

资料依据：Steamworks ISteamUGC：GetItemState。资料核对日期：2026 年 11 月 4 日。