使用 Azure 数字孪生的 3D 场景工作室（预览版）生成 3D 场景

Azure 数字孪生 3D 场景工作室（预览版） 是一种沉浸式 3D 环境，业务和一线工作人员可以使用视觉上下文从其 Azure 数字孪生解决方案中消耗和调查作数据。

先决条件

若要使用 3D Scenes Studio，需要以下资源。

• Azure 数字孪生实例。 有关说明，请参阅设置实例和身份验证。

  • 获取对实例的“Azure 数字孪生数据所有者”或“Azure 数字孪生数据读取者”访问权限。 有关说明，请参阅设置用户访问权限。
  • 记下实例的 主机名 供以后使用。

• 一个 Azure 存储帐户。 有关说明，请参阅创建存储帐户。

  • 记下存储帐户的 URL 供以后使用。

• 存储帐户中的一个专用容器。 有关说明，请参阅创建容器。

  • 记下存储容器 的名称 供以后使用。

• 对存储资源的权限，包括：

  • 至少拥有“读取者”控制平面访问权限
  • “存储 Blob 数据所有者”或“存储 Blob 数据参与者”数据访问角色

  你可以在存储帐户级别或容器级别授予所需的角色。 有关 Azure 存储权限的说明和详细信息，请参阅分配 Azure 角色。

• 为存储帐户配置 CORS（请参阅以下小节中的详细信息）。

配置 CORS

需要为存储帐户配置 CORS ，以便 3D Scenes Studio 能够访问存储容器。

始终需要指定以下 CORS 标头：

• 授权
• x-ms-version
• x-ms-blob-type

如果打算使用专用链接功能，则需要以下其他 CORS 标头：

• Content-Type
• Content-Length
• x-ms-copy-source
• x-ms-requires-sync

下面是用于设置存储帐户中 CORS 之前列出的方法、源和标头的 Azure CLI 命令。 该命令包含存储帐户名称的一个占位符。

az storage cors add --services b --methods GET OPTIONS POST PUT --origins https://explorer.digitaltwins.azure.net --allowed-headers Authorization Content-Type Content-Length x-ms-version x-ms-blob-type x-ms-copy-source x-ms-requires-sync --account-name <your-storage-account>

现在，你已准备好所需的所有资源，可在 3D 场景工作室中处理场景。

初始化 3D 场景工作室环境

在本部分中，将在 3D Scenes Studio 中设置环境，并为 Azure 数字孪生实例中的示例图自定义场景。

1. 导航到 3D 场景工作室。 工作室随即打开，连接到在 Azure 数字孪生资源管理器中最后访问的 Azure 数字孪生实例。

2. 选择实例名称旁边的“编辑”图标以配置实例和存储容器详细信息。

   

   1. “Azure 数字孪生实例 URL”应以 https:// 开头，后接在先决条件部分记下的实例主机名。

   2. 对于“Azure 存储帐户 URL”，请输入在先决条件部分记下的存储容器 URL。 对于“Azure 存储库容器名称”，请输入在先决条件部分记下的存储容器名称。

   3. 选择“保存”。

   

创建、编辑和查看场景

3D 场景工作室中环境的 3D 表示形式称为“场景”。 场景由自动创建的 3D 文件和配置文件组成。

若要创建场景，请从一个 .GLTF 或 .GLB 格式的分段 3D 文件着手。 可以通过以下链接查看和下载示例 3D 文件：RobotArms.glb。

可以将 3D Scenes Studio 与存储容器中已存在的 3D 文件一起使用，也可以将文件直接上传到 3D Scenes Studio，该文件会自动添加到容器。 下面是使用 3D 文件创建新场景的步骤。

1. 在 3D 场景工作室的主页中，选择“添加 3D 场景”按钮开始创建新场景。

2. 输入场景的名称和说明。

3. 如果希望场景显示在全局视图中，请将“在全局上显示”切换为“开启”。 输入场景的“纬度”和“经度”值。

4. 在链接 3D 文件部分选择以下选项卡之一：

   1. 选择文件，输入已包含在存储容器中的 3D 文件的 URL
   2. 上传文件：从计算机上传 3D 文件

   

5. 选择创建。

编辑场景

若要在创建场景后编辑或删除场景，请使用 3D Scenes Studio 主页中场景旁的 “作” 图标。

编辑场景会在创建场景时重新打开设置的所有场景属性，使你能够更改它们并更新场景。

在地球视图中查看场景

3D 场景工作室的主页显示场景的列表视图。

还可以选择“地球视图”，以直观查看放置在地球上的场景。

生成的地球视图如下所示：

单独查看场景

