文件夹结构 (Folder structure)
从版本 6.3 开始，realvirtual 以 UPM (Unity Package Manager) 软件包形式分发。文件夹结构与之前 6.0 及更早版本中使用的 Assets/realvirtual/ 布局相比发生了显著变化。
软件包概览 (Package Overview)
realvirtual 分为两个 UPM 软件包：
| 软件包 | 位置 | 描述 |
|---|---|---|
| io.realvirtual.starter | Packages/io.realvirtual.starter/ | 核心框架 — 驱动器、传感器、信号、传送、抓取、逻辑 |
| io.realvirtual.professional | Packages/io.realvirtual.professional/ | Professional 附加组件 — IK、CADLink、接口、多人模式和更多 |
UPM 软件包在 Unity 中是只读的。您不能在 Packages/ 中编辑文件。将您自己的场景、脚本和资产放在 Assets/ 文件夹中。
Starter 软件包布局 (Starter Package Layout)
Starter 软件包 (Packages/io.realvirtual.starter/) 包含：
| 文件夹 | 描述 |
|---|---|
| Assets/ | 用户可拖入场景的资产 |
| Assets/3DPrefabs/ | 工业 3D 模型（传送带、机器人、箱子、围栏） |
| Assets/Materials/ | 工业材质（塑料、金属、指示灯） |
| Assets/Prefabs/ | 核心功能 prefab（realvirtual.prefab、信号 prefab、接口） |
| Assets/UIPrefabs/ | 运行时 UI 覆盖 prefab |
| Assets/Settings/ | 编辑器 gizmo 选项、相机预设 |
| Assets/RenderPipelines/ | URP 管线配置和设置 |
| Runtime/ | 所有运行时 C# 脚本（组件、行为、接口） |
| Editor/ | 编辑器工具、检视面板和工具栏 |
| Samples\~/ | 演示场景 — 通过 Demo Scenes Browser 或 Package Manager 导入 |
Professional 软件包布局 (Professional Package Layout)
Professional 软件包 (Packages/io.realvirtual.professional/) 包含：
| 文件夹 | 描述 |
|---|---|
| Runtime/ | 按领域组织的 Pro 功能 |
| Runtime/IK/ | 机器人逆运动学 (Robot Inverse Kinematics) + 机器人 prefab |
| Runtime/Interfaces/ | 所有 Pro 接口 (interfaces) (OPC-UA, TwinCAT, KUKA, UR, Modbus 等) |
| Runtime/CADLink/ | CAD 文件导入 (CAD file import) |
| Runtime/PathTracer/ | 运动轨迹可视化 |
| Runtime/Statistics/ | 仿真统计 |
| Runtime/Multiplayer/ | 多用户网络 |
| Runtime/HighlightSystem/ | 对象高亮和选择 |
| Runtime/DistanceSystem/ | 距离测量和可连接对象 |
| Editor/ | Pro 编辑器工具 |
| Samples\~/ | Pro 演示场景（PLC 接口、机器人、机器人接口、高级功能） |
关键资产位置 (Key Asset Locations)
设置场景时，您经常需要这些资产：
| 您需要的 | 位置 |
|---|---|
| 主框架 prefab | Packages/io.realvirtual.starter/Assets/Prefabs/realvirtual.prefab |
| 工业 3D prefab | Packages/io.realvirtual.starter/Assets/3DPrefabs/ |
| 材质库 | Packages/io.realvirtual.starter/Assets/Materials/ |
| PLC 信号 prefab | Packages/io.realvirtual.starter/Assets/Prefabs/ |
| 接口 prefab (Pro) | Packages/io.realvirtual.professional/Runtime/Interfaces/ |
| 机器人 prefab (Pro) | Packages/io.realvirtual.professional/Runtime/IK/ |
| 演示场景 | 通过 Demo Scenes Browser 或 Window > Package Manager > Samples 导入 |
您的项目内容 (Your Project Content)
将所有项目文件放在 Assets/ 中：
- Scenes — 您的仿真场景
- Scripts — 自定义 C# 脚本和行为
- Prefabs — 您自己的可重用 prefab
- Materials — 自定义材质
- 导入的 CAD 数据 — 通过 CADLink 导入的文件
之前的文件夹结构（6.0 及更早版本）(Previous Folder Structure)
在 6.3 之前的版本中，realvirtual 以安装到 Assets/realvirtual/ 的 .unitypackage 形式分发。此文件夹在基于 UPM 的安装中不再存在。参见 升级指南 (Upgrade Guide) 获取迁移说明。