Como usar a Ferramenta de Recursos de Realidade Misturada para instalar o World Locking Tools
A Ferramenta de Recursos de MR
A Ferramenta de Recursos de Realidade Misturada pode ser uma maneira extremamente útil de obter o World Locking Tools, bem como outros pacotes importantes de Realidade Misturada para Unity.
Mais informações sobre a Ferramenta de Recursos de MR podem ser encontradas na documentação online, mas ela é extremamente fácil de usar.
Como instalar o WLT por meio da Ferramenta de Recursos de MR
Para obter a funcionalidade completa do WLT, basta selecionar a versão mais recente do "World Locking Tools" na Ferramenta de Recursos de MR. Em seguida, vá para adicionar WLT a uma cena ou o guia de início rápido.
Se você estiver recebendo os exemplos (o que também requer o MRTK), não será necessário instalar as dependências primeiro. Basta selecionar o pacote de Exemplos e o conjunto mínimo de dependências necessárias também será instalado. Mas consulte abaixo.
Observação
Versão de TL;DR – Se você estiver instalando na Ferramenta de Recursos de MR, deverá instalar em uma pasta cujo caminho tenha 11 caracteres ou menos, incluindo a unidade. Isso é explicado mais detalhadamente no fim deste artigo. Portanto, e:\stuff\T1 funcionará, mas e:\stuff\T12 não.
Exemplos na Ferramenta de Recursos de MR (pacotes graváveis)
Conforme mencionado acima, a Ferramenta de Recursos de MR e os pacotes de instalação do UPM são recursos somente leitura. No caso dos exemplos, isso é inoportuno, pois os exemplos são importantes principalmente porque fornecem ativos voláteis que podem ser modificados para experimentação.
Para habilitar essa funcionalidade, os exemplos instalados pela Ferramenta de Recursos de MR (ou pelo UPM) seguem um caminho ligeiramente diferente. A instalação é um processo de duas partes.
A primeira parte prossegue tal como a instalação dos pacotes somente leitura. No entanto, após essa instalação, os exemplos ainda não serão exibidos em Ativos ou Pacotes.
Para concluir a importação dos exemplos para o projeto:
Abra o Gerenciador de Pacotes do Unity
Se o Gerenciador de Pacotes estiver definido como "Registro do Unity", altere-o para "Em Project"
Encontre os Exemplos desejados para concluir a instalação. Aqui, estamos direcionando o "World Locking Samples v1.2.4".
Clique no botão "Importar para o projeto".
Agora os exemplos serão exibidos na pasta Exemplos em Ativos, conforme mostrado aqui. Eles podem ser realocados para se adequarem à organização do projeto.
Diferenças entre os métodos de instalação
Há algumas considerações sutis ao decidir qual método de instalação usar.
Ferramenta de Recursos de MR (pacotes do UPM)
Um driver importante para a Ferramenta de Recursos de MR são as dependências de pacote. Um pacote na Ferramenta de Recursos de MR pode especificar outros pacotes que precisam ser instalados para que ele funcione corretamente. A Ferramenta de Recursos pode adquirir e instalar não apenas o pacote que você está solicitando, como também todas as suas dependências. Depois que a Ferramenta de Recursos tiver processado a instalação solicitada, não será necessário rastrear outras instalações.
A maior diferença entre os recursos adquiridos por meio da Ferramenta de Recursos de MR (ou do UPM) e os recursos adquiridos de arquivos .unitypackage é que os primeiros são instalados como somente gravação, enquanto os últimos são inseridos como seus próprios recursos.
Observe que, ao adquirir o WLT por meio da Ferramenta de Recursos, a DLL do Mecanismo de Mundo Congelado é trazida como uma dependência. A instalação manual por meio do NuGet não é necessária.
Versões do WLT (arquivos .unitypackage)
O WLT publica versões periódicas que são consideradas instantâneos muito estáveis. Elas estão disponíveis na página Versões do World Locking Tools.
Conforme mencionado acima, o resultado da importação desses arquivos .unitypackage para o projeto é o mesmo como se você tivesse copiado na origem (veja abaixo). Os scripts e os ativos são graváveis e podem ser reorganizados para se ajustarem à estrutura.
A cadeia de dependências é muito simples, mas é de responsabilidade do cliente de instalação (você) instalar as dependências, bem como o pacote desejado.
O grafo de dependência simples é linear. Na lista a seguir, cada item depende de cada item acima dele, mas de nenhum item abaixo dele:
- DLL do Mecanismo de Mundo Congelado (no NuGet, confira instruções de instalação)
- Mecanismo do Núcleo de Bloqueio de Mundo
- World Locking Tools
- Exemplos de Bloqueio de Mundo (também depende do MRTK, mas o MRTK está incluído no .unitypackage)
No código do GitHub (copiar na origem)
Outra opção para adquirir o WLT é obter a origem diretamente no GitHub (por meio do Git ou como um arquivo zip) e copiá-la no projeto. Isso é equivalente à instalação no .unitypackages acima.
Para obter a origem correspondente a uma versão, encontre o branch apropriado. Por exemplo, a origem da versão v1.2.4 está no branch release/v1.2.4.
Sobre o limite de tamanho do caminho de instalação
Ao instalar na Ferramenta de Recursos de Realidade Misturada
O Windows impõe um tamanho máximo de caminho de 260 caracteres. O pacote do Mecanismo de Mundo Congelado tem alguns caminhos internos muito longos. A Ferramenta de Recursos de Realidade Misturada (ou o UPM do Unity, dependendo de quem você deseja responsabilizar), adiciona algumas cadeias de caracteres muito longas no meio.
Você saberá se passou do limite MAX_PATH, se observar erros no Console do Unity indicando que não foi possível encontrar parte de um caminho.
Novamente, o caminho de instalação e:\stuff\T1 funcionará, mas e:\stuff\T12 será muito longo.
Embora o primeiro arquivo a atingir o limite nem seja usado no Windows, ele é para o build do iOS (o iOS não tem o limite MAX_PATH). O WLT será compilado e executado corretamente sem ele. No entanto, a existência do arquivo interferirá na execução de alguns scripts importantes do MRTK e provavelmente desestabilizará o Unity de outras maneiras sutis.
Ao instalar nos arquivos .unitypackage ou no GitHub
Fica um pouco mais tranquilo de o UPM/MRFeatureTool não inserir caracteres nos caminhos de instalação. No entanto, a hierarquia do caminho interno no Mecanismo de Mundo Congelado ainda é bastante complexa. Ao instalar nos arquivos unitypackage ou no GitHub, a pasta de instalação deve ter cerca de 100 caracteres ou menos.
Há mais investigações e discussões sobre esse problema do WLT.