快速入門 - 開始使用適用于 Azure Digital Twins 的 3D Scenes Studio（預覽版）

Azure Digital Twins 3D Scenes Studio （預覽） 是沉浸式 3D 環境，企業和一線員工可以使用視覺內容從其 Azure Digital Twins 解決方案取用和調查運算元據。

在本文中，您將設定使用 3D Scenes Studio 所需的所有資源，包括具有範例資料的 Azure Digital Twins 實例，以及 Azure 儲存體資源。 然後，您將在連線至範例 Azure Digital Twins 環境的工作室中建立場景。

本快速入門中使用的這個範例場景會監視工廠中機器人手臂的攜帶效率。 機器人手臂每小時拿起一定數量的盒子，而攝像機監視每個手臂，以偵測手臂是否無法拿起一個盒子。 每個手臂在 Azure Digital Twins 中都有相關聯的數位對應項，而且每當手臂遺漏方塊時，數位對應項都會以資料更新。 在此案例中，本快速入門會逐步解說設定 3D 場景，以視覺化處理站中的手臂，以及每次遺漏方塊時的視覺警示。

場景看起來會像這樣：

必要條件

您需要 Azure 訂用帳戶才能完成本快速入門。 如果您還沒有帳戶， 請立即免費 建立一個。

您也需要下載範例 glTF （圖形語言傳輸格式） 3D 檔案，以用於本快速入門中的場景。 選取此連結以下載 RobotArms.glb 。

設定 Azure Digital Twins 和範例資料

使用 Azure Digital Twins 的第一個步驟是建立 Azure Digital Twins 實例。 建立服務的實例之後，您可以在快速入門稍後將實例連結到 3D Scenes Studio 視覺效果。

本節的其餘部分會逐步引導您建立實例。 如果您已從先前的快速入門設定 Azure Digital Twins 實例，您可以跳到 下一節 。

建立 Azure Digital Twins 實例

在本節中，您將使用 Azure 入口網站 建立 Azure Digital Twins 的新實例。 流覽至入口網站，並使用您的認證登入。

1. 在入口網站中，從在 Azure 服務首頁功能表中選取 [建立資源 ] 開始。

   

2. 在搜尋方塊中搜尋 Azure 數位對應項 ，然後從結果中選擇 Azure Digital Twins 服務。

   將 [ 計畫] 欄位保留為 [Azure Digital Twins ]，然後選取 [ 建立 ] 按鈕以開始建立服務的新實例。

   

3. 填入安裝程式 [基本] 索引 標籤上的 欄位，包括您的訂用帳戶、資源群組、新實例的 [資源名稱] 和 [區域]。 核取 [ 指派 Azure Digital Twins 資料擁有者角色] 方塊，賦予自己管理實例中資料的許可權。

   

   注意

   如果 [指派 Azure Digital Twins 資料擁有者角色] 方塊呈現灰色，表示您沒有 Azure 訂用帳戶中的許可權來管理使用者對資源的存取權。 您可以繼續在本節中建立實例，然後應該讓具有必要許可權 的人員在實例 上指派此角色，再完成本快速入門的其餘部分。

   符合此需求的常見角色包括 擁有者 、 帳戶管理員 或使用者存取管理員istrator 和 參與者 的組合 。

4. 選取 [ 檢閱 + 建立] 以完成實例的建立。

5. 您會看到摘要頁面，其中顯示您輸入的詳細資料。 選取 [建立 ]，確認並建立實例。

這會帶您前往追蹤實例部署狀態的 [概觀] 頁面。

等候頁面指出您的部署已完成。

收集主機名稱

部署完成之後，請使用 [ 移至資源 ] 按鈕，流覽至入口網站中的實例 [概觀] 頁面。

接下來，記下實例的 主機名稱 值，以供稍後使用。

產生範例模型和對應項

在本節中，您將使用 Azure Digital Twins 資料模擬器 工具來產生範例模型和對應項，以填入您的實例。 然後，您將使用模擬器將範例資料串流至圖形中的對應項。

注意

