快速入門:在 Unity 中使用 Azure 物件錨點建立 HoloLens 應用程式

在本快速入門中,您將建立使用 Azure 物件錨點的 Unity HoloLens 應用程式。 Azure 物件錨點是受控的雲端服務,可將3D 資產轉換成 AI 模型,以啟用適用于 HoloLens 的物件感知混合現實體驗。 當您完成時,您將會有以 Unity 建立的 HoloLens 應用程式,可以偵測到實體世界中的物件。

您將學習如何:

  • 準備 Unity 組建設定。
  • 匯出 HoloLens Visual Studio 專案。
  • 部署應用程式,並在 HoloLens 2 裝置上執行。

Prerequisites

若要完成本快速入門,請確定您具備︰

  • 您環境中的實體物件和其3D 模型 (CAD 或掃描的) 。
  • 已安裝下列各項的 Windows 電腦:
  • 處於最新狀態且已啟用 開發人員模式 的 HoloLens 2 裝置。
    • 若要在 HoloLens 上更新至最新版本,請開啟 設定 應用程式,移至 [更新與安全性] ,然後選取 [檢查更新] 。

設定您的裝置

若要將應用程式部署到 HoloLens,您必須將 HoloLens 與電腦配對。

  1. 在 HoloLens 中,流覽至 [ 設定]-> 更新 & 安全性-> 開發人員
  2. 按一下 [ 配對],讓畫面保持開啟,直到您在第一次部署期間輸入 PIN 至 Visual Studio 為止。

開啟範例專案

執行下列命令以複製範例存放庫

git clone https://github.com/Azure/azure-object-anchors.git

cd ./azure-object-anchors

下一步是下載適用于 Unity 的 Azure 物件錨點套件。

在這裡找出 Unity (的 Azure 物件錨點套件 com.microsoft.azure.object-anchors.runtime) 。 選取您要的版本,然後使用 [ 下載 ] 按鈕下載套件。

在 Unity 中,開啟 quickstarts/apps/unity/basic 專案。

遵循 此處 的指示,將您下載的 Azure 物件錨點套件匯入至使用 unity 封裝管理員的 unity 專案。

建置並執行應用程式

建立範例場景

在 Unity 編輯器中,流覽至 [ 資產/MixedReality AzureObjectAnchors/場景],然後開啟 [ AOASampleScene],並將它新增至場景組建清單。

選取 [檔案 -> 建立] 設定。 選取 通用 Windows 平臺 然後選取 [ 切換平臺]。 如果 Unity 編輯器指出您需要先下載某些元件,請加以下載並安裝。 請依照下列螢幕擷取畫面來設定組建設定。 確定 只有 AOASampleScene 旁邊有核取記號:不應包含所有其他場景。

組建設定

選取 [ 建立 ] 並選取輸出檔案夾。 您現在可以在輸出檔案夾中產生 VS 專案。

建置並部署應用程式

開啟 Unity 所產生的檔案 .sln 。 將組建設定變更為下列各項。

組建設定

接下來,您必須設定 遠端電腦 IP 位址 ,以部署和偵測應用程式。

以滑鼠右鍵按一下應用程式專案,然後選取 [ 屬性]。 在 [屬性] 頁面中,選取 [設定 屬性-> 的調試]。 將 電腦名稱稱 值變更為 HoloLens 裝置的 IP 位址, 然後按一下 [ 套用]。

遠端偵錯

關閉屬性頁。 按一下 [ 遠端電腦]。 應用程式應該會開始建立並部署到您的遠端裝置。 確定您的裝置為使用中狀態。

執行範例應用程式

開啟裝置,選取 [ 所有應用程式],然後找出並啟動應用程式。 在 Unity 啟動顯示畫面之後,您會看到一則訊息,指出已初始化物件觀察者。 不過,您必須將模型新增至應用程式。

設定 Windows 裝置入口網站

若要透過 WiFi 連接到 HoloLens,請遵循下列步驟:

  1. 將 HoloLens 連接到 WiFi

  2. 然後,在裝置上的 [設定] > Network & Internet > Wi-Fi > Advanced 選項 中取得 IP 位址。

  3. 從您電腦上的網頁瀏覽器,移至 https://<YOUR_HOLOLENS_IP_ADDRESS>。 瀏覽器將會顯示下列訊息:「此網站的安全性憑證有問題」。 因為發給裝置入口網站的憑證是自我簽署的憑證,所以會出現此訊息。 您可以忽略憑證錯誤並繼續。

如需設定 Windows 裝置入口網站的詳細資訊,請參閱 這裡

上傳您的模型

如果您還沒有物件錨定模型,請依照 建立模型 中的指示來建立一個模型。 然後,返回此處。

當您的 HoloLens 連接到 Windows 裝置入口網站時,請遵循下列步驟來上傳應用程式要使用的模型:

  1. 在 Windows 裝置入口網站中,移至 System > File explorer > LocalAppData。 在那裡,您應該會在應用程式清單中看到您的應用程式。

    檔案瀏覽器

  2. 開啟您的應用程式,然後按一下該 LocalState 資料夾。

    開啟 LocalState 資料夾

  3. 將模型檔案上傳至 LocalState 資料夾。

    在入口網站中上傳模型

    再次從 HoloLens 啟動應用程式。 您現在可以偵測符合模型的物件。

應用程式會在目前的視圖欄位中尋找物件,並在偵測到之後追蹤它們。 當實例的6個計量離開使用者的位置時,將會移除實例。 偵錯工具文字會顯示有關實例的詳細資料,例如識別碼、更新的時間戳記和介面涵蓋範圍比率。

疑難排解

提示

如果未偵測到您的物件,您可以嘗試下列步驟:

  1. 再次確認您使用的是正確的物件模型。
  2. 將搜尋區域視覺化,並確定其涵蓋目標物件。
  3. 請嘗試減少 MinSurfaceCoverage
  4. 在 [Windows 裝置入口網站中,按一下 [ Views-> 3D 視圖],並確認掃描是否已完成。

下一步