Table of Contents

Notas de versão do EasyAR Sense Unity Plugin

Temos o prazer de anunciar o lançamento do EasyAR Sense Unity Plugin 4000. Esta versão marca que o EasyAR já possui APIs maduras e suporte atualizado para dispositivos, além de tornar os novos lançamentos mais frequentes do que antes.

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

Histórico de versões

Versão 4003.1.1

Data de lançamento: 2026-09-07

  • 🚀 Adicionada a extensão EasyAR Sense Unity Plugin Meta XR, com suporte a Meta Quest 3/3S
  • 🐛 Corrigido o problema em que input extensions não podiam ser usadas quando DeviceOriginType era OriginType.External
  • 🔧 AR session não falha mais ao iniciar quando Mega cloud service está configurado como desativado

Versão 4003.1.0

Data de lançamento: 2026-08-20

  • ✨ Adicionado suporte ao Mega Go
  • ✨ Adicionado suporte à interface ARSession.InputFrameUpdate em headset, para obter non realtime camera data durante o runtime em headset
  • 🐛 Corrigido o problema em que reproduzir EIF ao iniciar a session podia causar falha de posicionamento do Mega
  • ⬆️ Atualizado EasyAR Sense para 4.10.0
  • ⬆️ Atualizado EasyAR Sense Unity Plugin PICO Extension para 4000.1.0
    • ✨ Adicionado suporte a PICO 4 Ultra User Devices, PICO Space Pro e compatibilidade com futuros dispositivos PICO
    • 💥 Substituídas as interfaces de dispositivos enterprise PICO por interfaces de dispositivos de usuário, de modo que devices enterprise não precisam mais de enterprise authorization da PICO

Versão 4003.0.0

Data de lançamento: 2026-07-01

  • 🚀 Novo workflow de desenvolvimento do Mega
    • ✨ As APIs das funções Mega e o workflow de desenvolvimento ficaram mais próximos de funções AR tradicionais como image tracking
    • ✨ Adicionado o componente MegaBlockController, substituindo o grupo de nodes criado anteriormente pelo Mega Studio
    • ✨ O session validation tool dá suporte a mais opções práticas de controle do Mega
    • ✨ O uso de um switch de configuração global controla a ativação dos recursos do Mega
    • 💥 O runtime não depende mais fortemente de com.easyar.mega; com.easyar.mega agora fornece apenas funções de editor e ema
    • 🔥 Removidas as opções multi block e block root node; cada block agora é independente
    • 🔥 Removida a área de teste do editor MegaTrackerFrameFilter, já que essa função é totalmente substituída pelo session validation tool
  • 🐛 Corrigido o problema de scene mais escura ao usar sample no Unity 6 e acima
  • 🐛 Corrigidos erros de compilação de alguns scripts em ambiente Unity 6.4 URP
  • 🐛 Corrigido o problema de alterações em advanced options do MotionTrackerFrameFilter não serem salvas no editor
  • ⬆️ Atualizado o pacote de suporte do EasyAR Mega para 2.13.0
    • 🚚 O antigo com.easyar.mega foi dividido em dois pacotes, com.easyar.mega (pacote de suporte do Mega) e com.easyar.mega.studio (Mega Studio), e o Mega Studio não oferece mais suporte ao uso para desenvolvimento Unity
    • 🚚 Parte das interfaces foi movida do namespace EasyAR.Mega.Scene para EasyAR.Mega
    • ✨ Suporte ao serviço internacional do Mega
    • ✨ Suporte a panorama preview no modo play do editor
    • ✨ Suporte para visualizar block data na prefab view
    • ✨ Permissão para girar block livremente no editor
    • ✨ Gizmo de limites da mesh exibido forçadamente quando o carregamento falha
    • 🔥 Removido o suporte a block data gerados por serviços de mapeamento da versão 9.3 e anteriores
    • 🔥 Removido o suporte a localization service 2.0 e anteriores
    • 🔥 Removido o suporte a ema 0.3-0.4
    • 🔥 Removido o suporte a annotation nodes na scene
  • ⬆️ Atualizado EasyAR Sense Unity Plugin Extensions para 4000.0.1
    • 🔧 Ajustados os componentes Mega nas sample scenes

