在 Unity 中使用 Industry Viewer Template 构建协作 3D 查看器

Unity行业查看器模板为工业团队提供了一种快速、可靠的方式,以实时共同审查、探索和分享任何大小的3D模型。无论您是在处理CAD组件、建筑BIM数据还是制造零件,行业查看器模板都为从资产管理器流式传输素材资源并在各种设备(如桌面、移动和XR)上启用协作多用户会话提供了优化的基础。
在本操作指引中,您将使用行业查看器模板创建第一个云连接的协作查看器。您将学习如何设置项目、准备3D素材资源以进行流式传输、将其加载到实时会话中,并激活注释、元数据检查和切割部分等强大功能。
到最后,您将拥有一个可以完全自定义以适应您自己工作流程的工业查看器。
如果您愿意,可以观看本操作指引的配套视频。
先决条件
本操作指引适用于具有初级到中级Unity项目开发知识的用户。要完成本操作指引,您需要:
1.安装以下内容:
- Unity 6.2或更新版本
- Unity的行业模板查看器项目,可从GitHub获取
2.确保您在组织中具有以下项目和角色设置:
- 您必须被添加到存储素材资源的项目中。
- 您的账户必须被分配为资产管理项目贡献者角色或更高角色,以便能够管理和上传素材资源。
- 有关用户角色的更多信息,请参阅以下文章:管理对您项目的访问和Unity资产管理器中的角色、席位和项目权限指南.
3.使用行业查看器模板的多人功能需要以下附加服务:
- 分布式权限
- 大厅
- 配对者
- Vivox
- 中继
4. 3D资产:
使用您自己的CAD/BIM模型,或使用在Unity Cloud Asset Manager的外部库中提供的Unity Tower(.rvt和.nwc文件)示例模型
注意:这些服务不需要额外的设置。有关更多信息,请参阅Unity Cloud。
预计完成时间:30-60分钟
准备行业查看器模板
行业查看器模板是一个独立的Unity项目,可以作为.zip文件下载,解压缩后添加为Unity Hub中的项目。
从GitHub下载Unity行业查看器模板
1.在GitHub中,单击代码按钮并选择下载ZIP。
2.将ZIP解压缩到短路径(例如,C:\UnityProjects\IndustryViewer Template),以避免操作系统路径长度问题。

GitHub中的Unity行业查看器模板
在Unity Hub中打开项目
1.启动Unity Hub > 项目 > 添加 > 从磁盘添加项目。
2.选择您提取的项目文件夹(例如,行业查看器模板)。
3.选择Unity 6.2.9f(或更高版本)作为编辑器版本,然后单击打开。首次打开时,Unity 将导入包和素材资源。这可能需要几分钟。
✓ 检查点:项目加载没有错误,并出现在 Hub 项目列表中。
将 Unity 项目链接到 Unity Cloud Services
1.打开项目设置。
2.转到 编辑 > 项目设置 > 服务
3.将此项目链接到您的组织:
- 选择您所在的组织
- 选择一个现有的 Unity Cloud 项目或创建一个新项目
- 当您的 Cloud 项目链接后,关闭项目设置窗口

Unity 编辑器中项目设置的服务常规设置
注意:您的 Unity Industry 许可证必须连接到相关组织。多人会话只有在两个用户在同一组织下连接到同一项目时才能加入。
为何事关重要:云链接是流媒体、多用户会话和协作的支柱。没有它,您将仅限于本地素材和单用户查看。
✓ 检查点:项目显示 已连接 到您的组织和特定的 Cloud 项目。
测试素材资源浏览器
1.在项目窗口的 Assets/Scenes 下打开主场景。
2.在编辑器中按 播放。
3.当行业查看器模板 UI 加载时:
- 点击 登录
- 在您的浏览器中批准身份验证弹出窗口
- 关闭网络浏览器并返回编辑器
4.一旦重定向回编辑器:
- 打开 组织 下拉菜单
您应该看到与您的 Unity 账户相关的所有组织
- 选择组织
您应该看到所有启用 Unity 资产管理器的 Unity Cloud 项目的列表

