UpdateItemPreviewFile:替换额外图片预览

UpdateItemPreviewFile:替换额外图片预览

根据已有预览索引更新对应的本地图片。适用于实现工坊上传和管理工具的开发者。

工坊发布与加载流程

函数声明

bool UpdateItemPreviewFile( UGCUpdateHandle_t handle, uint32 index, const char *pszPreviewFile );

参数

名称 类型 作用
handle UGCUpdateHandle_t 输入:由 StartItemUpdate 取得、用于本次操作的更新句柄。
index uint32 输入:待操作的额外预览索引;对应已有预览的顺序。
pszPreviewFile const char * 输入:本地预览图片文件的绝对路径。

返回与完成机制

返回 bool;true 表示设置成功,false 表示更新句柄无效。

调用规则与常见错误

在提交前调用,索引从 0 开始;先查询额外预览数量并选择有效索引。图片需小于 1 MB,使用网页和应用可显示的 JPG、PNG 或 GIF 等格式。

相关站内接口

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

官方核对:ISteamUGC::UpdateItemPreviewFile。