Utilizzo degli esempi EasyAR su visori XR o occhiali

EasyAR fornisce esempi unificati per tutti i visori, senza alcun codice, implementati interamente tramite configurazione nella scena. L'utilizzo delle funzionalità può essere consultato negli esempi per dispositivi Android/iOS.

Gli esempi per visori sono denominati Combination_BasedOn_*, ad esempio l'esempio per Pico è Combination_BasedOn_Pico. Questa scena dimostra la maggior parte delle funzionalità EasyAR, che possono essere attivate/disattivate dinamicamente, utilizzate singolarmente o combinate.

Preparazione

• Verificare che il visore o gli occhiali siano nella lista supportata di EasyAR
• Scaricare e importare il pacchetto plugin Unity di EasyAR
• Scaricare e importare il pacchetto di estensione per dispositivi XR Unity di EasyAR
• Ottenere una licenza EasyAR valida per visori XR o occhiali. Le licenze disponibili includono:
  • Licenza XR di prova per EasyAR Sense 4.x (prova, attivabile autonomamente sul sito EasyAR)
  • Licenza XR a pagamento per EasyAR Sense 4.x (acquistabile contattando il reparto vendite)
  • Licenza XR Enterprise per EasyAR Sense 4.x (per SDK Enterprise)

Attenzione

Su visori e occhiali è consentito utilizzare solo licenze XR. Le licenze standard non abilitano le funzionalità EasyAR.

Importare gli esempi ufficiali

1. Gli esempi per dispositivi supportati nativamente si trovano nel pacchetto plugin Unity di EasyAR. Importare l'esempio specifico per il dispositivo.

2. Gli esempi per dispositivi supportati tramite estensioni sono distribuiti con l'estensione corrispondente. Importare l'esempio nel progetto tramite Unity. Esempio per Pico.

Compilazione ed esecuzione degli esempi

Completare separatamente la configurazione del progetto per il visore e seguire le istruzioni per l'utilizzo degli esempi.

• Seguire rigorosamente la documentazione ufficiale del visore per le configurazioni necessarie. La documentazione EasyAR non copre questi aspetti.

• Configurare secondo le istruzioni per ciascuna piattaforma nella documentazione EasyAR.

  Android: consultare Configurazione progetto Android

  visionOS: consultare Configurazione progetto visionOS

  Per XREAL, oltre alla configurazione Android, è necessaria la Configurazione progetto XREAL

• Compilazione dell'esempio Compilare ed eseguire l'esempio tramite Unity, quindi distribuirlo sul dispositivo. Per i dettagli, vedere Esecuzione degli esempi in Unity.

Istruzioni per l'uso

L'esempio include diversi pulsanti con le seguenti funzioni.

• Pulsante 1 HUD: alterna la modalità di visualizzazione dell'interfaccia utente. Nello stato iniziale l'interfaccia è fissa nel mondo reale; attivando HUD, l'interfaccia rimane sempre visibile davanti agli occhi.
• Pulsante 2 Record: attiva/disattiva la registrazione EIF. Dopo l'attivazione, è necessario disattivarla per generare un file EIF valido.
• Pulsante 3 Image: attiva/disattiva il tracciamento di immagini.
• Pulsante 4 Image Fusion: attiva/disattiva la modalità combinata tracciamento immagini + fusione del movimento.
• Pulsante 5 Dense: attiva/disattiva la mappatura spaziale densa.
• Pulsante 6 Sparse: attiva/disattiva la mappatura spaziale sparsa.
• Pulsante 7 Mega: attiva/disattiva Mega.

Dettagli sulle funzionalità

• Attivazione predefinita delle funzioni

  Tutte le funzioni sono disattivate per impostazione predefinita all'avvio, ottenuto disabilitando gli script corrispondenti nell'editor. I pulsanti abilitano/disabilitano questi script. È possibile configurare le funzioni attive per impostazione predefinita in base all'esempio da eseguire.

  

• Riferimento per l'origine del sistema di coordinate

  Nell'esempio, all'origine del sistema di coordinate del motion tracking è posizionato un modello statico di panda, utile per verificare lo stato del tracciamento. Questo modello aiuta a isolare problemi, ad esempio durante l'uso di Mega, dove derive rapide potrebbero essere causate dal motion tracking del dispositivo stesso. In tal caso, il panda seguirebbe la deriva. È possibile modificare o rimuovere questo modello secondo necessità.

• Utilizzo dell'immagine incorporata per il tracciamento

  • Nell'esempio sono preimpostate le dimensioni dell'immagine per il tracciamento. Stampare namecard.jpg su carta A4, mantenendo le proporzioni originali senza distorsioni o ritagli, riempiendo il foglio il più possibile (figura sotto).

  • Misurare la lunghezza effettiva del motivo stampato sulla carta. In base al risultato, impostare la Scala di Image Target nella scena Unity in modo che corrisponda alle dimensioni fisiche reali (l'unità di misura è in metri).

  • Con EasyAR motion fusion attivato, è possibile tracciare solo immagini in posizione fissa (non mobili). Se la fusione del movimento è disattivata, l'immagine non può essere tracciata quando esce dal campo visivo.

  • A volte la prospettiva degli occhiali non rappresenta accuratamente le dimensioni dell'immagine della fotocamera. In caso di problemi di riconoscimento, avvicinare la fotocamera all'immagine. Per l'uso pratico si consigliano immagini più grandi, ad esempio 5m x 5m.

Nota

Sui visori, indipendentemente dallo stato della funzione di fusione del movimento di EasyAR, il parametro Scale di image target deve essere impostato sulle dimensioni fisiche reali. Altrimenti, la posizione visualizzata sarà errata.

• Configurazione di Mega

  Se si utilizza EasyAR Mega, consultare la Guida rapida a Mega per Unity.