本快速入門提供模型、對應項和模擬資料，以簡化在 3D Scenes Studio 中建立環境的程式。 設計您自己的完整 Azure Digital Twins 解決方案時，您將自行建立模型和對應項 ，以詳細描述自己的環境，並 據此設定您自己的資料流程 。

此範例案例代表包含六個機器人手臂的套件配送中心。 每個手臂都有一個數位對應項，其屬性可追蹤手臂無法拿起多少個方塊，以及遺漏方塊的識別碼。

1. 流覽至 網頁瀏覽器中的資料模擬器 。

2. 在 [ 實例 URL ] 空間中，輸入 上一節 中 Azure Digital Twins 實例 的主機名稱 。 將 [模擬類型 ] 設定為 [機器人手臂 ]。

3. 使用 [ 產生環境] 按鈕來建立具有模型和對應項的範例環境。 （如果您的實例中已經有模型和對應項，則不會刪除它們，只會新增更多模型和對應項。

   

4. 向下捲動並選取 [開始模擬] 以開始將模擬 資料傳送至您的 Azure Digital Twins 實例。 只有在開啟此視窗 且 [開始模擬] 選項為使用中時，才會執行模擬 。

您可以使用 Azure Digital Twins Explorer Graph 工具來檢視已建立的模型和圖形 。 若要切換至此工具，請從左側功能表中選取 圖形 圖示。

然後，使用 [ 執行查詢 ] 按鈕來查詢實例中建立的所有對應項和關聯性。

您可以選取每個對應項，以更詳細地檢視它們。

若要查看已上傳的模型及其彼此關聯的方式，請選取 [模型圖形 ]。

提示

如需 Azure Digital Twins Explorer 的簡介，請參閱 快速入門開始使用 Azure Digital Twins Explorer 。

建立儲存體資源

接下來，在儲存體帳戶中建立新的儲存體帳戶和容器。 3D Scenes Studio 會使用此儲存體容器來儲存您的 3D 檔案和組態資訊。

您也會設定儲存體帳戶的讀取和寫入權限。 為了快速設定這些備份資源，本節會使用 Azure Cloud Shell 。

1. 在瀏覽器中流覽至 Cloud Shell 。

   執行下列命令，將此會話的 CLI 內容設定為您的訂用帳戶。

   az account set --subscription "<your-Azure-subscription-ID>"
   

2. 執行下列命令，在您的訂用帳戶中建立儲存體帳戶。 命令包含預留位置，可讓您輸入名稱，並選擇儲存體帳戶的區域，以及資源群組的預留位置。

   az storage account create --resource-group <your-resource-group> --name <name-for-your-storage-account> --location <region> --sku Standard_RAGRS
   

   當命令成功完成時，您會在輸出中看到新儲存體帳戶的詳細資料。 尋找 ID 輸出中的值，並複製它以在下一個命令中使用。

   

3. 執行下列命令，將儲存體帳戶上的 儲存體 Blob 資料擁有者 授與自己 。 此存取層級可讓您在 3D Scenes Studio 中執行讀取和寫入作業。 此命令包含與 Azure 帳戶相關聯的電子郵件預留位置，以及您在上一個步驟中複製之儲存體帳戶的識別碼。

   az role assignment create --role "Storage Blob Data Owner" --assignee <your-Azure-email> --scope <ID-of-your-storage-account>
   

   當命令順利完成時，您會在輸出中看到角色指派的詳細資料。

4. 執行下列命令來設定儲存體帳戶的 CORS。 這需要 3D Scenes Studio 才能存取您的儲存體容器。 命令包含儲存體帳戶名稱的預留位置。

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

   此命令沒有任何輸出。

5. 執行下列命令，在儲存體帳戶中建立私人容器。 您的 3D Scenes Studio 檔案將會儲存在這裡。 命令包含一個預留位置，可供您輸入儲存體容器的名稱，以及儲存體帳戶名稱的預留位置。

   az storage container create --name <name-for-your-container> --public-access off --account-name <your-storage-account>
   

   當命令順利完成時，輸出會顯示 "created": true 。

