Table of Contents

EasyAR Sense Unity Plugin Notas de versão

Estamos muito felizes em anunciar o lançamento do EasyAR Sense Unity Plugin 4000. Esta versão marca o EasyAR com uma API completa e suporte a dispositivos atualizado, além de novos lançamentos ocorrerem com mais frequência do que antes.

Baixe o EasyAR Sense Unity Plugin 4000 para aproveitar esses novos recursos e melhorias.

Versões anteriores

Versão 4002.0.0

Data de lançamento: 2026-05-18

  • 🐛 Corrigido o problema de falha no build do Android Unity 6.4.4.
  • 🔧 Ajustado parte do código de exemplo.
  • ⬆️ Atualizado o EasyAR Sense para 4.9.0

Versão 4001.0.0

Data de lançamento: 2026-03-10

  • 🐛 Corrigido problema numérico na conversão de pose de nativo para Unity. Este problema causava saltos de pose de curta duração ao usar o Mega em alguns dispositivos, resultando em cintilação ou tremor rápido do conteúdo. A correção deste problema também pode resolver outros problemas potenciais semelhantes.
  • 🔧 Ajustadas algumas interfaces do MegaTrackerFrameFilter para se adaptar às mudanças de interface do EasyAR Sense.
  • ⬆️ Atualizado o EasyAR Sense para 4.8.0

Versão 4000.0.1

Data de lançamento: 2025-11-14

  • 🐛 Correção: Resolvido a possível exceção de tempo de execução AndroidJavaException acionada em builds Android com minify habilitado, devido à falta de métodos estáticos (loadLibraries, setupActivity), o que impedia o EasyAR de ser executado.

Versão 4000.0.0

Data de lançamento: 2025-10-20

A partir desta versão, o EasyAR Sense Unity Plugin seguirá o controle de versão de pacotes (usando Semantic Versioning) exigido pelo Unity, portanto, o número da versão será diferente do EasyAR Sense e a frequência de lançamento também pode ser diferente. Esta versão do plugin contém a versão oficial do EasyAR Sense 4.7.0.