Unity 编辑器中的行业查看器模板项目
✓ 检查点:行业查看器模板 UI 无错误加载,登录 按钮打开身份验证的浏览器窗口,您的组织和云项目出现在资产浏览器中。
注意:如果资产浏览器中没有资产,请不要担心,我们接下来会处理这个问题。
添加并准备一个 3D 模型以进行流式传输
Unity 资产管理器将您的模型转换为流式优化格式 (3DDS),该格式在查看器模板中可以立即加载。3D 数据流文件支持 30 多种 3D 格式。有关支持的文件格式的更多信息,请查看 支持的文件类型 文档页面。
添加资产
1.在 资产管理器 网络浏览器版本中,选择您的组织和云项目。
- 有关如何使用资产管理器的更多信息,请查看我们的 如何使用 Unity 资产管理器 文章。
2.选择公开可用的行业演示项目。
3.选择 Unity Tower > 添加到项目。
- 您也可以将其添加到集合中。将集合视为文件夹。
4.返回到您的云项目(不是 Unity Industry Demo)。
- Unity Tower 资产的副本现在应该在您的云项目中。
提示:集合可以帮助您按团队、里程碑、项目、客户等分隔数据集。

在网页浏览器中使用 Unity Asset Manager
为 3D 流媒体准备数据集
某些上传不会自动注册为“3D 模型”。您需要明确设置:
1.选择资产 > 编辑文件(或继续编辑)。
2.找到源数据集 > 更多(...)> 编辑。
3.将数据集类型设置为 3D 模型 > 确认。
4.点击更多(...)> 为 3D 数据流媒体准备。
- 这将把您的模型转换为 3DDS 资产。
- 复杂的 CAD/BIM 可能需要几分钟。
5.处理完成后,点击 保存版本。
从我们的文档页面了解更多关于 支持的文件类型 的信息。
注意:这些步骤是必不可少的,否则您将不得不单独转换每个 3D 文件。

为3D流媒体准备数据集
为何事关重要:3DDS资产是查看器流媒体的内容。它保留了层次结构和元数据,同时实现快速加载和跨设备的一致性能。
✓ 检查点:您的资产显示了一个3DDS条目。现在可以流式传输到查看器中。
⚠ 警告:如果您没有看到为3D数据流媒体做准备,您的资产管理角色可能不允许此操作。请向组织管理员请求授予权限或为您运行准备。
将资产流式传输到查看器(播放模式)
将您的项目链接到Unity Cloud,并在编辑器中运行模板后,您现在可以将3D内容带入查看器。行业查看器模板是围绕流式传输您的模型构建的,而不是导入它们。这种方法保持了项目的轻量级,同时支持保留元数据和层次结构的大型复杂工业模型。当多个用户在协作会话中引用相同的云托管资产时,这尤其有用。
流式传输资产
1.在Unity中,打开Assets/Scenes/Main。
2.按播放。查看器UI加载。
3.必要时登录:
- 点击登录 > 允许登录请求。
- 在资产浏览器(游戏视图)中,选择您的组织和云项目(查看器的左上角)。
4.在资产查看器中,选择您的3DDS资产(例如,Unity Tower)> 流式传输。

在Unity行业查看器模板中流式传输资产
流式传输多个资产
1.单击Unity行业查看器模板左上角的资产查看器按钮(文件夹图标)以打开资产查看器。
2.选择任何其他3DDS资产(如果可用)> 添加到场景
- 您可以选择多个资产并同时加载它们。