可以从主页中选择单个场景，以在“生成”模式下将其打开。 在此处，可以查看该场景的 3D 网格，以及编辑其元素和行为。

可以切换到 “视图 ”模式，以便对创建的特定元素和元素行为的可视化进行筛选。

你可以从此处查看元素 的所有属性 ，并在实例上启用 数据历史记录 时查看其值。 若要查看属性历史记录，请选择“打开数据历史记录浏览器”图标。

此项选择将打开属性 的数据历史记录资源管理器 。 有关使用数据历史记录浏览器的详细信息，请参阅验证和浏览历史属性。

在自定义应用程序中嵌入场景

查看器组件还可以嵌入到 3D Scenes Studio 外部的自定义应用程序中，并且可以与第三方组件一起使用。

下面是嵌入式查看器在独立应用程序中的外观示例：

3D 可视化效果组件库可在 GitHub 的 iot-cardboard-js 存储库中找到。 此库是用于创建物联网 （IoT） Web 体验的开源 React 组件库。

有关如何使用库将 3D 体验嵌入自定义应用程序的说明，请参阅存储库的 Wiki，即嵌入 3D 场景。 还可以使用 CRA 物联网纸板示例（该示例为库部署“创建React应用”模板），从而开始使用嵌入查看器生成自定义应用。

添加元素

元素是一组自定义的 3D 网格，与一个或多个基础数字孪生上的数据相链接。

创建新元素的一种方法是从场景的“生成”视图的“元素”选项卡中选择“新建元素”。

或者，可以直接从可视化效果中选择一个网格组件，然后创建一个已连接到该组件的新元素。

创建新元素将打开 “新建元素 ”面板，可在其中填充元素信息。

名称和主要孪生

主要孪生是元素的主数字孪生对应组件。 将元素连接到你的 Azure 数字孪生实例中的孪生，使该元素可以在 3D 可视化效果中表示你的孪生及其数据。

在“新建元素”面板中，“主要孪生”下拉列表包含连接的 Azure 数字孪生实例中所有孪生的名称。 在此字段旁边，可以选择“检查属性”图标以查看孪生体数据，也可选择“高级孪生体搜索”图标，通过查询属性值来查找其他孪生体。

选择要链接到此元素的孪生。 将孪生体链接到此元素会自动应用数字孪生 ID （$dtId） 作为元素 名称。 可根据需要重命名该元素，使 3D 场景的生成者和使用者更容易地理解它。

网格

在“网格”选项卡中，可以指定视觉 3D 网格的哪些组件表示此元素。

如果在可视化效果中选择网格来启动元素创建，则此处已填充该网格。 现在可以在可视化效果中选择网格，以将其添加到元素。

行为

行为是场景的方案。 在此选项卡上选择“添加行为”。在此处，可以选择现有行为以将其添加到此元素，也可选择“新建行为”，输入用于创建新行为的流。

有关创建新行为的详细信息，请参阅 “添加行为”。

其他孪生体

在“其他孪生体”选项卡上，可为元素添加辅助数字孪生体数据源。 如果主孪生体上的数据不足以定义元素所需的所有行为，则可以将其他孪生体添加到元素，因此需要访问其他孪生体的数据。

无法在创建新元素期间添加其他孪生体。 有关添加其他孪生体的说明，请参阅用作行为选项的孪生体。

将其他孪生体添加到元素后，即可在此选项卡上查看和修改它们。

添加行为

行为是场景的场景，它使用相关元素的数字孪生上的特定数据来驱动查看器可视化效果。

创建新行为的一种方法是从场景的“生成”视图的“行为”选项卡中选择“新建行为”。

或者，可以从“元素”选项卡中选择一个元素，然后从该元素的“行为”选项卡创建新行为。

创建新行为将打开 “新建行为 ”面板，可在其中填写行为信息。

名称和场景层

首先选择行为的显示名称。

对于“场景层”下拉菜单，可将此行为添加到现有层，或创建新层以帮助组织此行为。 有关层的详细信息，请参阅管理层。

元素

在“元素”选项卡中，选择此行为应针对的元素。

如果从特定元素启动行为创建过程，则此处已选中该元素。 否则，可在此处首次选择元素。

孪生

在“ 孪生 ”选项卡上，可以修改其数据可用于此行为的孪生集，包括目标元素的主孪生和其他任何孪生体。

可为元素添加辅助数字孪生体数据源。 配置其他孪生体后，就可在此元素的行为表达式中使用这些孪生体的属性。 仅当其他孪生体包含除主孪生体以外的数据时，才应添加其他孪生体，而要在 视觉规则 和 小组件 中使用的此行为。

