常见问题¶
Q: 是否支持所有渲染管线?¶
A: 插件在 Built-in 渲染管线下开发,截图使用 Scene 视图的相机。目前没有对所有渲染管线进行验证。
Q: 截图很多,占用大,切换格式后旧文件未清理?¶
A: 可以在 Screenshot Settings... 中选择 JPEG 并降低质量,点击 Save 后生效。设置只影响之后拍摄的截图,不会转换已有图片。重新截图时,程序会清理同名的其他格式文件。
如果想删除不需要的截图,请从主窗口删除对应项。直接删除 Assets/CYN-lab/Avatar_Scene_Browser/Screenshot 文件夹只会删掉图片,浏览器记录仍会保留。
Q: 场景重命名或移动后,浏览器找不到了怎么办?¶
A: 插件使用 Scene GUID 和路径记录场景。在 Unity 项目窗口中移动或重命名时,通常仍能通过 GUID 找到文件。若记录与文件不一致,使用 GUID 批量更新工具 检查和修复。
工具需要通过原路径或 GUID 找到现存文件,不能恢复已经删除的场景。
Q: 多 Avatar 配置截图功能需要什么条件?¶
A: 需要安装 VRChat SDK(VRCSDK3),并且场景中至少有两个带 VRCAvatarDescriptor 的 Avatar,未激活的也计入总数。只有一个 Avatar 时使用普通场景截图;没有 SDK 时也可以使用普通截图。
控制配置中的显示状态,请使用 Avatar 根对象的激活开关,不要只切换 Hierarchy 的眼睛图标。
Q: 为什么再次截图没有新增配置?¶
A: 同一个场景中,相同的 Avatar 激活组合会更新已有配置。更换激活的 Avatar 组合后,才会新增配置。仅改变视角、服装或姿势不会产生另一份配置记录。
Q: 不同 Avatar 的截图为什么可能互相覆盖?¶
A: 当前单 Avatar 配置的图片文件名由 Scene 名称和 Avatar 名称组成。同一场景内的同名 Avatar,或不同文件夹下同名 Scene 中的同名 Avatar,可能写入同一个图片文件。请让这些 Scene 和 Avatar 的名称有所区别。这里指多 Avatar 场景中只激活一个 Avatar 的配置,不是只有一个 Avatar 的普通场景截图。
Q: 双击截图和“打开此场景”有什么区别?¶
A: 双击普通截图只打开场景;双击 Avatar 配置截图会同时加载配置。“打开此场景”和配置右键菜单中的“仅打开场景”只打开场景,不恢复配置。
配置只记录 Avatar 根对象的激活状态,不记录服装、材质、姿势或拍摄视角。
Q: 怎样更新某个 Avatar 配置的图片?¶
A: 先双击配置加载它,调整 Scene 视图,再点击工具栏截图按钮,或主窗口顶部的 刷新当前打开的Scene截图。
当前右键“刷新截图”、详情栏“打开此场景+刷新截图”和“刷新所有截图”都使用普通场景截图流程,不会逐个恢复并更新 Avatar 配置。
Q: 缩略图上出现了错误图标,是什么意思?¶
A: 主要有三种情况:
- 场景文件缺失:记录的路径和 GUID 都无法找到 Scene 文件,可先用 GUID 工具 检查。
- 配置过时:插件判断场景记录比 Avatar 配置更新,旧配置会保留并显示警告。批量刷新或部分标签操作也可能触发这类警告,不能只凭图标判断 Avatar 已被删除。
- Avatar 无法找到:当前活动场景中的对象无法与配置里的记录对应,需要检查 Hierarchy 中的 Avatar。
确认配置不再需要后再手动删除。GUID 工具处理的是场景文件关联,不能修复配置中缺失的 Avatar 对象。
Q: 如何删除某个 Avatar 配置截图?¶
A: 可以右键配置缩略图选择 删除截图数据,也可以在右侧 Avatar 配置 列表中点击 ✕,然后确认。
当前删除最后一个 Avatar 配置时,也会移除该场景在浏览器中的记录,即使以前保存过普通截图。Unity 场景文件本身不会被删除。需要重新加入浏览器时,打开原场景并再次截图。
Q: 为什么标签使用量显示为 0,配置里却还在用?¶
A: 当前标签管理器只统计场景标签,不统计 Avatar 配置标签。重命名或删除标签也不会同步修改配置里的旧名称,详情见 标签管理。
授权与支持¶
Q: 此插件可以用于商业项目吗?¶
A: 可以,具体授权条款请查看插件目录中的 LICENSE.md。
Q: 为什么免费?¶
A: 因为后续无法保证持续维护。