Versão 4002.0.0

Data de lançamento: 2026-05-18

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

Versão 4001.0.0

Data de lançamento: 2026-03-10

  • 🐛 Corrigido um problema numérico na conversão de pose de native para Unity. Esse problema podia causar saltos breves de pose em alguns dispositivos ao usar Mega, fazendo o conteúdo piscar ou tremer rapidamente. A correção também pode resolver outros problemas potenciais semelhantes.
  • 🔧 Ajustadas algumas interfaces do MegaTrackerFrameFilter para acompanhar mudanças nas interfaces do EasyAR Sense
  • ⬆️ Atualizado EasyAR Sense para 4.8.0

Versão 4000.0.1

Data de lançamento: 2025-11-14

  • 🐛 Corrigido: resolvido um possível erro de runtime AndroidJavaException em builds Android com minify causado pela ausência de métodos estáticos (loadLibraries, setupActivity), que podia impedir 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 package versioning exigido pela Unity (usando Semantic Versioning), portanto o número de versão será diferente do EasyAR Sense e a frequência de lançamento também poderá ser distinta. Este plugin inclui o EasyAR Sense 4.7.0 oficial.

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

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

    A partir desta versão, o EasyAR Sense Unity Plugin passa a suportar apenas Unity 2021.3 e versões mais recentes, e o suporte ao Unity 6 também está completo. O suporte ao AR Foundation também foi integrado ao pacote do plugin; esta versão suporta apenas AR Foundation 5 e versões mais recentes, com uso muito simplificado. Se componentes do AR Foundation forem adicionados à scene, a configuração da scene e o código de script podem permanecer iguais, independentemente de o AR Foundation ser ou não usado no runtime.

  2. Suporte de headset mais moderno, com vários novos headset OST/VST

    Após anos de aprimoramento com várias empresas do setor, o suporte do EasyAR para headset foi padronizado. Agora você pode adicionar suporte a dispositivos headset de terceiros por meio de uma EasyAR Sense Unity Plugin extension (talvez seja necessário parte da data interface do fabricante do headset). Esta versão inclui suporte para Apple Vision Pro e XREAL Air2 Ultra, além de suporte para Pico 4 Ultra Enterprise e Rokid AR Studio por meio da EasyAR Sense Unity Plugin extension. Você também pode obter outros support extension packages de parceiros EasyAR, por exemplo Xrany 元霓.

  3. Melhoria das interfaces de Unity components e grande otimização do workflow de ARSession

    Esta versão é a primeira a encapsular completamente as funções do EasyAR Sense por meio de Unity components. O ARSession foi amplamente otimizado e reescrito; agora você pode determinar facilmente se um device ou function é suportado e iniciar ou parar o ARSession conforme a situação para fazer runtime switching entre ARSession ou diferentes funções AR. Também é possível usar ARSessionFactory para criar ARSession e componentes relacionados em runtime. Esta versão também adiciona inertial navigation e 3DoF camera, principalmente para EasyAR Mega, mas que também podem ser usadas separadamente.

  4. Novas ferramentas de desenvolvimento e diagnóstico

    Esta versão adiciona EIF recording e playback totalmente novos. Embora EIF recording e playback já pudessem ser usados em versões anteriores, agora seu uso ficou muito mais simples. Agora você pode usar o Session Validaion Tool no Unity Editor para reproduzir EIF diretamente e controlar sua scene, seja de image tracking, spatial map ou EasyAR Mega, reproduzindo no computador o comportamento em runtime do device. Você também pode usar o runtime diagnostic panel EasyAR Diagnostics Panel no app para ativar facilmente EIF recording ou alternar a qualquer momento as principais status information do ARSession e de seus componentes. Além disso, os sample desta versão foram totalmente reescritos, então ao executar o sample você vê diretamente o status do ARSession e os botões para gravar EIF, facilitando o uso.

  5. Abertura completa das ferramentas do EasyAR Mega

    Esta versão integra o Mega Studio 2.12. No futuro, as atualizações do plugin serão mais frequentes, e as ferramentas Mega do lado Unity serão gradualmente integradas ao plugin e lançadas junto com as atualizações regulares. Além das novidades das versões prerelease anteriores, esta versão ativa inertial navigation por padrão, ampliando bastante o suporte a devices do EasyAR Mega. Esta versão também inclui suporte à versão mais recente do Mega Landmark service. Você pode solicitar o uso do EasyAR Mega por meio da página da web da EasyAR.

