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;回调、结构体及枚举。
站内字段参考
官方核对:ISteamUGC::CreateItem。