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;回调、结构体及枚举。