O EasyAR Sense Unity Plugin 4000.0.0 traz grandes mudanças, concentradas principalmente nestes aspectos:

  1. Mudanças na compatibilidade com Unity e AR Foundation

    A partir desta versão, o EasyAR Sense Unity Plugin suportará apenas Unity 2021.3 e versões mais recentes, e o suporte para Unity 6 também foi aprimorado. Além disso, o suporte para AR Foundation foi mesclado no pacote do plugin, e esta versão suportará apenas AR Foundation 5 e versões mais recentes, com seu uso bastante simplificado. Se os componentes do AR Foundation forem adicionados à cena, a configuração da cena e o código do script não precisam ser alterados, independentemente de o AR Foundation ser usado ou não após a execução.

  2. Suporte atualizado a head-mounted displays, com suporte adicionado para vários headsets OST/VST

    Após anos de refinamento com várias empresas da indústria, o suporte da EasyAR a headsets foi padronizado. Agora você pode implementar o suporte a dispositivos de headset de terceiros por meio de extensões do EasyAR Sense Unity Plugin (podendo ser necessário que o fabricante do headset forneça algumas interfaces de dados). Esta versão inclui suporte integrado para Apple Vision Pro e XREAL Air2 Ultra, além de suporte para Pico 4 Ultra Enterprise e Rokid AR Studio através do pacote de extensão EasyAR Sense Unity Plugin. Ao mesmo tempo, você também pode obter pacotes de extensão de suporte para outros dispositivos a partir de alguns parceiros da EasyAR (como Xrany 元霓).

  3. Aprimoramento das interfaces de componentes do Unity, otimização significativa do fluxo de trabalho do ARSession

    Esta versão é a primeira a encapsular completamente as funcionalidades do EasyAR Sense através de componentes do Unity. O ARSession foi amplamente otimizado e reescrito, agora você pode facilmente determinar o suporte do dispositivo ou funcionalidade, iniciar ou parar o ARSession conforme a situação para realizar a troca em tempo de execução do ARSession ou diferentes funcionalidades AR. Além disso, você pode usar o ARSessionFactory para criar ARSession e componentes relacionados em tempo de execução. Esta versão também adiciona funcionalidades de navegação inercial e câmera 3DoF, projetadas principalmente para o EasyAR Mega, mas que também podem ser usadas separadamente.

  4. Adição de várias ferramentas de desenvolvimento e diagnóstico

    Esta versão adiciona e fornece novas funcionalidades de gravação e reprodução de EIF, embora a gravação e reprodução de EIF já pudessem ser usadas em versões anteriores, o uso do EIF nunca foi tão simples. Agora você pode usar a ferramenta de diagnóstico Session Validaion Tool na Unity Editor para reproduzir eif diretamente e controlar sua cena, seja rastreamento de imagem, mapa espacial ou EasyAR Mega, você pode reproduzir o efeito de execução no dispositivo no computador. Agora você pode usar o painel de diagnóstico em tempo de execução EasyAR Diagnostics Panel no app para ativar facilmente a funcionalidade de gravação de eif, ou alternar a exibição de informações de estado chave do ARSession e seus componentes a qualquer momento. Além disso, os exemplos desta versão foram totalmente reescritos, executar o exemplo permite ver diretamente o estado do ARSession e o botão para gravar eif para facilitar o uso.

  5. Lançamento completo das ferramentas do EasyAR Mega

    Esta versão integra e lança o Mega Studio 2.12. Daqui em diante, as atualizações do plugin serão mais frequentes, as ferramentas Mega do lado Unity serão gradualmente mescladas dentro do plugin e lançadas junto com as atualizações regulares do plugin. Além das atualizações nas versões de pré-lançamento anteriores, esta versão habilitará o suporte de navegação inercial por padrão, expandindo ainda mais significativamente o suporte a dispositivos do EasyAR Mega. Esta versão também inclui suporte para a versão mais recente do serviço EasyAR Mega Landmark. O uso do EasyAR Mega pode ser solicitado através da página do site da EasyAR.

O conteúdo detalhado da atualização é o seguinte:

Compatibilidade do Unity e do AR Foundation:

  • 🔧 Unity: Suporte para Unity 2021.3 e versões mais recentes (incluindo Unity 2022.x/Unity 6.x)
    • 🔥 Remoção do suporte para Unity 2019/Unity 2020
    • 🔥 Remoção da detecção de versão gradle para Unity 2019
    • 🔥 Remoção da opção DisableARCoreAREngine para Unity 2019
  • ✨ Unity 6: Suporte completo para Unity 6
    • ✨ Suporte para URP 17+ e Render Graph
    • 🐛 Corrigido: Falha do ARCore devido a alterações no comportamento do ClassLoader no Unity 6
    • 🐛 Corrigido: Falha na renderização da câmera quando o Render Scale não é 1
    • 🐛 BUG próprio do Unity 6: Artefatos visuais podem ser observados em dispositivos iOS/Mac. Ocorre apenas quando é necessário obter texturas da câmera. Adicionamos medidas de mitigação parciais, mas não é possível eliminá-los completamente. Reportado à Unity, consulte Unity Issue UUM-87787. No Unity 6.2 ou superior, esse problema pode ser evitado definindo o Render Scale no Universal Render Pipeline Asset para um valor fora do intervalo 0.96-1.05.
    • 🐛 BUG próprio do Unity 6: Renderização anormal no Windows DX11. Adicionamos mitigações no Unity 6.0-6.1. Verificamos que o problema foi corrigido no Unity 6.2.
  • ✨ AR Foundation: Suporte para AR Foundation 5 e versões mais recentes, simplificando significativamente o uso
    • ✨ O suporte ao AR Foundation foi integrado ao pacote do plugin, não sendo mais necessário importar um pacote separado (necessidades específicas podem desativá-lo via opção de configuração)
    • ✨ Suporte à reutilização do Unity.XR.CoreUtils.XROrigin como origem da ARSession e à reutilização da Camera do XROrigin
    • ✨ Adição da opção de configuração Unity XR Auto Switch, que manipula automaticamente a alternância de objetos do Unity XR (incluindo AR Foundation) por padrão
    • ✨ As ARSessions criadas pelo menu EasyAR incluem e ativam automaticamente o suporte ao AR Foundation por padrão
    • ✨ A maioria dos samples adicionaram suporte ao AR Foundation (o próprio AR Foundation precisa ser importado manualmente e configurado corretamente)
    • 🔧 O ARCore e o ARKit podem ser controlados individualmente, incluindo a definição de prioridade entre o ARCore/ARKit interno do EasyAR e o ARCore/ARKit do AR Foundation
    • 🔥 Remoção do suporte para AR Foundation 4
    • 🔥 Remoção do suporte para ARSessionOrigin, mantendo apenas o XROrigin
    • 🔥 Remoção do proxy para executar o fluxo de instalação do ARCore via AR Foundation
  • ✨ Compatibilidade total com o Input System Package

