Unity용 Remote Rendering 패키지 설치

  • 아티클

Azure Remote Rendering은 Unity 패키지를 사용하여 통합을 Unity로 캡슐화합니다. 이 패키지에는 Unity와 함께 Azure Remote Rendering을 사용하는 데 필요한 전체 C# API 및 모든 플러그 인 이진 파일이 포함되어 있습니다. 패키지에 대한 Unity 이름 지정 체계에 따라 패키지를 com.microsoft.azure.remote-rendering이라고 합니다.

패키지는 ARR 샘플 리포지토리의 일부가 아니며 Unity의 내부 패키지 레지스트리에서 사용할 수 없습니다. 다음 옵션 중 하나를 선택하여 Unity 패키지를 설치할 수 있습니다.

Mixed Reality 기능 도구를 사용하여 Remote Rendering 패키지 설치

Mixed Reality 기능 도구(다운로드)는 Mixed Reality 기능 패키지를 Unity 프로젝트에 통합합니다.

프로젝트에 패키지를 추가하려면 다음을 수행해야 합니다.

  1. Mixed Reality Feature Tool 다운로드
  2. 도구를 사용하는 방법에 대한 전체 지침을 따르세요.
  3. 기능 검색 페이지에서 Azure Mixed Reality 서비스 아래의 Microsoft Azure Remote Rendering 패키지 상자를 선택하고 프로젝트에 추가할 패키지 버전을 선택합니다.
  4. OpenXR을 사용하려면 동일한 방식으로 Azure Mixed Reality 서비스 아래에 Mixed Reality OpenXR 플러그 인 패키지도 추가합니다.

Mixed_Reality_feature_tool_package

로컬 패키지를 업데이트하려면 Mixed Reality 기능 도구에서 최신 버전을 선택하고 설치하기만 하면 됩니다. 패키지를 업데이트하면 경우에 따라 콘솔 오류가 발생할 수 있습니다. 콘솔에 오류가 표시되면 프로젝트를 닫았다가 다시 열어 보세요.

수동으로 Remote Rendering 패키지 설치

Remote Rendering 패키지를 수동으로 설치하려면 다음을 수행해야 합니다.

  1. https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry에 있는 Mixed Reality 패키지 npm 피드에서 패키지를 다운로드합니다.

    • 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 리포지토리에서 Scripts/DownloadUnityPackages.ps1에 있는 PowerShell 스크립트를 사용할 수 있습니다.

      • 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 렌터링 파이프라인에 설명되어 있습니다.

다음 단계