用户指南

RealityConnect for Revit 旨在弥合高保真数字孪生与你的 BIM 环境之间的鸿沟。它使你能够将大规模实景采集数据直接流式传输到 Revit 中而不耗尽系统资源，并为资产管理提供简化的界面。

---

访问你的数据

要访问你的数据，你必须先建立到 Prevu3D 的连接。

1. 在 Revit 中，点击 Prevu3D 功能区中的 Connect 按钮。
   Web 浏览器将打开并将你重定向到 Prevu3D 身份验证页面。

2. 在你的 Web 浏览器中，如有需要，登录你的 Prevu3D 账户。

3. 在 Web 浏览器中，授权该插件访问你组织的数据。

4. 回到 Revit 中，连接对话框将打开，并在标题栏中显示你当前的 Organization 和已登录的账户。选择：

   • Division，

   • 然后是包含所需 RealityTwin 的 Site。

5. 点击 Continue 以确认连接。

6. 连接后，Display Environment 和 Manage Assets 按钮将变为可用。

注意

你的会话会安全地缓存在本机，因此你在多个 Revit 会话之间保持登录状态，重新连接也不会再打开浏览器。若要使用其他账户或组织登录，请使用连接对话框标题栏中的 Switch 按钮。

环境显示

Environment Display 工具将所选的 RealityTwin 直接流式传输到活动的 3D 视图中，为你的项目提供即时的站点上下文。

• 显示 / 隐藏环境
  点击 Display Environment 以在当前视图中流式传输并显示环境。
  激活后，该按钮变为 Hide Environment，允许你一键移除环境叠加层。

• 内存流式传输
  环境完全在内存中流式传输，不在磁盘上创建或加载文件，从而确保快速交互并将对系统资源的影响降至最低。

• 视图相关的细化
  场景在正交和透视 3D 视图中根据相机位置逐步细化，在关键之处提升视觉质量，同时保持流畅的性能。

有关渲染选项、HLOD 行为和性能限制的详情，请参阅环境设置文档。

资产管理器

Asset Manager 允许你浏览、管理所选 RealityTwin 中的资产，并将其导入你的 Revit 模型。

注意

已加载的资产会根据当前显示样式进行调整。显示环境叠加层时，以 Embedded 模式导入的资产以纯色显示并由叠加层填充，而以 Textured Family 导入的资产会保留其真实纹理，并可与流式传输的环境同时显示。

资产操作

• Load Selected
  将所选资产加载到活动的 Revit 视图中。

• Unload Selected
  如果所选资产当前已加载，则将其从场景中移除。

• Locate
  移动相机以聚焦所选资产。
  此操作需要资产已加载到场景中才可用。

全局操作

• Refresh
  从 RealityTwin 重新加载资产列表，使面板与最新数据同步。

• Reset
  将 Asset Manager 恢复到其默认状态。

资产筛选

• Search
  按名称筛选资产。

• Status filter
  根据资产的当前状态筛选资产。

操作反馈

• Progress column
  显示每个资产正在进行的操作的进度。

• Status summary
  显示可用、已选和已加载资产的数量。

有关资产质量、定位和导入行为等配置选项，请参阅资产设置文档。

设置

使用 Settings 菜单自定义 Prevu3D 插件的行为、性能和外观。
设置分为三个主要部分：General、Environment 和 Assets。

常规

常规设置控制插件的整体行为和外观。

• Import Alignment
  定义将资产导入 Revit 时使用的默认对齐方式：

  • Shared Coordinates

  • Origin to Origin

• Theme
  选择插件的视觉主题：

  • Light

  • Dark

  • Same as Windows

环境

环境设置控制 RealityTwin 在 3D 视图中的流式传输和显示方式。

• Triangle Budget 设置流式传输环境的目标几何细节层次。 较高的值会提升视觉保真度，但需要更多系统资源（RAM、GPU 和 CPU）。默认值为 4,000,000。根据你的硬件，大致参考如下：

  • 约 2,000,000 —— 入门级计算机或笔记本电脑

  • 4,000,000 —— 均衡的默认值，适合大多数工作站

  • 8,000,000 或更高 —— 配备独立 GPU 的高端工作站

  如果导航出现卡顿，请降低此值或减小 Frame Time Budget。

• Frame Time Budget
  通过限制每帧的处理时间量来控制导航流畅度。
  较低的值在相机移动期间优先考虑响应速度，可能会在导航时降低可见细节。

• Display Mode
  定义环境的渲染方式：

  • Colored —— 使用来自 RealityTwin 的顶点颜色

  • Shaded —— 使用中性灰色材质显示几何体

• System Statistics
  显示实时性能指标，包括：

  • Triangle Count

  • Last Frame Time

  这些指标有助于评估当前环境设置是否适合你的硬件和性能预期。

资产

资产设置定义单个对象如何加载和导入 Revit。

资产质量层级

每个资产质量层级由目标三角形数量定义，让你能够在视觉细节和性能之间取得平衡。

• Low Quality Triangles
  设置以低质量加载的资产所用三角形的最大数量。

• Medium Quality Triangles
  设置以中等质量加载的资产所用三角形的最大数量。

• High Quality Triangles
  设置以高质量加载的资产所用三角形的最大数量。

每个值都可以单独重置为其默认值。

默认资产行为

• Default Quality
  定义加载资产时默认使用的质量层级。

• Import Mode
  定义资产如何导入 Revit 项目：

  • Textured Family —— 写出带纹理的 OBJ，将其导入 Revit 族（Generic Model）并在场景中放置一个实例，同时将可重用的 .rfa 保留在生成文件文件夹中，以便日后独立重新导入。资产会保留其真实纹理和 Revit 的默认外观，流式传输的环境会在其后方被裁剪掉，使两者可同时显示。

  • Embedded —— 将几何体直接烘焙到 Revit 文件中，磁盘上不留文件（按区域的纯色，无纹理），以获得更好的项目可移植性

• Generated files folder
  指定使用 Textured Family 导入模式时用于存储生成文件（.obj 和 .rfa）的本地文件夹。Embedded 模式不会写入任何文件。留空则使用默认位置。