CreateItem:创建空的工坊项目

CreateItem:创建空的工坊项目

为消费内容的游戏创建一个尚未附加文件的项目。适用于实现工坊上传和管理工具的开发者。

工坊发布与加载流程

函数声明

SteamAPICall_t CreateItem( AppId_t nConsumerAppId, EWorkshopFileType eFileType );

参数

名称 类型 作用
nConsumerAppId AppId_t 输入:实际消费该内容的游戏或应用 App ID。
eFileType EWorkshopFileType 输入:要创建的项目类型,由 EWorkshopFileType 指定。

返回与完成机制

返回 SteamAPICall_t,通过 CreateItemResult_t 检查 m_eResult,成功后保存 m_nPublishedFileId;还需检查 m_bUserNeedsToAcceptWorkshopLegalAgreement。

该返回值标识一次异步调用;注册对应调用结果并持续运行 Steam 回调,不能把取得句柄视为操作成功。结果结构和相关类型见站内 API 类型参考。

调用规则与常见错误

消费 App ID 必须指向游戏;独立上传工具不要误传工具自己的 ID。即用项目通常使用 k_EWorkshopFileTypeCommunity,鉴选项目通常使用 k_EWorkshopFileTypeMicrotransaction。完成创建后调用 StartItemUpdate 设置内容。

相关站内接口

StartItemUpdate、SubmitItemUpdate;回调、结构体及枚举。

站内字段参考

CreateItemResult_t。

官方核对:ISteamUGC::CreateItem。