Table of Contents

Configurazione easyar

La pagina di configurazione di EasyAR è accessibile dal menu Unity EasyAR > Sense > Configuration o Edit > Project Settings > EasyAR.

alt text

Contiene tutte le configurazioni globali per EasyAR Sense Unity Plugin

alt text

Inizializza all'avvio

Inizializza EasyAR all'avvio. Si consiglia generalmente di mantenere questa opzione attiva.

Se disattivata, è necessario inizializzare manualmente EasyAR Sense. Per i dettagli, consultare Inizializzazione di EasyAR Sense.

Licenza EasyAR Sense

Configurazione relativa alla licenza EasyAR Sense.

LicenseKey

EasyAR Sense License Key. È necessario inserire una licenza valida per utilizzare le funzionalità EasyAR.

Può essere lasciato vuoto solo quando EasyAR Sense viene inizializzato manualmente tramite interfaccia.

Nota

Quando si utilizza su dispositivi head-mounted (Vision Pro, XREAL, Pico, Rokid, ecc.), è necessaria la licenza EasyAR XR.

Nota

Quando si utilizzano prodotti in prova (come licenze personali, licenze XR di prova o servizi Mega di prova) su fotocamere personalizzate o dispositivi di visualizzazione, EasyAR Sense smetterà di rispondere dopo 100 secondi dall'avvio (gli utenti Mega possono richiedere a EasyAR Business di modificare questa durata previa approvazione). L'utilizzo della versione a pagamento di EasyAR Sense e del servizio EasyAR Mega a pagamento non presenta questa limitazione.

Verify When Build

Verifica la License Key durante la compilazione del progetto Unity.

Quando questa opzione è attiva, il processo di compilazione del progetto Unity verifica la License Key. Se la licenza non è valida per la piattaforma di compilazione o non include il nome del pacchetto impostato nelle Unity Player Settings, la compilazione fallirà. Disattivare questa opzione se è necessario configurare la license key altrove o modificare il nome del pacchetto dopo il processo di compilazione di Unity.

Varianti lib

Configurazione delle varianti della libreria EasyAR Sense.

Licenza EasyAR Sense

Configurazione relativa alla licenza EasyAR Sense.

LicenseKey

EasyAR Sense License Key. È necessario inserire una licenza valida per utilizzare le funzionalità EasyAR.

Può essere lasciato vuoto solo quando EasyAR Sense viene inizializzato manualmente tramite interfaccia.

Nota

Quando si utilizza su dispositivi head-mounted (Vision Pro, XREAL, Pico, Rokid, ecc.), è necessaria la licenza EasyAR XR.

Nota

Quando si utilizzano prodotti in prova (come licenze personali, licenze XR di prova o servizi Mega di prova) su fotocamere personalizzate o dispositivi di visualizzazione, EasyAR Sense smetterà di rispondere dopo 100 secondi dall'avvio (gli utenti Mega possono richiedere a EasyAR Business di modificare questa durata previa approvazione). L'utilizzo della versione a pagamento di EasyAR Sense e del servizio EasyAR Mega a pagamento non presenta questa limitazione.

Verify When Build

Verifica la License Key durante la compilazione del progetto Unity.

Quando questa opzione è attiva, il processo di compilazione del progetto Unity verifica la License Key. Se la licenza non è valida per la piattaforma di compilazione o non include il nome del pacchetto impostato nelle Unity Player Settings, la compilazione fallirà. Disattivare questa opzione se è necessario configurare la license key altrove o modificare il nome del pacchetto dopo il processo di compilazione di Unity.

Autorizzazioni

Configurazione delle autorizzazioni dell'app. Si consiglia generalmente di mantenere le impostazioni predefinite.

Tranne l'autorizzazione della fotocamera, le altre autorizzazioni non sono modificabili e sono determinate da altre configurazioni di funzionalità.

Autorizzazione Modificabile Condizione di abilitazione Descrizione autorizzazione
Camera Sì Autorizzazione fotocamera, necessaria per utilizzare il dispositivo fotocamera
AndroidMicrophone No Variant è VideoRecording Autorizzazione microfono, necessaria per la funzionalità di registrazione schermo
Location No Importato il pacchetto di supporto Mega Autorizzazione di localizzazione (fine), necessaria per utilizzare EasyAR Mega

Unity XR

Configurazioni relative al framework Unity XR (AR Foundation, ecc.).

Supporto AR foundation

Interruttore di supporto AR Foundation, si consiglia di mantenerlo attivo.

In casi rari, come la necessità di utilizzare AR Foundation 4 o errori di compilazione dovuti ad aggiornamenti di AR Foundation, è possibile disattivare questa opzione, ma tutte le funzionalità correlate ad AR Foundation nel plugin verranno disabilitate contemporaneamente.

Nota