初始化 3D Scenes Studio 環境

現在您已設定所有資源，您可以使用它們在 3D Scenes Studio 中 建立環境。 在本節中，您將建立場景，並針對 Azure Digital Twins 實例中的範例圖形加以自訂。

1. 流覽至 3D Scenes Studio 。 Studio 會開啟，並聯機到您在 Azure Digital Twins Explorer 中最後存取的 Azure Digital Twins 實例。 關閉歡迎示範。

   

2. 選取 實例名稱旁的 [編輯] 圖示，以設定實例和儲存體容器詳細資料。

   

   1. 針對 Azure Digital Twins 實例 URL ，從 [收集主機名稱] 步驟填入 此 URL 中的實例主機名稱 ： https://<your-instance-host-name> 。

   2. 針對 [Azure 儲存體帳戶 URL ]，請將您儲存體帳戶的名稱從 [建立儲存體資源 ] 步驟填入此 URL： https://<your-storage-account>.blob.core.windows.net 。

   3. 針對Azure 儲存體容器名稱 ，從 [建立儲存體資源 ] 步驟中輸入儲存體容器的名稱。

   4. 選取 [儲存]。

   

新增 3D 場景

在本節中，您將使用您稍早在必要 條件中 下載的 RobotArms.glb 3D 模型檔案，建立新的 3D 場景。 場景 包含 3D 模型檔案，以及自動為您建立的組態檔。

此範例場景包含配送中心及其手臂的視覺效果。 您將將此視覺效果連接到您在產生範例模型和 對應項步驟中 建立的範例對應項，並在後續步驟中自訂資料驅動檢視。

1. 選取 [ 新增 3D 場景 ] 按鈕以開始建立新的場景。 輸入場景的 [ 名稱] 和 [描述 ]，然後選取 [ 上傳檔案 ]。

   

2. 流覽您電腦上的 RobotArms.glb 檔案並加以開啟。 選取 建立。

   

   上傳檔案之後，您會看到它列在 3D Scenes Studio 的主畫面上。

3. 選取場景以開啟並檢視它。 場景會在建置 模式中 開啟。

   

建立場景專案

接下來，您將在 3D 視覺效果中定義 元素 ，並將它連結到您稍早設定的 Azure Digital Twins 圖形中的對應項。

1. 在場景視覺效果中選取任何機器人臂。 這會顯示可能的元素動作。 選取 [+ 建立新專案 ]。

   

2. 在 [ 新增] 元素 面板中，[ 主要對應項 ] 下拉式清單包含連線 Azure Digital Twins 實例中所有對應項的名稱。

   1. 選取 [Arm1 ]。 這會自動將數位對應項識別碼 （ $dtId ） 套用為元素名稱。

   2. 選取 [建立專案 ]。

   

元素現在會顯示在場景的元素清單中。

建立行為

接下來，您將建立 專案的行為 。 這些行為可讓您自訂元素的資料視覺效果和相關聯的商務邏輯。 然後，您可以探索這些資料視覺效果，以瞭解實體環境的狀態。

1. 切換至 [ 行為] 清單，然後選取 [ 新增行為 ]。

   

2. 針對 [ 顯示名稱 ]，輸入 封裝線路效率 。 在 [元素] 底下 ，選取 [Arm1 ]。

   

3. 略過 本快速入門中未使用的對應項索引 標籤。

