Table of Contents

Migrando aplicativos unity do easyar sense unity plugin 4.2 e versões mais antigas

A partir da versão 4.3, o plugin Unity passou a ser distribuído e gerenciado através do unity package manager, com uma reestruturação significativa do pacote. Portanto, ao atualizar da versão 4.2 ou inferior para a 4.3 ou superior, são necessárias etapas adicionais.

Etapas de migração

Ao atualizar da versão 4.2 ou inferior, é necessário:

  1. Excluir todos os arquivos do plugin antigo, que podem estar presentes nas pastas Assets/EasyAR, Assets/Plugins, Assets/Samples e Assets/StreamingAssets.
  2. Em seguida, importar a nova versão através do package manager window do Unity.
  3. Atualizar cenas e códigos conforme os guias de migração específicos de cada versão abaixo.

Migrando para a versão 4000 e posteriores

A migração para a versão 4000 e posteriores requer as seguintes alterações.

Consulte criando e configurando uma sessão ar para recriar a estrutura da cena.

Alterações relevantes:

  • prefabs foram removidos.
  • VIOCameraDeviceUnion foi removido.

O uso do AR Foundation requer consulta a habilitando ar foundation em projetos easyar.

Alterações relevantes:

  • O suporte ao AR Foundation foi reimplementado.

Você não pode usar o EasyAR em dispositivos XREAL X e XREAL Light; recomenda-se migrar para o XREAL Air2 Ultra.

Alterações relevantes:

  • Nreal/XREAL X e Nreal/XREAL Light não são mais suportados.
  • O suporte ao XREAL está integrado ao EasyAR Sense, compatível com XREAL Air2 Ultra.

Consulte migrando para a 4000 para prosseguir com o trabalho de migração.

A versão 4000 traz mais mudanças em relação à 4.x.

Migrando para a versão 4.6

Aviso

A versão 4.6 não é mais mantida; recomenda-se atualizar diretamente para a 4000 ou superior. A documentação detalhada de desenvolvimento Unity no site do EasyAR é destinada à versão 4000 e posteriores.

A migração para a versão 4.6 requer as seguintes alterações.

Recomenda-se consultar os exemplos da versão 4.6 para entender a nova estrutura de cena e recriar os componentes relevantes.

Alterações relevantes:

  • prefabs foram removidos.
  • VIOCameraDeviceUnion foi removido.
  • O suporte ao AR Foundation foi separado em um pacote independente.

Se não for necessário usar AR Foundation, exclua o nó AR Foundation sob a AR Session na cena e o uso de ARFoundationFrameSource no código.

Alterações relevantes:

  • O suporte ao AR Foundation foi separado em um pacote independente.

Se não for necessário usar Nreal, exclua o nó Nreal sob a AR Session na cena e o uso de NrealFrameSource no código. O uso do Nreal não requer mais a criação de pacotes virtuais.

Alterações relevantes:

  • O suporte ao Nreal foi separado em um pacote independente.

Recomenda-se consultar a documentação da interface nos scripts e os exemplos da versão 4.6 para entender as mudanças e ajustar conforme necessário.

Alterações relevantes:

  • Algumas outras interfaces de script também foram alteradas.
  • Alguns métodos públicos estão marcados como internal nos comentários XML; evite usá-los, pois foram removidos na versão 4000.

Migrando para a versão 4.4

Aviso

A versão 4.4 não é mais mantida; recomenda-se atualizar diretamente para a 4000 ou superior. A documentação detalhada de desenvolvimento Unity no site do EasyAR é destinada à versão 4000 e posteriores.

A migração para a versão 4.4 requer atenção às seguintes alterações.

É necessário remover referências a prefabs dentro do pacote de plugin sempre que possível. O uso contínuo desses prefabs gerará logs de aviso com orientações breves sobre alternativas no novo plugin. Recomenda-se consultar os exemplos da versão 4.4 para entender a nova estrutura de cena.

Alterações relevantes:

  • Prefabs foram marcados como obsoletos e removidos na versão 4.6.

Remova o uso de VIOCameraDeviceUnion. O uso contínuo deste componente gerará logs de aviso com orientações sobre alternativas. Consulte os exemplos da versão 4.4 para a nova estrutura de cena.

Alterações relevantes:

  • VIOCameraDeviceUnion foi marcado como obsoleto e removido na versão 4.6.

Recomenda-se consultar a documentação da interface nos scripts e os exemplos da versão 4.4 para entender as mudanças e ajustar conforme necessário.

Alterações relevantes:

  • Algumas outras interfaces de script também foram alteradas.
  • Alguns métodos públicos estão marcados como internal nos comentários XML; evite usá-los, pois foram removidos na versão 4000.