Dopo la modifica di questa opzione, gli script verranno ricompilati automaticamente.

Commutazione automatica Unity XR

Configurazione della funzionalità di commutazione automatica degli oggetti Unity XR (ad esempio AR Foundation).

  • Editor : opzioni modalità editor
    • Disable AR Session : quando è presente ARSession, disabilita ARSession di AR Foundation durante la modifica.
  • Player : opzioni modalità esecuzione
    • Enable : abilita il controllo a runtime. Nota: disattivando questa opzione, i componenti disabilitati in modalità modifica non verranno ripristinati a runtime.
    • Enable If Desktop : abilita su Windows/Mac.
    • Enable If Mobile AR On Startup : all'avvio del commutatore, se il loader per AR mobile (ARKit/ARCore) è attivo, abilita. Generalmente questa opzione richiede che Initialize XR on Startup in XR Plug-in Management sia selezionato.
    • Disable If Non Mobile AR Post Startup : all'avvio del commutatore, se sono presenti altri loader oltre ad AR mobile (ARKit/ARCore) ma nessuno di essi è attivo, disabilita. Questa opzione viene generalmente utilizzata quando Initialize XR on Startup in XR Plug-in Management non è selezionato.
    • Restore AR Session When Disabled : quando la funzionalità è disabilitata, ripristina (abilita) tutte le ARSession di AR Foundation che erano state disabilitate (indipendentemente dal fatto che siano state disabilitate da EasyAR). Questa opzione viene generalmente utilizzata per ripristinare i componenti disabilitati durante la modifica.

Per una spiegazione dettagliata della funzionalità, consultare Commutazione automatica Unity XR.

Mega

Configurazione della funzionalità EasyAR Mega.

Supporto inertialcameradevice

Opzione di sola lettura che mostra se la funzionalità di navigazione inerziale è disponibile e le informazioni sul runtime ONNX.

Se le informazioni visualizzate non soddisfano le esigenze, modificare Lib Variants e ONNX Runtime (Bundled) secondo necessità.

Mega block > accesso al servizio di localizzazione [globale]

Configurazione globale del server di localizzazione Mega Block.

Mega landmark > accesso al servizio di localizzazione [globale]

Configurazione globale del server di localizzazione Mega Landmark.

Mappa spaziale

Configurazione della funzionalità mappa spaziale EasyAR.

accesso al servizio [globale]

Configurazione globale del server della mappa sparsa.

Rilevamento immagini

Configurazione della funzionalità di rilevamento immagini EasyAR.

Gizmo target

Configurazione dei Gizmos per ImageTarget nell'editor.

Attivare queste opzioni mostrerà i gizmi corrispondenti in Unity Editor. Se ci sono troppi target di questo tipo nella scena, potrebbe influire sulle prestazioni di avvio nell'editor. Le prestazioni durante l'esecuzione sul dispositivo non saranno influenzate.

Riconoscimento cloud (crs) > accesso al servizio [globale]

Configurazione globale del server di riconoscimento cloud.

Rilevamento oggetti

Configurazione della funzionalità di rilevamento oggetti EasyAR.

Gizmo target

Configurazione dei Gizmos per ObjectTarget nell'editor.

  • Enable: abilita i Gizmos.

Librerie di terze parti

Configurazione di librerie di terze parti.

Arcore sdk

Configurazione di ARCore SDK.

ARCore fornisce capacità di tracciamento del movimento su alcuni dispositivi Android. Leggere Motion tracking e funzionalità EasyAR per comprendere la relazione tra le funzionalità EasyAR e il motion tracking, nonché quando è necessario utilizzare ARCore.

  • AR Foundation Or Optional: ARCore SDK distribuito con EasyAR o AR Foundation sarà incluso nell'app, in base alle impostazioni di ARCore XR Plugin. Generalmente si consiglia questa opzione, poiché gestisce automaticamente i casi di AR Foundation.
  • Optional: Le funzionalità ARCore sono utilizzabili su dispositivi compatibili con ARCore e con Google Play Services for AR installato.
  • Required: L'app funzionerà solo su dispositivi compatibili con ARCore e con Google Play Services for AR installato.
  • External: Utilizzare questa opzione se si utilizza la distribuzione di AR Foundation o di un altro ARCore SDK. In tal caso, l'SDK ARCore distribuito con EasyAR non verrà utilizzato. Questa opzione può anche servire per escludere completamente l'SDK ARCore dall'app.
Attenzione

Se si imposta ARCore SDK su Required, o se nelle configurazioni ARCore di AR Foundation si imposta Requirement su Required, e l'app confezionata viene installata su un dispositivo non supportato, il dispositivo segnalerà erroneamente che ARCore è disponibile e funzionerà con ARCore. Ciò crea l'illusione che questi dispositivi stiano eseguendo ARCore in modo anomalo (schermo nero o altri problemi), ma è un errore.