在Unity行业查看器模板中流式传输多个资产
注意:第一个流式传输到场景中的资产(例如,Unity Tower)被视为根资产,无法从当前流式传输会话中删除。
为何事关重要:流式传输保持本地项目轻量,确保每个人都看到权威版本,并避免重的本地导入。
✓ 检查点:您可以看到您的模型正在加载到场景中。随时使用文件/文件夹图标跳回资产浏览器。
导航、检查和控制场景
一旦您的资产流式传输到查看器中,您可以开始像最终用户一样探索场景。行业查看器模板包括内置的导航模式、检查工具和可视化控件,旨在审查大型工业模型。
导航模式
1.轨道/平移:左键鼠标(轨道),中键鼠标(平移)。
2.飞行穿越:切换导航模式 > 按住右键鼠标查看;使用W/A/S/D移动。
- 大场景:在设置中将移动灵敏度设置为2(或更高)。
3.行走:添加第一人称控制器
- 使用右键查看,使用W/A/S/D移动。
4.根据当前活动的导航模式使用应用内设置更改导航灵敏度
点击查看模板右上角的设置(齿轮图标)
轨道相机
- 轨道灵敏度
- 平移灵敏度
- 缩放灵敏度
飞行相机
- 移动灵敏度
- 旋转灵敏度
行走相机
- 移动灵敏度
- 相机高度
- 旋转灵敏度

Unity Industry查看模板中的导航模式
为何事关重要:不同的数据集受益于不同的导航方法。团队通常使用飞行穿越来穿越大开放空间,使用轨道进行宏观审查,并切换到行走以适应室内。
环境和照明
转到工具 > 环境 > 选择所需的天空盒以快速更改反射/照明上下文。
- 一些环境,例如室内工作室,可能不适合大型模型。

Unity行业查看器模板中的环境
层级和对象控制
- 层级显示所有流式资产及其部分。
- 当在层级中选择一个资产时,可以通过在变换菜单中选择相应的工具来移动和旋转它。
位置和旋转值可以通过变换菜单输入。
网格大小也可以在变换菜单中调整。
- 在层级菜单中,您可以隐藏和显示对象。
- 您还可以删除任何次要资产。
源资产(第一个流式模型)在会话中无法删除,以帮助防止意外丢失上下文。

Unity行业查看器模板中的层级和对象控制
元数据面板
- 选择任何对象以查看BIM/CAD元数据。
- 在设计评审期间使用此功能以确认部件ID、材料、类别、供应商备注等。

Unity行业查看器模板中的元数据面板
注释、测量和截面切割
Unity行业查看器模板包括内置的评审工具,让您可以记录笔记、进行准确测量,并揭示模型的内部细节。这些功能帮助团队更有效地沟通、验证设计和协作。
注释
- 激活注释并在场景中单击以放置标记。
- 输入备注;将捕获屏幕截图/附件。
- 注释同步回 Unity 资产管理器,位于源资产的消息/注释中。

Unity 行业查看器模板中的注释
为何事关重要:反馈 与模型同在,可从 查看器和资产管理器 访问,减少电子邮件/幻灯片的杂乱。
测量
- 两点模式:单击两个点以测量自由形式的距离;拖动标记以进行调整。
- 正交模式:单击一个表面(例如,地板);工具测量到相对的碰撞体(例如,天花板)。
- 单位切换:米/厘米/英尺/英寸。
- 保存 或 清除 测量以供审计。

Unity 行业查看器模板中的测量面板
截面切割
- 启用 截面切割 >移动/旋转/缩放盒子工具。
- 反转以翻转保留/隐藏的体积。
- 切换盒子视觉和工具,根据需要。
- 重置将截面切割工具返回到默认设置。
保存和共享布局
当您组装多个流式资产时,可以将当前设置保存为可重用的布局。布局让您保留加载的资产和场景组织,方便您重新访问工作或与合作者共享完全相同的视图。
当您组装多个素材资源(例如,Unity Tower + Plaza + Park + City Buildings + Building Backdrop)时,将该状态保存为一个布局:
1.点击保存布局并命名该布局。
2.选择组织 > 项目 > 集合。
3.点击保存。

在Unity Industry Viewer模板中保存布局
该布局现在是资产管理器中的一流素材资源,可以被其他人即时加载,非常适合演示和里程碑评审。
协作:邀请和多人游戏
Unity Industry Viewer模板支持实时协作,允许多个用户一起探索同一流式场景。无论您是发送简单的邀请链接还是直接在编辑器中测试多用户会话,这些工具都可以帮助您在部署应用程序之前验证协作工作流程。
如何启用多人模式
1.转到工具 > Multiplay > 为所有平台启用Multiplay
2.转到窗口 > 多人游戏 > 多人游戏模式。
3.启用玩家2(如有需要,还可以启用玩家3/4)。
- 在虚拟玩家启用时,请勿修改包。
4.在每个玩家窗口中,登录并允许登录请求。