Os detalhes completos das atualizações estão abaixo:

Mudanças de compatibilidade do Unity e AR Foundation:

  • 🔧 Unity: suporte a Unity 2021.3 e versões posteriores, incluindo Unity 2022.x/Unity 6.x
    • 🔥 Removido suporte a Unity 2019/Unity 2020
    • 🔥 Removida a verificação de versão do gradle para Unity 2019
    • 🔥 Removida a opção DisableARCoreAREngine para Unity 2019
  • ✨ Unity 6: suporte completo a Unity 6
    • ✨ Suporte a URP 17+ e Render Graph
    • 🐛 Corrigido: falha do ARCore causada por mudanças de comportamento do ClassLoader no Unity 6
    • 🐛 Corrigido: falha de renderização da câmera quando Render Scale não é 1
    • 🐛 Bug próprio do Unity 6: falhas visuais e artefatos podem ser observados em dispositivos iOS/Mac. O problema ocorre apenas quando é necessário obter texturas de câmera. Adicionamos mitigações parciais, mas não conseguimos eliminá-lo completamente. Foi reportado à Unity, veja Unity Issue UUM-87787. No Unity 6.2 e versões posteriores, é possível evitar o problema definindo Render Scale no Universal Render Pipeline Asset para um valor fora de 0.96-1.05.
    • 🐛 Bug próprio do Unity 6: a renderização no Windows DX11 não é normal. Adicionamos mitigações no Unity 6.0-6.1. Testes mostram que o Unity 6.2 corrigiu o problema.
  • ✨ AR Foundation: suporte a AR Foundation 5 e versões posteriores, simplificando muito o uso
    • ✨ O suporte a AR Foundation foi integrado ao pacote do plugin e não é mais necessário importar um pacote separado. Para necessidades especiais, ele pode ser desativado por opções de configuração.
    • ✨ Suporte a reutilizar Unity.XR.CoreUtils.XROrigin como origem do ARSession e reutilizar a Camera do XROrigin
    • ✨ Adicionada a opção de configuração Unity XR Auto Switch, que trata por padrão a troca de objetos Unity XR, incluindo AR Foundation
    • ✨ ARSession criado pelo menu EasyAR inclui automaticamente e ativa por padrão o suporte a AR Foundation
    • ✨ A maioria dos sample já adicionou suporte a AR Foundation, enquanto o próprio AR Foundation ainda precisa ser importado e configurado corretamente de forma manual
    • 🔧 ARCore e ARKit podem ser controlados separadamente, e a prioridade entre ARCore/ARKit integrados ao EasyAR e ARCore/ARKit do AR Foundation pode ser controlada
    • 🔥 Removido suporte a AR Foundation 4
    • 🔥 Removido suporte a ARSessionOrigin, apenas XROrigin é suportado
    • 🔥 Removida a execução proxy do fluxo de instalação do ARCore do AR Foundation
  • ✨ Compatibilidade total com Input System Package