要添加新的孪生体数据源，请选择“添加孪生体”和“创建孪生体”。

添加新的孪生数据源将打开一个新的 孪生 面板，可在其中命名新孪生体，并从 Azure 数字孪生实例中选择一个孪生体进行映射。

视觉规则

在“视觉规则”选项卡中，可以在元素上配置数据驱动的覆盖，以在查看器中指示其运行状况或状态。

要创建规则，请先选择“添加规则”。

为规则选择一个“显示名称”。

接下来，选择规则是依赖于”单一属性”还是”自定义(高级)”属性表达式。 对于 单个属性，可以在主孪生体上获取数值属性的下拉列表。 对于 自定义（高级），可以获取一个文本框，可在其中使用一个或多个属性编写自定义 JavaScript 表达式。 表达式的结果必须与在“类型”字段中指定的结果类型匹配。 有关编写自定义表达式的详细信息，请参阅使用自定义（高级）表达式。

定义属性表达式后，选择 “添加条件 ”以定义条件视觉效果。

在“添加条件”选项中，为可视化中的条件输入“标签”。

然后，设置 值 以标识条件的值边界（具体选择更改取决于属性类型）。 对于数值属性，每个值范围的最小值是包容性的，而最大值是排它性的。

在“操作”下，定义满足条件时场景可视化中发生的情况。 可以使用“网格着色”控制查看器中属性表达式的颜色，或使用“徽标”在满足属性表达式的条件时显示特定颜色和图标的徽标。

完成后，选择“保存”。

小组件

小组件在 “小组件 ”选项卡上进行管理。 小组件 是提供更多上下文和数据的数据驱动视觉对象，可帮助你了解行为所代表的方案。 配置小组件有助于确保在特定条件处于活动状态时能够发现正确的数据。

选择“添加小组件”以显示“小组件库”，在其中可从不同类型的可用小组件中进行选择。

下面是可以创建的小组件类型：

• 仪表：用于直观表示数值数据点

  输入显示名称和度量单位，然后选择仪表是反映“单个属性”还是“自定义(高级)”属性表达式。 对于 单个属性，可以在主孪生体上获取数值属性的下拉列表。 对于 自定义（高级），可以获取一个文本框，可在其中使用一个或多个属性编写自定义 JavaScript 表达式。 表达式应具有数值结果。 有关编写自定义表达式的详细信息，请参阅使用自定义（高级）表达式。

  定义属性表达式后，设置值范围以仪表上的特定颜色显示。 对于每个值范围，包含最小值，不含最大值。

  

  注意

  如果无法从下拉列表中选择属性，因为列表未响应，则此缺少响应可能意味着实例中的某些模型中存在错误。 例如，在模型属性中具有非统一枚举值会破坏此功能。 如果发生此错误， 请查看模型定义 并确保所有属性都有效。

• 链接：用于通过带链接的 URL 包含外部引用的内容

  输入标签和目标 URL。

  

  链接 URL 还可包含采用以下语法的计算表达式：${<calculation-expression>}。 上一个屏幕截图包含用于访问主孪生体属性的表达式。 表达式在 查看器中动态计算和显示。