Suporte de headset atualizado, com suporte adicionado para múltiplos headsets OST/VST:

  • 🚀 A interface do dispositivo head-mounted display está estável, suportando integração de terceiros
    • ✨ Suporte para integração de dispositivos de terceiros (requer que o fabricante forneça interface de dados específica)
    • ✨ Suporte para XROrigin e XR Interaction Toolkit
    • ✨ Amostras de todos os headsets simplificadas e unificadas, zero código, e com suporte para alternância de funcionalidades
    • ✨ Suporte para entrada de câmera olho-de-peixe
    • ✨ Suporte para entrada de dados 3DOF de câmera personalizada
    • ✨ Adicionar funcionalidade de menu: Extensions, integrando todos os itens de menu de extensão
    • 🐛 Correção de anomalias de renderização em alguns headsets ao executar DenseSpatialMap
    • 🔥 Remoção de amostras antigas como ActionOne e BT350
  • ✨ Suporte integrado para Apple Vision Pro
    • ✨ Suporte para Metal, RealityKit e modo Hybrid
    • ✨ Suporte para visionOS >= 2.0, suporte para visionOS 26
  • ✨ Suporte integrado para XREAL Air2 Ultra (requer XREAL SDK >= 3.1)
    • ✨ Não é mais necessário importar pacotes de suporte separados
    • ⚡ Otimização do desempenho no XREAL
    • 🔥 Remoção do suporte para XREAL Light
  • ✨ Distribuição de suporte para outros dispositivos como Pico e Rokid via EasyAR Sense Unity Plugin extension
    • ✨ Fornecimento de modelo de referência para integração de dispositivos de terceiros: com.easyar.sense.ext.hmdtemplate
    • ✨ Suporte para Pico 4 Ultra Enterprise (requer PICO Unity Integration SDK >= 3.1)
    • ✨ Suporte para Rokid AR Studio (requer Rokid Unity OpenXR Plugin >= 3.0.3)
    • ✨ Essas extensões suportarão múltiplas versões futuras do EasyAR Sense Unity Plugin
  • ✨ Suporte para EasyAR XR License
    • 🔧 O uso do EasyAR em headsets requer EasyAR XR License e conexão inicial à internet (uso experimental requer conexão à internet a cada uso)