4. 切換至 [ 視覺規則] 索引卷 標。 視覺規則 是元素上的資料驅動重迭，您可以設定來指出元素的健康情況或狀態。

   1. 首先，您將設定一些條件，以指出封裝線的效率。

      1. 選取新增規則。

         

      2. 輸入每小時 取貨 的 顯示名稱 。 將 Property 運算式 保留在 Single 屬性 上 ，然後開啟屬性下拉式清單。 它包含 Arm1 專案主要 對應項上所有屬性的名稱。 選取 PrimaryTwin.FailedPickupsLastHr 。 然後，選取 [ 新增條件 ]。

         

      3. 接下來，您將定義一些界限，以指出每小時取貨何時遺漏太多套件。 在此案例中，假設如果手臂在一小時內錯過三個以上的取貨，則需要注意。 將 條件 > 標示為 3 未接車 ，並定義介於 4 和 Infinity 之間的 值範圍（最小範圍值為內含，最大值為獨佔）。 指派紅色的元素著色 。 選取 [儲存]。

         

      4. 再次選取 [新增條件 ]，然後建立標示 為 1-3 個遺漏取 貨的條件。 定義介於 1 到 4 之間的 值範圍，並指派 橙色的元素著色 。 儲存條件。

         選取 [再新增條件 一次]，然後建立標示 為 0 個未接車 的條件。 定義介於 0 到 1 之間的 值範圍，並指派 綠色的元素著色 。 儲存條件。

         建立這三個條件之後， 請儲存 新的視覺規則。

         

   2. 接下來，再建立一個視覺規則，以顯示遺漏套件的警示。

      1. 從 [ 視覺規則] 索引標籤中，再次選取 [ 新增規則 ]。

         

      2. 輸入 PickupFailedAlert 的 顯示名稱 。 將 Property 運算式 變更為 Custom （advanced） 、輸入 PrimaryTwin.PickupFailedAlert 的屬性 ，並將 Type 設定 為 boolean 。 這是 arm 對應項上的布林屬性，在套件取貨失敗時設定 為 True 。 選取 [新增條件]。

         

      3. 輸入 ${PrimaryTwin.PickupFailedBoxID} 的標籤 失敗 。 稍後，在場景檢視中，這會以動態方式顯示 arm 對應項字串屬性 PickupFailedBoxID 的值，其會保存代表最近無法接手之方塊的識別碼。 將 [ 值 ] 設定為 True ，然後選擇 [徽章 ] 的 視覺類型 。 將 [色彩 ] 設定為紅色，然後選擇 [ 圖示 ]。 選取 [儲存]。

         

      您現在應該會看到這兩個規則列在 [ 視覺規則 ] 索引標籤中。

      

5. 切換至 [Widget] 索引標籤。小工具是提供其他內容和資料的資料驅動視覺效果，可協助您瞭解行為所代表的案例。 在這裡，您將新增兩個視覺小工具，以顯示 arm 元素的屬性資訊。

   1. 首先，建立小工具以顯示手臂的水力壓力值量測計。

      1. 選取 [ 新增小工具 ]。

         

         從 Widget 連結 庫 選取量測計 小工具，然後 選取 [新增小工具 ]。

      2. 在 [ 新增小工具 ] 選項中，新增 [水壓 顯示 名稱 ]、 m/秒 的 度量 單位，以及 PrimaryTwin.HydraulicPressure 的單 一屬性 屬性屬性運算式 。

         設定三個值範圍，讓 0-40 的值 顯示一個色彩， 40-80 出現在第二個色彩，而 80-Infinity 出現在第三個色彩中（請記住最小範圍值是內含的， 最大值是獨佔 的）。

         

         選取 [ 建立小工具 ]。

   2. 接下來，建立小工具，其中包含手臂即時相機串流的連結。

      1. 選取 [ 新增小工具 ]。 從 Widget 連結 庫 ，選取 [連結 小工具]，然後選取 [ 新增小工具 ]。

      2. 在 [ 新增小工具 ] 選項中，輸入 Live arm 相機 的 標籤 。 針對 URL ，您可以使用範例 URL http://contoso.aws.armstreams.com/ ${PrimaryTwin.$dtId} 。 此範例的 URL 上沒有裝載即時相機，但連結代表影片摘要可能會在真實案例中裝載的位置。

      3. 選取 [ 建立小工具 ]。

         

6. 行為選項現在已完成。 選取 [建立行為] 以儲存行為 。

   

封裝 線路效率 行為現在會顯示在場景的行為清單中。

檢視場景

到目前為止，您一直在建 置模式中使用 3D Scenes Studio。 現在，將模式切換為 [檢視 ]。

從 [元素 ] 清單中，選取您建立的 Arm1 元素。 視覺效果會放大以顯示視覺效果元素，並顯示您為其設定的行為。