• 值：用于直接显示孪生属性值

  输入显示名称，然后选择要显示的属性表达式。 此属性表达式可以是主孪生的 单个属性 ，也可以是 Custom （高级） 属性表达式。 自定义表达式应该是使用孪生体一个或多个属性的 JavaScript 表达式，并选择表达式生成的结果类型。 如果自定义属性表达式输出字符串，还可使用 JavaScript 的模板文本语法在字符串输出中包含动态表达式。 使用以下语法设置动态表达式的格式：${<calculation-expression>}。 然后，使用反引号 (`) 将整个字符串输出引起来。 有关编写自定义表达式的详细信息，请参阅使用自定义（高级）表达式。

  

  注意

  如果无法从下拉列表中选择属性，因为列表未响应，则此缺少响应可能意味着实例中的某些模型中存在错误。 例如，在模型属性中具有非统一枚举值会破坏此功能。 如果发生此错误， 请查看模型定义 并确保所有属性都有效。

  下面是一个值小组件的示例，用于检查主孪生体的值是否 InFlow 超过 99。 如果超过，它将输出包含孪生体的 $dtId 表达式的字符串。 否则，输出中没有表达式，因此不需要反杆。

  下面是值表达式：PrimaryTwin.InFlow > 99 ? `${PrimaryTwin.$dtId} has an InFlow problem` : 'Everything looks good'。 表达式 （the $dtId） 的计算结果显示在查看器中的小组件中。

  

• 数据历史记录：用于显示一段时间内的属性值。 此小组件适用于 Azure 数字孪生 的数据历史记录功能，因此仅在为此 3D 场景中使用的实例 启用数据历史记录 时才可用。 实例存在数据历史记录连接后，可以使用此小组件显示该数据。

  该小组件通过定位已连接到此 Azure 数字孪生实例的 Azure 数据资源管理器实例中的数据自动填充 连接字符串 字段。

  输入“显示名称”，并根据主要孪生体的属性添加一个或多个“时序”数据集。 还可以自定义时序数据在小组件图表中的显示方式。

  

  注意

  如果无法从下拉列表中选择属性，因为列表未响应，则此缺少响应可能意味着实例中的某些模型中存在错误。 例如，在模型属性中具有非统一枚举值会破坏此功能。 如果发生此错误， 请查看模型定义 并确保所有属性都有效。

使用自定义（高级）表达式

在行为中定义 视觉规则 和 小组件 时，你可能希望使用自定义表达式来定义属性条件。

这些表达式使用 JavaScript 语言，并支持使用关联孪生体的一个或多个属性来定义自定义逻辑。 表达式的结果必须与在“类型”字段中指定的结果类型匹配。

下表指示 3D 场景工作室自定义表达式所支持的 JavaScript 运算符。

管理层

可以在场景中创建层来帮助组织行为。 层类似于行为的标记，使你能够定义需要一起查看哪些行为，从而为不同的角色或任务创建场景的自定义视图。

创建层的一种方法是使用场景的“生成”视图中的“场景层”按钮。

选择 “新建层 ”会提示输入要创建的新层的名称。

或者，可以在创建或修改行为时创建层。 行为窗格还可以将行为添加到已创建的层。

查看查看器中的场景时，可使用“选择层”按钮选择可视化效果中显示的层。 不属于任何层的行为将被分组到“默认层”下。

配置最低刷新率

3D 场景查看器的默认刷新速率为 10 秒，然后以每孪生半秒的速度增加（有关详细信息，请参阅 刷新速率和性能）。 这是可能的最小刷新速率。

如果要减慢刷新速率，可以手动将 3D 场景查看器 的最小刷新速率 配置为 10 秒到 1 小时之间的任何内容。

若要配置最小刷新速率，请从场景中的生成器开始，然后选择 “场景配置 ”按钮。

使用下拉列表选择刷新率选项。

在查看器中查看场景时，可以将鼠标悬停在“刷新”按钮上以查看刷新率设置和上次刷新的时间。 还可以选择该按钮来手动刷新场景。

修改主题

在场景的生成器或查看器中，可选择“主题”按钮来更改显示画面的样式、对象颜色和背景色。

共享环境

3D 场景工作室环境由 Azure 数字孪生实例和 Azure 存储容器的独特配对组成。 你可与他人共享整个环境（包括所有场景），也可共享特定场景。

要与他人共享环境，请首先向他们授予对资源的以下权限：

• Azure 数字孪生实例上的“Azure 数字孪生数据读取者”访问权限（或更高）
• 对存储容器的“存储 Blob 数据读取者”访问权限（或更高）
  • 存储 Blob 数据读取器 允许他们查看场景。
  • 存储 Blob 数据所有者 或 存储 Blob 数据参与者 允许他们编辑场景。

然后，按照本节其余部分的说明共享整个环境或特定场景。

共享常规环境

其他人拥有所需的权限后，可通过两种方式向他们授予对你的整个环境的访问权限。 可执行以下任一操作：

• 使用 3D 场景工作室主页上的“共享”按钮复制你的 3D 场景工作室环境的 URL。 （URL 包括 Azure 数字孪生实例和存储容器的 URL。）

  向接收者共享该 URL，他们可将它直接粘贴到浏览器中以连接到你的环境。

• 共享在初始化 3D 场景工作室环境时使用的 Azure 数字孪生实例的 URL 和 Azure 存储容器的 URL。 接收者可以访问 3D 场景工作室，并使用这些 URL 值将其初始化，以连接到你的环境。

授予他们访问权限后，收件人可以在工作室中查看和交互场景。

共享特定场景

还可通过直接指向特定场景的链接共享你的环境。 要共享特定场景，请在“视图”模式下打开场景。

使用“共享场景”图标生成指向场景的链接。 可选择是否要链接以保留当前层和元素选择项。

当收件人将此 URL 粘贴到其浏览器中时，指定的场景将在查看器中打开，其中选择了任何选定的层或元素。

后续步骤

在 3D 场景工作室入门中使用示例方案试用 3D 场景工作室。

或者，使用 Azure Digital Twins Explorer 以不同的方式可视化 Azure 数字孪生图。