Aprimorar a interface de componentes do Unity, otimizar significativamente o fluxo de trabalho do ARSession:

  • 🚀 Aprimorar a camada de encapsulamento de componentes do Unity
    • ✨ Aprimorar os componentes de cena, fornecendo todos os recursos do EasyAR Sense
    • 🔥 Remover todas as interfaces da camada EasyAR Sense encapsuladas por componentes
    • 🔥 Remover todas as interfaces internas
  • ✨ ARSession: Reescrever e otimizar significativamente o fluxo de trabalho
    • ✨ Suporte para iniciar e parar a sessão a qualquer momento
    • ✨ Suporte para controle automático de inicialização da sessão
    • ✨ Suporte para alternar funções da sessão e fontes de entrada sem tela preta
    • ✨ Simplificar a verificação de suporte do dispositivo, fornecida por uma interface consistente
    • ✨ Atualizar a lista de suporte de dispositivos para MotionTracker, ARCore e AR Engine durante a inicialização
    • ✨ Suporte para reinício automático da sessão após atualização da lista de dispositivos
    • ✨ Suporte para obter informações detalhadas sobre corrupção da sessão
    • ✨ Adicionar auto-verificação do estado interno da sessão
    • 🔥 Remover ARComponentPicker, sua funcionalidade é substituída por outros fluxos de sessão
    • 🔥 Proibir a execução simultânea de múltiplos ARSessions
  • ✨ ARSessionFactory: Fornecer funcionalidade para criar ARSession e componentes relacionados em tempo de execução
    • ✨ Suporte para criar sessões idênticas às do menu do editor em tempo de execução via ARSessionFactory
    • ✨ Adicionar funcionalidade de ordenação de Frame Source (incluindo item de menu)
  • ✨ FrameSource: Adicionar suporte a inercial e 3DoF
    • ✨ Adicionar InertialCameraDeviceFrameSource para suportar navegação inercial
    • ✨ Adicionar ThreeDofCameraDeviceFrameSource para suportar câmera com 3DoF
    • ✨ Adicionar funcionalidade de menu: Frame Source by Transform Type, fornecendo uma lista de todas as FrameSources internas
    • ⚡ Otimizar opções do Inspector
  • ✨ Outros ajustes de interface e atualizações de funcionalidade
    • ✨ Adicionar funcionalidade para criar ImageTarget usando Texture2D
    • ✨ Adicionar ImageMaterial para renderizar dados do tipo Image (imagem da câmera, imagem de Target, etc.)
    • ✨ Adicionar ActiveController para controlar o estado active de GameObject, unificando a lógica de controle relacionada
    • ✨ Adicionar funcionalidade para simular rotação de tela em desktop
    • ✨ Adicionar XROriginChildController, controlando o comportamento de objetos sob a origem da Session
    • 🔥 Remover WorldRootController
    • 🔧 Dividir a interface do mapa esparso em dois componentes funcionais distintos: Builder e Tracker
    • 🔧 Ajustar EasyARController, fornecendo funcionalidades estáticas de nível aplicativo/sistema
    • 🔧 Unificar a interface de componentes Target
    • 🔧 Unificar a interface de acesso a dados de serviço

