共用方式為


安裝適用于 Unity 的遠端轉譯套件

Azure 遠端轉譯會使用 Unity 套件將整合封裝至 Unity。 此套件包含整個 C# API,以及搭配 Unity 使用 Azure 遠端轉譯所需的所有外掛程式二進位檔。 在 Unity 的套件命名配置之後,套件稱為 com.microsoft.azure.remote-rendering

套件不是 ARR 範例存放庫 一部分,且無法從 Unity 的內部套件登錄取得。 您可以選擇下列其中一個選項來安裝 Unity 套件。

使用混合實境功能工具安裝遠端轉譯套件

混合實境功能工具 下載 ) 會將混合實境功能套件整合到 Unity 專案中。

若要將套件新增至專案,您需要:

  1. 下載混合實境功能工具
  2. 請遵循有關如何使用此工具的完整指示
  3. 在 [ 探索功能] 頁面上,勾選 Azure Mixed Reality Services 底下的 Microsoft Azure 遠端轉譯 套件方塊 ,然後選取您想要新增至專案的套件版本
  4. 如果您想要使用 OpenXR,也以相同方式在 Azure Mixed Reality Services 新增 混合實境 OpenXR 外掛程式 套件。

Mixed_Reality_feature_tool_package

若要更新本機套件,只要從混合實境功能工具選取較新版本並加以安裝。 更新套件偶爾可能會導致主控台錯誤。 如果您在主控台中看到錯誤,請嘗試關閉並重新開啟專案。

手動安裝遠端轉譯套件

若要手動安裝遠端轉譯套件,您需要:

  1. 從 的混合實境套件 npm 摘要 https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry 下載套件。

    • 您可以使用 npm 並執行下列命令,將套件下載到目前的資料夾。

      npm pack com.microsoft.azure.remote-rendering --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry
      

      如果您想要使用 OpenXR,請執行下列命令,將平臺支援套件下載至目前的資料夾。

      npm pack com.microsoft.mixedreality.openxr --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry
      
    • 或者,您可以從 azure-remote-rendering GitHub 存放庫 使用 PowerShell 腳本。 Scripts/DownloadUnityPackages.ps1

      • 編輯 的內容 Scripts/unity_sample_dependencies.json

        {
          "packages": [
            {
              "name": "com.microsoft.azure.remote-rendering", 
              "version": "latest", 
              "registry": "https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry"
            }
          ]
        }
        

        如果您想要使用 OpenXR,您也需要平臺支援套件。 編輯 的內容 Scripts/unity_sample_dependencies.json

        {
          "packages": [
            {
              "name": "com.microsoft.azure.remote-rendering", 
              "version": "latest", 
              "registry": "https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry"
            },
            {
              "name": "com.microsoft.mixedreality.openxr", 
              "version": "latest", 
              "registry": "https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry"
            }
          ]
        }
        
      • 在 PowerShell 中執行下列命令,將套件下載至提供的目的地目錄。

        DownloadUnityPackages.ps1 -DownloadDestDir <destination directory>
        
  2. 使用 Unity 的封裝管理員安裝下載的套件。

若要更新本機套件,只要重複您使用的個別下載步驟並重新匯入套件即可。 更新套件偶爾可能會導致主控台錯誤。 如果您在主控台中看到錯誤,請嘗試關閉並重新開啟專案。

Unity 轉譯管線

支援的 Unity 轉譯管線記載于此專用文章: Unity 轉譯管線

下一步