將行為套用至其他元素

有時候，環境可能包含多個類似的元素，這些元素應該都以類似的方式在視覺效果中顯示（如本範例中的六個不同的機器人手臂）。 既然您已建立一個手臂的行為，並確認它在檢視器中的樣子，本節將說明如何快速將行為新增至其他手臂，讓它們全都顯示檢視器中相同類型的資訊。

1. 返回 建置 模式。 就像您在建立場景元素中 所做的一樣，在視覺效果中選取不同的手臂，然後選取 [ 建立新元素 ]。

2. 針對新元素選取 Arm2 的主要 對應項，然後切換至 [行為] 索引 標籤。

3. 選取 [ 新增行為 ]。 選擇您在本快速入門中建立的 封裝線路效率 行為。

4. 選取 [建立專案 ] 以完成建立新的 arm 元素。

切換至 [ 檢視] 索引標籤，以查看在新的 arm 元素上運作的行為。 您建立行為 時 選取的所有資訊現在都可供場景中的兩個 Arm 元素使用。

提示

如果您想要的話，您可以重複本節中的步驟來建立其餘四個臂的元素，並將行為套用至所有專案，讓視覺效果完成。

檢閱和內容化學習

本快速入門說明如何為 Azure Digital Twins 資料建立沉浸式儀表板、與使用者共用，以及增加對您真實世界環境重要見解的存取權。

在快速入門中，您已建立範例 3D 場景，以代表具有機器人臂的套件配送中心來挑選套件。 此視覺效果已連線到數位對應項圖形，且您已將視覺效果中的手臂連結至提供備份資料的特定數位對應項。 您也建立了視覺行為，以在檢視完整場景時顯示該手臂的重要資訊，包括該手臂在過去一小時內已失敗的方塊取貨。

在本快速入門中，使用 Azure Digital Twins 資料模擬器 ，快速為您建立處理站案例的範例模型和對應項。 搭配您自己的環境使用 Azure Digital Twins 時，您將建立自己的 模型 和 對應項 ，以精確地描述環境的專案。 本快速入門也使用資料模擬器來模擬在遺漏套件時驅動數位對應項屬性更新的「即時」資料。 搭配您自己的環境使用 Azure Digital Twins 時， 擷取即時資料 是您將根據自己的環境感應器自行設定的程式。

清除資源

若要在本快速入門之後清除，請根據您要下一步執行的動作，選擇您想要移除的 Azure Digital Twins 資源。

• 如果您打算繼續進行 Azure Digital Twins 教學課程，您可以在本快速入門中針對這些文章重複使用 實例，而不需要將其移除。

• 如果您想要繼續使用本文中的 Azure Digital Twins 實例，但清除 其所有 模型、對應項和關聯性，請執行下列 az dt job delete CLI 命令：

  az dt job deletion create -n <name-of-Azure-Digital-Twins-instance> -y
  

  如果您只想要刪除 其中一些 元素，您可以使用 az dt twin relationship delete 、 az dt twin delete 和 az dt model delete 命令，選擇性地刪除您想要移除的元素。

• 如果您不再需要 Azure Digital Twins 實例，您可以使用 Azure 入口網站 加以刪除 。

  流覽回入口網站中實例的 [概觀 ] 頁面。 （如果您已經關閉該索引標籤，您可以在Azure 入口網站搜尋列中搜尋實例的名稱，然後從搜尋結果中選取它，以再次找到實例。

  選取 [ 刪除 ] 以刪除實例，包括其所有模型和對應項。

  

您可以流覽至Azure 入口網站 中的儲存體帳戶 [ 概觀] 頁面，然後選取 [ 刪除 ]，以刪除您的儲存體 資源。 這會刪除儲存體帳戶及其內的容器，以及容器中的 3D 場景檔案。

您也可以從本機電腦刪除下載的範例 3D 檔案。

下一步

接下來，繼續進行 Azure Digital Twins 教學課程，以建置您自己的 Azure Digital Twins 環境。

撰寫用戶端應用程式的程式碼