練習 - 開始使用 StereoKit

已完成

現在我們已經進一步了解 StereoKit,讓我們繼續進行下一個步驟。 我們一開始會安裝使用 StereoKit 的工具和必要條件。 接下來,本單元將教導您如何透過 Visual Studio 範本安裝 StereoKit,並在裝置、電腦和 HoloLens 2 上啟用開發人員模式。

以下是開始使用 StereoKit 進行開發所需的快速清單:

安裝 Visual Studio 2019

  1. 下載免費版的 Visual Studio Community

    The screenshot shows how to begin your download, by clicking the Free download button from Visual Studio Community.

  2. Visual Studio 安裝程式儲存到裝置路徑。 下載完成後,請執行 Visual Studio 安裝程式來開始安裝。

  3. Visual Studio 開始安裝之後,您會看到幾秒鐘的初始化,後面接著功能選取選項。 首先,在 Visual Studio 2019 的功能清單中,選取 [.NET Desktop 開發] 和 [通用 Windows 平台開發 (適用於 HoloLens)] 核取方塊。 然後,進行必要的選取之後,按一下 [修改] 按鈕。

    Screenshot of how to select .NET Desktop development and Universal Windows Platform development (for HoloLens) in Visual Studio 2019.

  4. 按一下 [修改] 之後,Visual Studio 會繼續下載並安裝您指定的功能。 安裝完成時,系統會要求您「重新啟動」電腦。 接下來,啟動 Visual Studio,以確認安裝成功。

    Screenshot of testing the visual studio launcher.

StereoKit 的 Visual Studio 範本

StereoKit 的 Visual Studio 範本是啟動 StereoKit 專案的最快速方法。 根據預設,其已設定為正確地複製專案資產,並隨附一些基本程式碼,可讓您立即使用一些功能。

提供的範本有兩種:

  1. 通用 Windows 平台 - 適用於 HoloLens 2,也可以在 Windows 桌面上執行。 不過,UWP 的編譯速度可能會變慢,而且不再接收來自 .NET 小組的更新。

  2. .NET Core - 用於 Windows 和 Linux 上的桌面 XR。 其使用簡單、編譯快速,而且是大部分開發人員的最佳選項。

    Screenshot of downloaded stereoKit templates in Visual Studio.

  3. 原生 C++ 範本 (開發中):StereoKit 確實提供 C API,但有經驗的開發人員只在優點大於缺乏 C API 文件時,才應該選擇此選項。

注意

使用通用 Windows 平台時反覆項目的速度較慢,因此只有在 HoloLens 對您而言是必要時才使用通用 Windows 平台。 建置 ARM (而不是 ARM64) 可以節省一些時間,因為其可以略過 ARM64 所需的 .NET Native 建置。 您也可以略過範本,並將 NuGet 套件直接安裝至現有的專案。

下載並安裝 StereoKit 的 Visual Studio 範本

  1. StereoKit 範本下載 StereoKit 範本 - Visual Studio Marketplace

    Screenshot of StereoKit Templates - Visual Studio Marketplace.

  2. 開啟下載的檔案,然後按兩下 [ 安裝] 按鈕。

    Screenshot of VSIX installer dialogue box.

  3. 安裝完成後,按一下快顯項目中的 [關閉]

    Screenshot of VSIX installer close button.

啟用開發人員模式

在 HoloLens 2Windows 電腦啟用開發人員模式可讓您更輕鬆地測試應用程式。 這可讓您從 Windows 市集外部安裝 通用 Windows 平台 和 Windows 應用程式,這是應用程式開發人員在開發時想要在電腦上測試其應用程式的基本功能。

針對 HoloLens 2 啟用開發人員模式

  1. 開啟 HoloLens 2,並將其放入。 然後,使用開始手勢存取主功能表。

  2. 若要在環境中啟動應用程式,請選取 [設定] 圖格。

  3. 從功能表中選取 [更新及安全性] 選項。

     The screenshot of Update & Security menu item.

  4. 選取 [適用於開發人員] 功能表項目。

  5. 啟用 [使用開發人員功能],以將應用程式從 Visual Studio 部署至 HoloLens。 如果裝置執行 Windows Holographic 21H1 版或更新版本,則請啟用 [裝置探索]

  6. 選用:向下捲動並啟用裝置入口網站,可讓您從 Web 瀏覽器連接至 HoloLens Windows「裝置入口網站」

    Screenshot shows enabling the developer mode.

為 Windows 電腦啟用開發人員模式

如果您搭配使用 Windows 混合實境頭戴式裝置與電腦,則請在您的電腦上啟用開發人員模式。

  1. 前往功能表中的 [設定]

  2. 選取 [更新與安全性]

    Screenshot of Select Update and Security menu item.

  3. 接下來,選取 [適用於開發人員]

    Screenshot of Select For developers option.

  4. 啟用 [開發人員模式],並閱讀您所選設定的免責聲明,然後選取 [是] 來接受變更。

    Screenshot of On the toggle button to enable Developer Mode.

在此單元中,您已了解使用 StereoKit 開發混合實境應用程式的必要條件。 接下來,您將取得 StereoKit Ink 示範專案的概觀,作為一些 StereoKit 功能和能力的簡化範例。