用于管理图像的插件 API,很多umod插件依赖它。v2.0.60
图像库是其他插件可以用来存储和管理图像以在 UI 中使用的工具。它本身并没有真正的目的。
控制台命令
refreshallimages – 检索并存储所有项目图标 URL(包括工作室图像)。如果配置选项“图像 – 仅在需要时下载图像”设置为true,也会将每个图标下载到文件存储
cancelstorage – 这将取消所有挂起的文件下载
配置
可以在目录ImageLibrary下的文件中配置设置和选项config。建议使用编辑器和验证器来避免格式问题和语法错误。
{
"Avatars - Store player avatars": true,
"Steam API key (get one here https://steamcommunity.com/dev/apikey)": "",
"Progress - Show download progress in console": true,
"Progress - Time between update notifications": 20,
"User Images - Manually define images to be loaded": {},
"Version": {
"Major": 2,
"Minor": 0,
"Patch": 47
}
}
配置选项
“头像 – 商店玩家头像”:下载玩家头像图片(某些插件可能需要这个)
“进度 – 在控制台中显示下载进度”:此选项将在控制台中显示加载订单的
进度 “进度 – 更新通知之间的时间”:进度更新之间的时间量
“用户图像 – 手动定义要加载的图像”:要下载的用户指定图像(某些插件可能需要此)
“Steam API 密钥(在此处获取一个 https://steamcommunity.com/dev/apikey )”:这是从工作坊下载皮肤图像所必需的
Setup Approved 和 Workshop 皮肤支持
要使 ImageLibrary 能够访问已批准的 Steam 创意工坊皮肤图标,您必须提供有效的 API 密钥。这些密钥已注册到您的 Steam 帐户,每天限制为 100,000 次 API 调用。
要获取您的 Steam API 密钥,请访问 -> https://steamcommunity.com/dev/apikey
获得 Steam API 密钥后,将其复制并粘贴到配置中的“Steam API 密钥”条目中
注意:图像导入/加载方法有一个可选的回调参数,当加载完成时会调用一个函数
从插件导入创意工坊皮肤
可以通过调用“LoadImageList”方法从创意工坊导入皮肤。
此方法专门用于为您的插件查找和下载项目图标。LoadImageList 将对您提供的项目皮肤 ID 列表进行排序,游戏尚未实现的任何皮肤 ID 都将被传递到 Steams API 以尝试查找图标。
应该使用指定的回调调用此方法,并且在调用该回调之前不应启用您的插件!
有关使用此方法的示例,请参阅 ServerRewards
WTF是加载命令吗?
加载顺序是插件请求下载的一组图像。例如,在 ServerRewards 中,当 UI 生成时,它会创建一个加载顺序,请求商店中的每个项目都下载其图标。任何尚未存储的项目图标都将按该加载顺序排队等待处理。然后,用户将能够通过 RCon 在控制台中查看该加载顺序的进度。这将项目的大型队列列表分解为更小的类别,以便更好地优化并防止图像下载加倍
暂无评论内容