Adicionar múltiplas ferramentas de desenvolvimento e diagnóstico:

  • 🚀 Adicionar ferramenta de diagnóstico durante edição: Session Validation Tool
    • ✨ Simplificar a reprodução de eif em qualquer cenário
    • ✨ Suporte para controlar o fluxo de reprodução eif
    • ✨ Suporte para controlar o fluxo da sessão
  • 🚀 Adicionar painel de diagnóstico em tempo de execução: EasyAR Diagnostics Panel
    • ✨ Adicionar interruptor Developer Mode, por padrão clique 8 vezes na tela para ativar/desativar o Diagnostics Panel, simplificando gravação eif em app online e feedback de problemas
    • ✨ Suporte para interruptor Developer Mode personalizado, usar interação personalizada para ativar/desativar o Diagnostics Panel
    • ✨ Suporte para controlar gravação eif
    • ✨ Suporte para controlar exibição de informações da sessão
    • ✨ Suporte para controlar gravação eed
  • ✨ Adicionar funcionalidade totalmente nova de gravação e reprodução EIF
    • ✨ FrameRecorder será montado automaticamente no ARSession, não exigindo mais seleção manual
    • ✨ FrameRecorder gerará nome de arquivo automaticamente por padrão para suportar uso sem scripts
    • ✨ FramePlayer com dados gravados em novo formato suporta salto na reprodução e ajuste de velocidade, com redução no tamanho do arquivo
    • 🔧 Suporte para usar eif no computador para dirigir cenas e funções AR (não é nova funcionalidade)
  • ✨ Adicionar DiagnosticsController, unificando e otimizando funcionalidades de diagnóstico
    • ✨ Adicionar exibição hierárquica e controle de informações; por padrão, todas as mensagens de erro e aviso são exibidas via UI
    • ✨ Adicionar funcionalidade para exibir informações-chave de estado do ARSession e seus componentes; por padrão, exibidas via UI e atualizadas a cada frame
    • 🔧 Usar recursos de diagnóstico para simplificar a obtenção de informações para feedback de problemas
    • 🔥 Remover GUIPopup
  • 🔧 Otimizar comportamento de estado anômalo e exibição de mensagens de erro
    • 🔧 Otimizar mensagem de erro quando não há frame source disponível
    • 🔧 Em ambiente URP, ao usar EasyAR em vez de AR Foundation ou headset para renderizar imagem da câmera, configuração incorreta de RendererFeature causará erro e interromperá a execução do ARSession
    • 🔧 Modificar estratégia de controle Active padrão do Origin; ao perder rastreamento, conteúdo fixa na tela em vez de desaparecer
    • 🔧 Ao usar produto de avaliação em câmera personalizada ou headset, ao atingir tempo limite, todo conteúdo será ocultado para evitar mal-entendidos sobre o efeito
  • 🔧 Otimizar conteúdo e opções da página de configuração
    • ✨ Suporte para selecionar variantes da biblioteca EasyAR Sense
    • 🔒 Na seção de permissões do aplicativo, exceto permissão de câmera, demais permissões não são mais alteráveis, determinadas pela variante da biblioteca EasyAR Sense e pela ativação do Mega
    • 🔧 Configuração de funcionalidades e servidores agrupadas por funcionalidade EasyAR
    • 🔧 Gerenciamento centralizado de configuração de SDKs AR de terceiros
    • 🔧 Gerenciamento centralizado de configurações de Workaround para Unity

Ferramenta EasyAR Mega totalmente pública:

  • 🚀 Totalmente pública, atualizações sincronizadas
    • ✨ Integrada versão Mega Studio 2.12
    • 🔧 Ferramentas Mega do lado Unity serão gradualmente incorporadas ao plug-in. Futuramente, apenas pacotes integrados da versão mais recente serão fornecidos, mas lançados em conjunto com atualizações regulares do EasyAR Sense Unity Plugin
    • 🔧 EasyAR Mega ainda requer aplicação e aprovação através da página do site EasyAR para uso
  • ✨ Novo suporte para EasyAR Mega Landmark
  • ✨ Novo suporte para inercial 5DOF ativado por padrão, expandindo significativamente a compatibilidade de dispositivos do EasyAR Mega
  • ✨ Novo suporte para acesso aos serviços Mega usando API Token
  • 🔧 Otimização do efeito Mega e experiência de desenvolvimento (incluído em versões anteriores 4.7.x)
    • ✨ Suporte para modo de rotação pura 3DOF e modo 0DOF (não ativados por padrão)
    • ✨ Adicionado EditorCameraDeviceFrameSource para diagnóstico no editor, evitando execução incorreta no celular devido à cópia incompleta de amostras
    • ✨ Ao usar Mega para gravar dados eif de versões antigas, o FrameRecorder gerará automaticamente um arquivo .eif.json
    • 🔧 LocationInputMode substitui opções de degradação para depuração remota
    • 🔧 Modo sem rastreamento dividido em componente independente, geralmente não é mais necessário usar ou prestar atenção
    • 🔧 Adicionada opção BlockRootSource, configuração padrão reportará erro se BlockRoot não for definido
    • 🔧 Comportamento padrão ajustado ao localizar múltiplos blocos, garantindo que múltiplos blocos não sejam usados por padrão
    • 🔧 Ajustes na nomenclatura de algumas interfaces
    • 🔧 Exceção mais clara lançada quando a Session inclui Mega mas não pode ser usada
    • 🔧 Ajustado o QualityLevel mínimo suportado para MotionTracker com Mega para Limited
    • 🐛 Corrigido erro de execução causado por escape incorreto do estado CloudLocalizerStatus.WakingUp
    • 🔧 Algumas otimizações e modificações podem ser vistas no changelog do EasyAR Sense

