SubmitItemUpdate:提交项目更新

SubmitItemUpdate:提交项目更新

将更新句柄中配置的内容及变更发送到 Steam。适用于实现工坊上传和管理工具的开发者。

工坊发布与加载流程

函数声明

SteamAPICall_t SubmitItemUpdate( UGCUpdateHandle_t handle, const char *pchChangeNote );

参数

名称 类型 作用
handle UGCUpdateHandle_t 输入:由 StartItemUpdate 取得、用于本次操作的更新句柄。
pchChangeNote const char * 输入:本次更新说明字符串;不提供说明时可传 NULL。

返回与完成机制

返回 SteamAPICall_t;用 SubmitItemUpdateResult_t 检查 m_eResult 和协议标志。句柄无效时返回 k_uAPICallInvalid。

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

调用规则与常见错误

提交前检查所有设置调用的返回值。提交后没有取消该次上传的方法;进度可通过 GetItemUpdateProgress 观察,但最终结果以异步调用结果为准。pchChangeNote 可为空指针。

相关站内接口

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

站内字段参考

SubmitItemUpdateResult_t。

官方核对:ISteamUGC::SubmitItemUpdate。