Questo fenomeno si verifica perché Google Play Store impedisce l'installazione di app che richiedono ARCore su dispositivi non supportati, quindi tali app presumono sempre di essere eseguite su dispositivi supportati.

Nella configurazione normale, questi dispositivi rileveranno che ARCore non è supportato durante l'assemblaggio della sessione e utilizzeranno le funzionalità di EasyAR.

Per spiegazioni dettagliate su Optional e Required e altre configurazioni necessarie per pubblicare app su Google Play Store, fare riferimento alla documentazione di Google (Cina continentale, Internazionale).

Nota

In EasyAR Sense Unity Plugin, le librerie e le configurazioni necessarie per il supporto ARCore sono già nel pacchetto del plugin, ma per l'esecuzione sul telefono è comunque necessario installare Google Play Services for AR.

Sono disponibili tre diverse fonti per l'SDK ARCore:

  • Utilizzo dell'SDK ARCore distribuito con il plugin

    Il plugin include una versione integrata dell'SDK ARCore. Per dettagli, consultare Compatibilità delle versioni di ARCore, AR Engine. Quando si utilizza il wrapper ARCore di EasyAR, non è necessario importare separatamente AR Foundation.

  • Utilizzo dell'SDK ARCore di AR Foundation

    Se si desidera utilizzare l'SDK ARCore di AR Foundation, seguire le istruzioni di Google (Cina continentale, Internazionale) per la configurazione. In questo caso, l'opzione ARCore SDK deve essere impostata su AR Foundation Or Optional o External.

  • Utilizzo di altri SDK ARCore

    Se sono presenti altri plugin di terze parti o distribuzioni di SDK ARCore nel progetto, è possibile utilizzarli. In questo caso, impostare ARCore SDK su External e configurare secondo i requisiti specifici del plugin o progetto.

Warn 32-bit-only ARCore-enabled build

Secondo le linee guida di Google, ARCore non funzionerà correttamente su dispositivi arm64 se eseguito con librerie solo armv7. Durante il build, se non è selezionato ARM64, verrà visualizzato un avviso:

alt text

È necessario modificare la configurazione del progetto, utilizzare la compilazione IL2CPP e selezionare il supporto ARM64.

alt text

Attenzione

Se necessario, è possibile selezionare Continue and don't warn me again o disattivare l'opzione, il che disabiliterà il controllo durante il build. Disattivare il controllo eliminerà solo l'avviso durante il build, ma durante l'esecuzione su alcuni dispositivi potrebbero verificarsi anomalie, inclusi ma non limitati a crash o schermo nero.

Ar engine sdk

Configurazione di AR Engine SDK.

AR Engine fornisce capacità di tracciamento del movimento su alcuni dispositivi Android. Leggere Motion tracking e funzionalità EasyAR per comprendere la relazione tra le funzionalità EasyAR e il motion tracking, nonché quando è necessario utilizzare AR Engine.

  • AREngineInterop : AREngineInterop disponibile. L'SDK AR Engine distribuito con EasyAR sarà incluso nell'app.
  • External : AREngineInterop disponibile. L'SDK AR Engine distribuito con EasyAR non verrà utilizzato.
  • Disabled : AREngineInterop non disponibile. L'SDK AR Engine distribuito con EasyAR non verrà utilizzato. Tutte le funzionalità relative ad AR Engine saranno disabilitate.

Onnx runtime (bundled)

Se utilizzare il runtime ONNX incluso. Valido solo quando Lib Variant è Full.

Per utilizzare una versione diversa di ONNX, ottenere una versione aggiornata dal sito ufficiale di ONNX e disattivare questa opzione. L'utilizzo di binari auto-compilati incompatibili con ONNX causerà errori imprevisti.

Soluzione alternativa per unity

Soluzioni per bug o comportamenti irragionevoli di Unity.

GenerareXMLDoc

Genera documentazione XML al riavvio dello scripting per abilitare l'intelliSense della documentazione API.

Urp17rg dx11 ruinedscene

Soluzione alternativa per URP 17 Render Graph DX11 con scena renderizzata danneggiata. Disattivato in Unity 6.2 e versioni successive.

Urp17rg ios glitches partial

Soluzione alternativa parziale per Unity Issue UUM-87787.

Descrizione: Quando si utilizza una texture della fotocamera ottenuta da EasyAR (come nell'esempio ImageTracking_Coloring3D e nell'esempio Flusso di lavoro ARSession (CameraDevice)), su dispositivi iOS/Mac si osservano difetti visivi e artefatti. Abbiamo riprodotto il problema in un pacchetto Unity pulito e lo abbiamo segnalato a Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Seguire Unity Issue UUM-87787 per gli aggiornamenti e i changelog delle versioni future di Unity.