Amostras de reescrita e otimização:

  • ✨ Reescrever todas as amostras
    • ✨ Compatível com diferentes configurações do Input System
    • ✨ Compatível com URP17+
    • ✨ Compatível com o uso do AR Foundation
    • 🔧 Compatível sem o uso do AR Foundation
    • 🔧 Reteve alguns samples sem suporte a AR Foundation
    • ⚡ Otimização de scripts e chamadas de interface
    • 🚚 Algumas amostras foram renomeadas
    • 🔧 Substituição de recursos como modelos e vídeos nas amostras
    • ⚡ Redução do uso de streaming assets, importando apenas em amostras que demonstram funcionalidades específicas
    • ✨ Uso de Texture2D para criar ImageTarget
  • ✨ Adição de demonstrações de novas funcionalidades e interfaces
    • ✨ Adicionada amostra Workflow_ARSession, para aprender o fluxo básico de sessão e suporte a dispositivos
    • ✨ Adicionada amostra Workflow_FrameSource_ExternalImageStream, usando vídeo como câmera personalizada (não para headsets)
    • ✨ Adicionada amostra Combination_BasedOn_MotionTracking, para aprender o uso, alternância de várias funcionalidades e alternância do AR Foundation quando o rastreamento de movimento está disponível
    • ✨ Adicionada amostra Combination_BasedOn_AppleVisionPro, para demonstrar o uso e alternância de várias funcionalidades no Apple Vision Pro
    • ✨ Adicionada amostra Combination_BasedOn_Xreal, para demonstrar o uso e alternância de várias funcionalidades em dispositivos XREAL
    • ✨ Adicionados vários Mega samples (incluídos nas versões 4.7.x atualizadas anteriormente)
    • ✨ Adicionada funcionalidade de alternar tamanho da câmera e modo de tocha na amostra Workflow_FrameSource_CameraDevice
    • 🔥 Removidos samples individuais de AR Foundation, suas funcionalidades estão incluídas em outros samples
    • 🔥 Removida amostra FrameRecording, sua funcionalidade está incluída em outros samples
    • 🔥 Removida amostra MotionTracking_Fusion, sua funcionalidade está incluída em Combination_BasedOn_MotionTracking
    • 🔥 Removida amostra SurfaceTracking_ImageTarget, combinações de funcionalidades ainda podem facilmente alcançar o mesmo resultado
    • 🔥 Removida amostra Camera_CustomCamera, pode ser implementada conforme necessário
    • 🔥 Removidos samples antigos de óculos como ActionOne e BT350
  • ✨ Simplificação do uso de gravação e reprodução eif
    • ✨ Todos os samples receberam botão de gravação eif, arquivos gravados podem ser usados no editor
  • ✨ Reescrita do launcher, adição de descrição das amostras
    • 🐛 Correção do problema de cenas de amostra carregadas via launcher ficarem muito escuras

Integração de recursos AR do EasyAR e de terceiros:

  • ⬆️ Atualização do EasyAR Sense para a versão 4.7.0 final
  • ⬆️ Atualização do EasyAR AR Engine Interop
  • ⬆️ Atualização do ARCore SDK para 1.46.0
  • 🔧 Desativação do AR Engine em alguns telefones onde ele não pode ser executado adequadamente
  • 🐛 Correção de falha do ARCore no Unity 6 causada por mudança no comportamento do ClassLoader

Tópicos relacionados