Suporte a headsets acompanha a evolucao, com novo suporte a varios headsets OST/VST:

  • 🚀 A interface head-mounted display device esta estavel e suporta integracao de terceiros
    • ✨ Suporta integracao de dispositivos de terceiros, requiring headset manufacturers to provide specific data interfaces
    • ✨ Supports XROrigin and XR Interaction Toolkit
    • ✨ Simplified and unified all headset samples, zero code, with feature switching support
    • ✨ Supports fisheye camera input
    • ✨ Supports custom camera input 3DOF data
    • ✨ Added menu feature: Extensions, integrating all extension menu items
    • 🐛 Fixed rendering anomalies when running DenseSpatialMap on some headsets
    • 🔥 Removed old glasses samples such as ActionOne and BT350
  • ✨ Built-in support for Apple Vision Pro
    • ✨ Supports Metal, RealityKit, and Hybrid modes
    • ✨ Supports visionOS >= 2.0 and visionOS 26
  • ✨ Built-in support for XREAL Air2 Ultra, requiring XREAL SDK >= 3.1
    • ✨ No need to import a separate support package
    • ⚡ Optimized runtime effects on XREAL
    • 🔥 Removed XREAL Light support
  • ✨ Distributes support for other devices such as Pico and Rokid through EasyAR Sense Unity Plugin extensions
    • ✨ Provides a reference template for third-party device integration, com.easyar.sense.ext.hmdtemplate
    • ✨ Supports Pico 4 Ultra Enterprise, requiring PICO Unity Integration SDK >= 3.1
    • ✨ Supports Rokid AR Studio, requiring Rokid Unity OpenXR Plugin >= 3.0.3
    • ✨ These extensions will support multiple future versions of EasyAR Sense Unity Plugin
  • ✨ Suporta EasyAR XR License
    • 🔧 Using EasyAR on headsets requires EasyAR XR License and the first network connection must be available. The trial requires network access every time

Aprimoradas Unity component interfaces e muito otimizado o workflow ARSession:

  • 🚀 Aprimorada a encapsulation da Unity component layer
    • ✨ Aprimorados scene components, fornecendo todas as EasyAR Sense features
    • 🔥 Removidas todas as EasyAR Sense layer interfaces encapsuladas por components
    • 🔥 Removidas todas as internal interfaces
  • ✨ ARSession: workflow reescrito e muito otimizado
    • ✨ Oferece suporte a iniciar e parar session a qualquer momento
    • ✨ Oferece suporte a automatic session startup control
    • ✨ Oferece suporte a alternar session features e input sources sem black screen
    • ✨ Simplifica device support judgment e o fornece por uma interface consistente
    • ✨ Atualiza device support lists de MotionTracker, ARCore e AR Engine no startup
    • ✨ Oferece suporte a automatic session restart após atualização de device list
    • ✨ Oferece suporte à obtenção de detailed session corruption information
    • ✨ Adicionado session internal state self-check
    • 🔥 Removido ARComponentPicker. Sua funcionalidade é substituída pelos demais session flows
    • 🔥 Proíbe várias instâncias de ARSession executando ao mesmo tempo
  • ✨ ARSessionFactory: Fornece runtime creation de ARSession e components relacionados
    • ✨ Oferece suporte à criação em runtime da mesma session do editor menu por meio de ARSessionFactory
    • ✨ Adicionada Frame Source sorting feature, incluindo menu item
  • ✨ FrameSource: Adicionado suporte a inertial navigation e 3DoF
    • ✨ Adicionado InertialCameraDeviceFrameSource para suporte a inertial navigation
    • ✨ Adicionado ThreeDofCameraDeviceFrameSource para cameras compatíveis com 3DoF
    • ✨ Adicionada menu feature: Frame Source by Transform Type, fornecendo uma lista de todos os FrameSource integrados
    • ⚡ Otimizadas Inspector options
  • ✨ Outros ajustes de interfaces e feature updates
    • ✨ Adicionada feature para criar ImageTarget usando Texture2D
    • ✨ Adicionado ImageMaterial para renderizar dados do tipo Image, como camera images ou Target images
    • ✨ Adicionado ActiveController para controlar GameObject active e unificar a control logic relacionada
    • ✨ Adicionada feature para simular screen rotation no desktop
    • ✨ Adicionado XROriginChildController, controlando behavior de objetos sob Session origin
    • 🔥 Removido WorldRootController
    • 🔧 Sparse spatial map interfaces divididas em dois functional components diferentes, Builder e Tracker
    • 🔧 Ajustado EasyARController, fornecendo application/system-level static features
    • 🔧 Unificadas Target component interfaces
    • 🔧 Unificadas service access data interfaces

