AddItemPreviewFile：添加额外图片预览
为项目添加一份除主预览外的本地预览文件。适用于实现工坊上传和管理工具的开发者。
函数声明
bool AddItemPreviewFile( UGCUpdateHandle_t handle, const char *pszPreviewFile, EItemPreviewType type );
参数
| 名称 | 类型 | 作用 |
|---|---|---|
handle |
UGCUpdateHandle_t |
输入：由 StartItemUpdate 取得、用于本次操作的更新句柄。 |
pszPreviewFile |
const char * |
输入：本地预览图片文件的绝对路径。 |
type |
EItemPreviewType |
输入：额外预览的 EItemPreviewType 类型。 |
返回与完成机制
返回 bool；true 表示设置成功，false 表示更新句柄无效；提交结果另行异步确认。
调用规则与常见错误
提交前提供绝对路径与预览类型。图像应小于 1 MB，并使用网页和应用可显示的格式，如 JPG、PNG、GIF。此函数不支持 YouTubeVideo 或 Sketchfab 类型，YouTube 视频使用 AddItemPreviewVideo。
相关站内接口
AddItemPreviewVideo、UpdateItemPreviewFile、GetQueryUGCAdditionalPreview、SubmitItemUpdate；回调、结构体及枚举。