Partilhar via

Instalar o pacote do Remote Rendering para o Unity

  • Artigo

A Renderização Remota do Azure usa um pacote Unity para encapsular a integração no Unity. Este pacote contém toda a API C# e todos os binários de plug-in necessários para usar a Renderização Remota do Azure com Unity. Seguindo o esquema de nomenclatura do Unity para pacotes, o pacote é chamado com.microsoft.azure.remote-rendering.

O pacote não faz parte do repositório de amostras ARR e não está disponível no registro interno de pacotes do Unity. Você pode escolher uma das seguintes opções para instalar o pacote Unity.

Instalar o pacote de renderização remota usando a ferramenta de recurso de realidade mista

A Mixed Reality Feature Tool (download) integra pacotes de recursos de Realidade Mista em projetos Unity.

Para adicionar o pacote a um projeto, você precisa:

  1. Faça o download da ferramenta de recursos de realidade mista
  2. Siga as instruções completas sobre como usar a ferramenta.
  3. Na página Descobrir Recursos, marque a caixa para o pacote de Renderização Remota do Microsoft Azure em Serviços de Realidade Mista do Azure e selecione a versão do pacote que você deseja adicionar ao seu projeto
  4. Se você quiser usar o OpenXR, adicione também o pacote de plug-in OpenXR de realidade mista nos Serviços de Realidade Mista do Azure da mesma maneira.

Mixed_Reality_feature_tool_package

Para atualizar seu pacote local, basta selecionar uma versão mais recente da Mixed Reality Feature Tool e instalá-la. A atualização do pacote pode, ocasionalmente, levar a erros no console. Se você vir erros no console, tente fechar e reabrir o projeto.

Instalar o pacote de renderização remota manualmente

Para instalar o pacote de renderização remota manualmente, você precisa:

  1. Baixe o pacote do feed npm dos Pacotes de Realidade Mista em https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry.

    • Você pode usar npm e executar o seguinte comando para baixar o pacote para a pasta atual.

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

      Se você quiser usar o OpenXR, execute o seguinte comando para baixar o pacote de suporte da plataforma para a pasta atual.

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

    • Ou você pode usar o script PowerShell em Scripts/DownloadUnityPackages.ps1 a partir do repositório GitHub azure-remote-rendering.

      • Edite o conteúdo de Scripts/unity_sample_dependencies.json para

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

        Se você quiser usar o OpenXR, você também precisa do pacote de suporte da plataforma. Edite o conteúdo de Scripts/unity_sample_dependencies.json para

        {
  "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"
    }
  ]
}

      • Execute o seguinte comando no PowerShell para baixar o pacote para o diretório de destino fornecido.

        DownloadUnityPackages.ps1 -DownloadDestDir <destination directory>

  2. Instale o(s) pacote(s) baixado(s) com o Gerenciador de Pacotes do Unity.

Para atualizar um pacote local, basta repetir as respetivas etapas de download que você usou e reimportar o pacote. A atualização do pacote pode, ocasionalmente, levar a erros no console. Se você vir erros no console, tente fechar e reabrir o projeto.

Pipelines de renderização Unity

Os pipelines de renderização Unity suportados estão documentados neste artigo dedicado: Pipelines de renderização Unity

Próximos passos