SetItemMetadata:设置开发者元数据

SetItemMetadata:设置开发者元数据

为项目附加查询可读取的开发者元数据。适用于实现工坊上传和管理工具的开发者。

工坊发布与加载流程

函数声明

bool SetItemMetadata( UGCUpdateHandle_t handle, const char *pchMetaData );

参数

名称 类型 作用
handle UGCUpdateHandle_t 输入:由 StartItemUpdate 取得、用于本次操作的更新句柄。
pchMetaData const char * 输入:随项目保存、供查询取回的元数据字符串。

返回与完成机制

返回 bool;true 表示设置成功;句柄无效或元数据超过限制时返回 false。

调用规则与常见错误

在提交前设置,大小上限 k_cchDeveloperMetadataMax 为 5000 字节。查询时请求 SetReturnMetadata,再用 GetQueryUGCMetadata 读取,无须先下载内容文件。

相关站内接口

SetReturnMetadata、GetQueryUGCMetadata、SubmitItemUpdate;回调、结构体及枚举。

官方核对:ISteamUGC::SetItemMetadata。