Unity 模型展示插件:传入模型的 GameObject,自动分析包围盒、计算取景参数并生成环绕相机,渲染到 RawImage 实时展示。零场景结构要求,一行 API 开箱即用。
| 场景中的模型 | 模型展示效果 |
|---|---|
![]() |
![]() |
- 全自动取景:自动合并 Renderer 包围盒,按"模型占画面比例"(默认 75%)精确计算相机距离
- 环绕交互:自动旋转(可开关)/ 左键拖拽旋转俯仰 / 滚轮缩放
- 两种显示模式:独显(仅当前模型,Layer 隔离)/ 全显(场景全部渲染)
- 自包含 UI:控件级预制体,含自动旋转、恢复初始视角、关闭按钮(自动接线)
- 运行时实时调整:Inspector 改参数画面即时响应;运行时状态(当前模型/半径/角度)只读可视化
- UI 默认隐藏:调用
ShowModel自动打开面板,关闭时相机停止渲染(零开销)
- 将
Prefabs/EasyModelViewer.prefab拖入场景 - Inspector 配置
UI 引用:RawImage、CanvasGroup、三个按钮(可选) - 配置显示模式所需 Layer(见下方注意事项)
- 代码调用:
using WPZ0325.EasyModelViewer;
viewer.ShowModel(modelGameObject); // 自动打开面板、取景、渲染
viewer.Clear(); // 清空显示并释放资源Demo 场景 EasyModelViewerDemo.unity 内置 4 个模型 + 按钮切换示例。
- Layer 31:独显模式需要专用层,已在 ProjectSettings 配置为
EMV_Model;更换层号需同步修改 Inspector 的_modelLayer(8~31) - 独显模式会把模型整棵树临时切换到专用层,退出时自动恢复原层
- 相机与 RenderTexture 均为运行时创建,
Clear()或组件销毁时自动释放

