Vuforia Hololens2 開發 踩坑 總結 Image Target

配置開發環境

• Windows 10系統；
• Windows 10 SDK (10.0.18362.0)；
• Visual Studio 2019 (16.2 或更高版本)；
  注意：先安裝win 10 SDK，路徑名儘量短，再安裝VS 2019，不然會有路徑報錯問題： “IOException: Win32 IO returned 234”，路徑名過長所導致。如果已有路徑報錯問題，可以把報錯的winmd文件刪除；如果還不行，卸載VS和win10 sdk再按序重裝吧。
• Unity Hub；
• 用Unity Hub安裝2018.4.21f1 LTS，添加Universal Windows Platform模塊；
• 創建一個新工程，將Unity切換到Universal Windows Platform：
  注意：在 Windows 上工作時，有 255 個字符的 MAX_PATH 限制。 如果任何文件路徑的長度超出 255 個字符，則 Unity 受這些限制影響，可能無法編譯。 因此，強烈建議將 Unity 項目存儲在儘可能靠近驅動器根目錄的位置。

點這裏看官網清單。

配置Hololens2

1. 根據嚮導初初次設定設備；
2. 在Hololens2中，進入設置->更新和安全->開發者選項，打開以下功能：
   • 使用開發人員功能
   • 啓用設備門戶
3. 將Hololens2和PC連到同一個Wifi中，進入設置->網絡和Internet->高級選項，查看IPv4地址；
4. 在PC端瀏覽器中輸入上面得到的IPv4地址，打開Windows Device Portal；

• 如果提示連接不安全，先通過“高級”進去再說；
• 如果是第一次連接，則需要設定Hololens2連接PC的pin和密碼；
• 進入Preferences，下載證書(certificate)並安裝到“受信任的根證書頒發機構”中，重啓瀏覽器：
  
  
  
• 注意：如果想要在PC上使用Hololens2的投屏功能，請先檢查“連接”功能是否奏效：
  

配置Vuforia與Unity

1. 註冊Vuforia賬戶；
2. 下載Vuforia Engine 9.0並安裝到Unity 2018.4.21f1安裝路徑下：
   注意：Unity Asset Store的Vuforia Sample和Unity通過Package Manager下載的Vuforia Engine(9.0以下版本)可能會有腳本衝突。
   注意：如果想要升級Vuforia Engine，選擇了第一個“Add Vuforia Engine to a Unity Project or upgrade to the latest version”，下載導入Unity之後，點擊Upgrade：
   
   導致manifest.json報錯：
   
   請根據路徑打開manifest.json，刪除紅框部分：
   
   回到Unity，重新import之後會再問你一遍是否升級，這時候要選Cancel：
   
   然後刪除剛剛升級包導入的文件夾/文件：
   
   重新下載VuforiaSupprotInstaller，覆蓋安裝。

這個問題可能是翻牆軟件導致的，試過改系統變量、重裝Unity等方法依然不行，各位有什麼好方法可以交流交流

3. 下載HoloLens sample並導入到Unity中：
   
4. 在Unity內配置MRTK：
   
   注意：如果打開MSBuild導致Visual Studio編譯的時候報錯，那就不要開；官網都建議你不要開：
   
5. 檢查Player Settings的XR Settings：
   
   注意：如果打開Remoting Support導致Visual Studio遠程編譯的時候報錯，那就不要開。
6. 檢查Player Settings的Publishing Settings以下Capabilities是否打開：
   • InternetClinet
   • WebCam
   • MicroPhone
   • SpatialPerception
7. 打開Window下的Vuforia Configuration，填寫App License Key：
   
   
8. 準備攝像頭(沒有可以跳過)，還是在Vuforia Configuration裏，檢查攝像頭是否加載正確：
   

測試Image Targets

1. 按住ctrl，拖拽SampleResources->Scenes下的2-ImageTargets到新文件夾，用拷貝的新場景進行測試：
   
2. 關於Demo自帶的ImageTarget Object：
   
3. 使用自己的DataBase：
   
   
4. 打印測試用的圖，在PDF裏：
   
5. Play，用攝像頭測試；
   注意：使用Holographic Emulation是不能用Hololens2直接進行AR識別的(至少我是這樣)，所以沒有攝像頭還是得出包測試。
6. 出包設置：
   - 只保留當前場景：
   
   - 打開Build Window：
   - 設置Appx Build Options(雖然設置了Platform Toolset爲v141，不過不知爲何，在VS打開工程依然是v142)：
   
   - 設置Deploy Options，由於我的PC沒法在Unity裏通過Wifi連接Hololens2(但是可以通過瀏覽器登陸Windows Device Portal)，所以這裏的Target Type用Local：
   
7. 打包:
   
8. 打包完成後用VS打開：
   
9. 如果提示沒有v142生成工具：
   - 右擊項目，進入屬性：
   
   - 將平臺工具集改成"V141"，點擊應用：
   - 重定向項目：
   
10. 打包到Hololens2：