Adicionadas várias ferramentas de desenvolvimento e diagnóstico:

  • 🚀 Adicionado edit-time diagnostic tool: Session Validaion Tool
    • ✨ Simplifica a reprodução de eif em qualquer scene
    • ✨ Oferece suporte ao controle do fluxo de playback de eif
    • ✨ Oferece suporte ao controle do fluxo de session
  • 🚀 Adicionado runtime diagnostic panel: EasyAR Diagnostics Panel
    • ✨ Adicionado switch Developer Mode. Por padrão, tocar na tela 8 vezes ativa e desativa Diagnostics Panel, simplificando recording eif e issue feedback para online apps
    • ✨ Oferece suporte a custom Developer Mode switch, usando interação personalizada para alternar Diagnostics Panel
    • ✨ Oferece suporte ao controle de recording eif
    • ✨ Oferece suporte ao controle da exibição de informações session
    • ✨ Oferece suporte ao controle de recording eed
  • ✨ Adicionadas novas funcionalidades de EIF recording e playback
    • ✨ FrameRecorder é montado automaticamente em ARSession e não precisa mais ser selecionado manualmente
    • ✨ FrameRecorder gera file names automaticamente por padrão para oferecer suporte ao uso sem script
    • ✨ FramePlayer oferece suporte a seek e speed adjustment para dados gravados no novo formato, com tamanho de arquivo reduzido
    • 🔧 Oferece suporte ao uso de eif no computador para conduzir scenes e AR features, não é uma nova funcionalidade
  • ✨ Adicionado DiagnosticsController, unificando e otimizando diagnostic features
    • ✨ Adicionada exibição e controle de informações por nível. Por padrão, todas as informações de error e warning são exibidas pela UI
    • ✨ Adicionada exibição de informações de status principais de ARSession e seus componentes. Por padrão, são exibidas pela UI e atualizadas a cada frame
    • 🔧 Usa diagnostic features para simplificar a coleta de informações de issue feedback
    • 🔥 Removido GUIPopup
  • 🔧 Otimizado o comportamento de abnormal state e a exibição de error information
    • 🔧 Otimizada a error information quando não há frame source disponível
    • 🔧 Em ambientes URP, quando EasyAR é usado em vez de AR Foundation ou headset rendering para renderizar camera images, um RendererFeature configurado incorretamente relata error e interrompe a execução de ARSession
    • 🔧 Modificada a default Active control policy de Origin para que content fique preso à tela em vez de desaparecer quando tracking é perdido
    • 🔧 Ao usar trial products em custom cameras ou headsets, todo o content é ocultado quando o time limit é atingido para evitar avaliação incorreta do efeito
  • 🔧 Otimizados content e options da página de configuração
    • ✨ Oferece suporte à seleção de variants da EasyAR Sense library
    • 🔒 Na seção application permissions, permissions além de camera permission não podem mais ser alteradas e são determinadas pelo variant da EasyAR Sense library e por Mega estar habilitado
    • 🔧 Function e server configurations são agrupadas por EasyAR feature
    • 🔧 Gerencia third-party AR SDK configurations de forma centralizada
    • 🔧 Gerencia Workaround configurations para Unity de forma centralizada

Ferramentas EasyAR Mega totalmente publicas:

  • 🚀 Totalmente publicas, atualizadas de forma sincronizada
    • ✨ Lancamento integrado do Mega Studio 2.12
    • 🔧 As ferramentas Mega do lado Unity serao gradualmente mescladas ao plugin. No futuro, apenas o pacote integrado mais recente sera fornecido, mas sera lancado junto com as atualizacoes regulares do EasyAR Sense Unity Plugin
    • 🔧 EasyAR Mega ainda precisa ser solicitado pela pagina do site EasyAR e so pode ser usado apos aprovacao
  • ✨ Adicionado suporte a EasyAR Mega Landmark
  • ✨ Adicionado suporte a 5DOF inertial navigation e ativado por padrao, expandindo ainda mais o suporte de dispositivos EasyAR Mega
  • ✨ Adicionado suporte ao uso de API Token para acessar servicos Mega
  • 🔧 Otimizados efeitos Mega e experiencia de desenvolvimento, incluidos nas atualizacoes 4.7.x anteriores
    • ✨ Suporta modo de rotacao pura 3DOF e modo 0DOF, nao ativados por padrao
    • ✨ Adicionado EditorCameraDeviceFrameSource para diagnostico no editor, evitando execucao incorreta no telefone causada por copia incompleta do sample
    • ✨ Ao gravar dados eif de versao antiga usando Mega, FrameRecorder gerara automaticamente um arquivo .eif.json
    • 🔧 Substituida a opcao degradada de remote debugging por LocationInputMode
    • 🔧 Modo sem tracking dividido em componente independente, que geralmente nao precisa mais ser usado ou observado
    • 🔧 Adicionada opcao BlockRootSource. Na configuracao padrao, esquecer de definir BlockRoot reportara erro
    • 🔧 Ajustado o comportamento padrao ao localizar em varios blocks, garantindo que varios blocks nao sejam usados por padrao
    • 🔧 Ajustados alguns nomes de interfaces
    • 🔧 Lanca excecoes mais claras quando Session contem Mega mas nao pode usa-lo
    • 🔧 Ajustado o MotionTracker QualityLevel minimo suportado por Mega para Limited
    • 🐛 Corrigido runtime error causado por escape incorreto de CloudLocalizerStatus.WakingUp
    • 🔧 Algumas otimizacoes e alteracoes estao listadas no changelog do EasyAR Sense

