Table of Contents

Notas de lançamento do EasyAR Sense Unity Plugin

Temos o prazer de 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, enquanto novos lançamentos serão mais frequentes do que antes.

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

Versões anteriores

Versão 4001.0.0

Data de lançamento: 2026-03-10

  • 🐛 Corrigido um problema numérico na conversão de pose de nativo para Unity. Esse problema poderia causar saltos de pose de curta duração ao usar o Mega em alguns dispositivos, levando a cintilações ou tremores rápidos do conteúdo. Esta correção pode resolver outros problemas potenciais semelhantes.
  • 🔧 Ajustadas algumas interfaces do MegaTrackerFrameFilter para adaptar-se às mudanças na 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 um possível AndroidJavaException em tempo de execução em builds Android com minificação ativada, causado pela ausência de métodos estáticos (loadLibraries, setupActivity), o que impedia o funcionamento do EasyAR.

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 pela Unity. Portanto, o número de versão diferirá do EasyAR Sense, e a frequência de lançamentos também poderá ser diferente. Esta versão do plugin inclui o EasyAR Sense 4.7.0 final.

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

  1. 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, com suporte ao Unity 6 já implementado. Além disso, o suporte ao AR Foundation foi integrado ao pacote do plugin. Esta versão suportará apenas AR Foundation 5 e superior, com seu uso bastante simplificado. Se componentes do AR Foundation forem adicionados à cena, a configuração da cena e o código de script podem permanecer inalterados, independentemente de o AR Foundation ser usado ou não após a execução.

  2. Suporte atualizado para headsets, incluindo novos suportes para vários headsets OST/VST

    Após anos de refinamento com várias empresas do setor, o suporte do EasyAR a headsets foi padronizado. Agora você pode estender o suporte a headsets de terceiros através do EasyAR Sense Unity Plugin (pode exigir interfaces de dados do fabricante do headset). Esta versão inclui suporte nativo para Apple Vision Pro e XREAL Air2 Ultra, e através de pacotes de extensão do plugin, suporte para Pico 4 Ultra Enterprise e Rokid AR Studio. Você também pode obter pacotes de extensão para outros dispositivos de alguns parceiros do EasyAR (por exemplo, Xrany 元霓).

  3. Interfaces de componentes Unity aprimoradas, fluxo de trabalho do ARSession otimizado

    Esta é a primeira versão que encapsula completamente as funcionalidades do EasyAR Sense através de componentes Unity. O ARSession foi extensivamente otimizado e reescrito. Agora você pode facilmente verificar o suporte a dispositivos ou recursos, iniciar ou parar o ARSession conforme necessário para alternar entre sessões ou funcionalidades AR durante a execução. Você também pode usar o ARSessionFactory para criar ARSessions e componentes relacionados em tempo de execução. Esta versão também adiciona navegação inercial e funcionalidade de câmera 3DoF, projetadas principalmente para o EasyAR Mega, mas também utilizáveis separadamente.

  4. Novas ferramentas de desenvolvimento e diagnóstico

    Esta versão introduz uma nova funcionalidade de gravação e reprodução EIF. Embora o EIF já estivesse disponível em versões anteriores, seu uso nunca foi tão simples. Agora você pode usar a ferramenta de diagnóstico Session Validation Tool diretamente no editor Unity para reproduzir arquivos .eif e simular seu cenário, seja rastreamento de imagem, mapa espacial ou EasyAR Mega, replicando o comportamento do dispositivo no computador. Você também pode usar o painel de diagnóstico em tempo de execução EasyAR Diagnostics Panel para ativar facilmente a gravação EIF no aplicativo, ou exibir/ocultar informações-chave de estado do ARSession e seus componentes. Além disso, os exemplos desta versão foram totalmente reescritos, permitindo visualizar diretamente o estado do ARSession e um botão para gravar EIF ao executá-los.

  5. Ferramentas EasyAR Mega totalmente disponibilizadas

    Esta versão integra e lança o Mega Studio 2.12. Futuras atualizações do plugin serão mais frequentes, e as ferramentas Mega do lado Unity serão gradualmente incorporadas ao plugin e lançadas junto com as atualizações regulares. Além das atualizações das versões prévias, esta versão ativa por padrão o suporte à navegação inercial, expandindo significativamente a compatibilidade de dispositivos do EasyAR Mega. Também inclui suporte à versão mais recente do serviço EasyAR Mega Landmark. O uso do EasyAR Mega pode ser solicitado através da página do EasyAR.

As atualizações detalhadas são as seguintes:

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