Table of Contents

Migrar aplicações Unity do EasyAR Sense Unity Plugin 4.2 e versões anteriores

A partir da versão 4.3, o plugin Unity passou a ser distribuído e gerenciado pelo Unity Package Manager, e a estrutura do pacote do plugin foi ajustada significativamente. Portanto, ao atualizar da versão 4.2 ou anterior para 4.3 ou posterior, algumas etapas adicionais são necessárias.

Etapas de migração

Ao atualizar da versão 4.2 ou anterior, você precisa:

  1. Excluir todos os arquivos do plugin antigo. Esses arquivos podem existir nas pastas Assets/EasyAR, Assets/Plugins, Assets/Samples e Assets/StreamingAssets.
  2. Em seguida, importar a nova versão pela Package Manager window do Unity.
  3. Atualizar cenas e código de acordo com os guias de migração de cada versão abaixo.

Migrar para 4000 e versões posteriores

Migrar para 4000 e versões posteriores requer as seguintes alterações.

Consulte Criar e configurar AR session para recriar a estrutura da cena.

Alterações relacionadas:

  • prefab foi removido.
  • VIOCameraDeviceUnion foi removido.

Para usar AR Foundation, consulte Ativar AR Foundation em um projeto EasyAR.

Alterações relacionadas:

  • O suporte a AR Foundation foi reimplementado.

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

Alterações relacionadas:

  • Nreal/XREAL X e Nreal/XREAL Light não são mais suportados.
  • O suporte a XREAL está integrado ao EasyAR Sense e suporta XREAL Air2 Ultra.

Consulte Migrar para 4000 para as próximas etapas de migração.

A versão 4000 tem mais alterações em comparação com 4.x.

Migrar para a versão 4.6

Aviso

A versão 4.6 não é mais mantida. Recomenda-se atualizar diretamente para 4000 ou uma versão posterior. A documentação detalhada de desenvolvimento Unity no site da EasyAR é preparada para a versão 4000 e posteriores.

Migrar 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 da cena e recriar os componentes relacionados.

Alterações relacionadas:

  • prefab foi removido.
  • VIOCameraDeviceUnion foi removido.
  • O suporte a AR Foundation foi separado em um package independente.

Se AR Foundation não for necessário, você pode excluir o nó AR Foundation sob AR Session na cena e o uso de ARFoundationFrameSource no código.

Alterações relacionadas:

  • O suporte a AR Foundation foi separado em um package independente.

Se Nreal não for necessário, você pode excluir o nó Nreal sob AR Session na cena e o uso de NrealFrameSource no código. Ao usar Nreal, não é mais necessário criar um package virtual.

Alterações relacionadas:

  • O suporte a Nreal foi separado em um package independente.

Recomenda-se consultar a documentação de API nos scripts e os exemplos da versão 4.6 para entender as alterações de API e o modo de uso, fazendo os ajustes apropriados.

Alterações relacionadas:

  • Algumas outras APIs de script também mudaram.
  • Alguns métodos públicos estão marcados como internal nos comentários XML. Evite usar essas APIs. Elas foram removidas na versão 4000.

Migrar para a versão 4.4

Aviso

A versão 4.4 não é mais mantida. Recomenda-se atualizar diretamente para 4000 ou uma versão posterior. A documentação detalhada de desenvolvimento Unity no site da EasyAR é preparada para a versão 4000 e posteriores.

Ao migrar para a versão 4.4, preste atenção às seguintes alterações.

Remova tanto quanto possível as referências a prefabs dentro do pacote do plugin. Se continuar usando esses prefabs, logs de aviso serão exibidos, e esses logs contêm uma breve orientação sobre como substituí-los no novo plugin. Recomenda-se consultar os exemplos da versão 4.4 para entender a nova estrutura da cena.

Alterações relacionadas:

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

Remova o uso de VIOCameraDeviceUnion. Se continuar usando esse componente, logs de aviso serão exibidos, e esses logs contêm uma breve orientação sobre como substituí-lo no novo plugin. Recomenda-se consultar os exemplos da versão 4.4 para entender a nova estrutura da cena.

Alterações relacionadas:

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

Recomenda-se consultar a documentação de API nos scripts e os exemplos da versão 4.4 para entender as alterações de API e o modo de uso, fazendo os ajustes apropriados.

Alterações relacionadas:

  • Algumas outras APIs de script também mudaram.
  • Alguns métodos públicos estão marcados como internal nos comentários XML. Evite usar essas APIs. Elas foram removidas na versão 4000.