Reescrita e otimização dos sample:

  • ✨ Todos os sample foram reescritos
    • ✨ Compatível com diferentes configurações de Input System
    • ✨ Compatível com URP17+
    • ✨ Compatível com uso de AR Foundation
    • 🔧 Compatível sem usar AR Foundation
    • 🔧 Mantém um pequeno número de sample sem suporte a AR Foundation
    • ⚡ Scripts e chamadas de interface otimizados
    • 🚚 Alguns sample foram renomeados
    • 🔧 Recursos como modelos e vídeos nos sample foram substituídos
    • ⚡ Reduzido o uso de streaming assets, usados e importados apenas em sample que demonstram funções específicas
    • ✨ Usa Texture2D para criar ImageTarget
  • ✨ Adicionadas demonstrações de novos recursos e APIs
    • ✨ Adicionado sample Workflow_ARSession para aprender fluxo básico de session, suporte de dispositivos e mais
    • ✨ Adicionado sample Workflow_FrameSource_ExternalImageStream, usando vídeo como câmera personalizada, não para headsets
    • ✨ Adicionado sample Combination_BasedOn_MotionTracking para aprender uso e troca de vários recursos quando motion tracking está disponível, além da troca de AR Foundation
    • ✨ Adicionado sample Combination_BasedOn_AppleVisionPro para demonstrar uso e troca de recursos no Apple Visio Pro
    • ✨ Adicionado sample Combination_BasedOn_Xreal para demonstrar uso e troca de recursos em dispositivos XREAL
    • ✨ Adicionados vários Mega sample, incluídos em atualizações anteriores 4.7.x
    • ✨ Adicionados recursos de troca de tamanho de câmera e torch mode em Workflow_FrameSource_CameraDevice
    • 🔥 Removido o sample AR Foundation separado, cuja função já está incluída em outros sample
    • 🔥 Removido FrameRecording sample, cuja função já está incluída em outros sample
    • 🔥 Removido MotionTracking_Fusion sample, cuja função já está incluída em Combination_BasedOn_MotionTracking
    • 🔥 Removido SurfaceTracking_ImageTarget sample; essa combinação de recursos ainda pode ser implementada facilmente
    • 🔥 Removido Camera_CustomCamera sample; se necessário, ainda pode ser implementado manualmente
    • 🔥 Removidos sample antigos de óculos, como ActionOne e BT350
  • ✨ Simplificado o uso de gravação e reprodução eif
    • ✨ Todos os sample adicionam botão de gravação eif, e arquivos eif gravados podem ser usados no editor
  • ✨ launcher reescrito e descrições de sample adicionadas
    • 🐛 Corrigido problema em que cenas sample carregadas pelo launcher ficavam muito escuras

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

  • ⬆️ EasyAR Sense atualizado para a versão oficial 4.7.0
  • ⬆️ EasyAR AR Engine Interop atualizado
  • ⬆️ ARCore SDK atualizado para 1.46.0
  • 🔧 AR Engine desativado em alguns telefones onde AR Engine não pode funcionar razoavelmente
  • 🐛 Corrigida falha do ARCore causada por mudança de comportamento do ClassLoader no Unity 6

Tópicos relacionados