在Unity Industry Viewer模板中启用多人模式
加入一个多人会话
1.每个玩家应加载相同的素材资源或布局。
2.在 Unity Industry Viewer Template 中直接协作和沟通。
- Relay、Lobby 和 Vivox 已配置并准备使用。
邀请其他人
使用 邀请 生成访问链接,以便您的团队成员可以加入您的会话。

邀请其他人加入您在 Unity Industry Viewer Template 中的组织
为何事关重要:您可以在单个工作站上验证多用户流程(头像、注释、分区切割),无需额外设备。
VR 评审
为了获得沉浸式、真实比例的观看体验,Industry Viewer Template 还支持 VR(Quest)。使用启用 VR 的场景,您可以直接进入模型内部,从第一人称视角评估空间布局、人体工程学和设计意图。
如何启用 VR 模式
1.转到工具 > VR > 设置独立 VR
2.打开 Assets/Scenes/Main VR
3.转到项目设置 > XR 插件管理 > 启用您的头显/运行时
- 示例:OpenXR、Meta Quest 功能组、XR 模拟。
4.按 播放 并佩戴头显。
5.使用左摇杆在场景中飞行
6.使用右摇杆进行传送移动
- 传送范围取决于场景比例

Unity Industry Viewer Template 中的 VR 模式
为何事关重要:真实比例审查揭示了在2D显示器上难以捕捉的空间和人体工程学问题。
自定义Unity行业查看器模板UI
查看器的界面是完全可定制的,允许您根据品牌或工作流程需求调整外观和感觉。从更换背景视觉到修改菜单和布局元素,您可以调整UI,以为用户创建一个精致、专门构建的体验。
自定义背景
1.在项目窗口中,选择Assets/UI/Background (UXML)。
2.双击背景在UI构建器中打开它。
3.在UI构建器层次结构中,选择Background.uxml
4.在UI构建器检查器中,启用匹配游戏视图以设计您的目标分辨率(例如,1920 x 1080)。
5.在UI构建器层次结构中,选择VisualElement
6.在UI构建器检查器中,展开背景菜单并用您自己的背景图像替换默认背景图像。
7.在UI构建器视口中,选择文件 > 保存。

在Unity行业查看器模板中自定义背景
自定义徽标
1.在项目窗口中,选择Assets/Features/UI/Identity(UXML)。
2.在UI构建器层次结构中,选择VisualElement > Logo。
3.在UI构建器检查器中,展开背景菜单并用您的自定义徽标替换Unity徽标。
- 根据需要调整图像的大小。

在Unity行业查看器模板中自定义徽标
在Unity行业查看器模板中自定义文本
1.在项目窗口中,选择Assets/Features/UI/Identity(UXML)。
2.在 UI Builder 层级中,选择 VisualElement > Text。
3.在 UI Builder 检查器中,找到顶部的属性部分,右键单击 Text > 编辑绑定。
4.将默认消息(Unity Industry Viewer Template)替换为您自己的消息。
5.按 关闭。
- 根据需要随意更改文本的颜色和轮廓颜色。
6.在视口中,按 文件 > 保存。
为何事关重要:您可以拥有自己的生产品牌,而不放弃核心逻辑,简化模板演变过程中的维护。

自定义 Unity Industry Viewer Template 中的文本

在 Unity Industry Viewer Template 中自定义的文本
您现在拥有使用 Unity Industry Viewer Template 构建和部署协作 3D 评审体验的核心知识。
无论您是在处理大型工业模型、多格式工程数据,还是沉浸式设计评审,此工作流程都为实时可视化提供了快速、可扩展的基础。
借助云流式资产、跨设备查看和内置协作工具,您已准备好创建强大的评审应用程序,加速决策并提升工业工作流程。


