Table of Contents

Configurazione EasyAR

La pagina di configurazione di EasyAR può essere accessa dal menu di Unity EasyAR > Sense > Configuration o Edit > Project Settings > EasyAR.

alt text

Qui sono contenute tutte le configurazioni globali per il plug-in Unity di EasyAR Sense.

alt text

Initialize On Startup

Inizializza EasyAR all'avvio. In genere si consiglia di mantenere questa opzione abilitata.

Se si disabilita questa opzione, è necessario inizializzare manualmente EasyAR Sense. Per i metodi specifici, consultare Inizializzare 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.

Lib Variants

Configurazione delle varianti della libreria EasyAR Sense.

EasyAR Sense ha solitamente più varianti, e le funzionalità delle diverse varianti variano. Di seguito è riportato un confronto delle varianti della libreria integrate nel plugin.

Variante Nome variante EasyAR Sense Differenze funzionali Altre particolarità
Normal Community/Enterprise Non include registrazione schermo e guida inerziale
Full CommunityFull/EnterpriseFull Include guida inerziale e alcune altre funzioni Mega Dimensione file libreria più grande
VideoRecording CommunityR Include funzionalità di registrazione schermo (solo Android)
Consiglio

Alcune varianti non utilizzabili in Unity non sono elencate qui, ad esempio la variante CommunityR per iOS.

Valori predefiniti:

  • Senza pacchetto di supporto EasyAR Mega importato: Normal
  • Con pacchetto di supporto EasyAR Mega importato: Full

Configurazione consigliata:

  • Full : Utilizzare EasyAR Mega o utilizzare la funzionalità di guida inerziale
  • Normal : Ricerca della dimensione del pacchetto più piccola possibile, senza utilizzare EasyAR Mega o supporto per guida inerziale
  • VideoRecording : È necessaria la funzionalità di registrazione schermo (solo Android)

Permissions

Configurazione dei permessi dell'applicazione. In genere si consiglia di mantenere le impostazioni predefinite.

Oltre al permesso della fotocamera, le altre configurazioni dei permessi non possono essere modificate e sono determinate dalle configurazioni di altre funzionalità.

Permesso Modificabile Condizioni di abilitazione Descrizione del permesso
Camera Sì Permesso per la fotocamera, necessario per utilizzare il dispositivo fotocamera
AndroidMicrophone No Variant è VideoRecording Permesso per il microfono, necessario per utilizzare la funzione di registrazione video
Location No Importazione del pacchetto di supporto Mega Permesso di localizzazione (fine), necessario per utilizzare EasyAR Mega

Unity XR

Configurazione relativa al framework Unity XR (come AR Foundation).

AR Foundation Support

Interruttore di supporto per AR Foundation, si consiglia di mantenerlo abilitato.

In alcuni rari casi, ad esempio se è necessario utilizzare AR Foundation 4 o se l'aggiornamento di AR Foundation causa errori di compilazione, è possibile disabilitare questa opzione, ma tutte le funzionalità correlate a AR Foundation all'interno del plug-in verranno disabilitate contemporaneamente.

Nota

Dopo aver modificato questa opzione, gli script verranno automaticamente ricompilati.

Unity XR Auto Switch

Configurazione della funzione di cambio automatico degli oggetti Unity XR (come AR Foundation).

  • Editor ：Opzione per la modalità di editing
    • Disable AR Session ：Quando è presente ARSession, disabilita la sessione AR di AR Foundation durante l'editazione.
  • Player ：Opzione per la modalità di esecuzione
    • Enable ：Abilita il controllo in fase di esecuzione. Nota: se si disabilita questa opzione, i componenti disabilitati in modalità di editing non verranno ripristinati in fase di esecuzione.
    • Enable If Desktop ：Abilita su Windows/Mac.
    • Enable If Mobile AR On Startup ：Quando il commutatore viene avviato, se il loader per AR mobile (ARKit/ARCore) è attivo, abilita la funzione. In genere, questa opzione richiede che l'opzione Initialize XR on Startup in XR Plug-in Management sia selezionata.
    • Disable If Non Mobile AR Post Startup ：Quando il commutatore viene avviato, se sono presenti altri loader oltre a quelli per AR mobile (ARKit/ARCore), ma nessuno di essi è attivo, disabilita la funzione. In genere, questa opzione viene utilizzata quando l'opzione Initialize XR on Startup in XR Plug-in Management non è selezionata.
    • Restore AR Session When Disabled ：Quando la funzione è disabilitata, ripristina (abilita) tutte le sessioni AR di AR Foundation disabilitate (indipendentemente dal fatto che siano state disabilitate da EasyAR o meno). Questa opzione viene solitamente utilizzata per ripristinare i componenti disabilitati durante l'editazione.

Per una descrizione dettagliata delle funzionalità, consultare Cambio automatico di Unity XR.

Mega

Configurazione delle funzionalità di EasyAR Mega.

Mega Block/Landmark Support

Abilitare o meno il supporto per Mega Block/Landmark.

Questa opzione viene abilitata per impostazione predefinita dopo l'importazione di com.easyar.mega e disabilitata per impostazione predefinita se non viene importata.

InertialCameraDevice Support

Opzione di sola lettura che mostra se la funzione di navigazione inerziale è disponibile con la configurazione corrente.

Se le informazioni visualizzate non soddisfano le esigenze, è necessario modificare l'opzione Lib Variants in base alle esigenze.

ONNX Support

Opzione di sola lettura che mostra le informazioni sull'ambiente di esecuzione ONNX con la configurazione corrente.

Se le informazioni visualizzate non soddisfano le esigenze, è necessario modificare le opzioni Lib Variants e ONNX Runtime (Bundled) in base alle esigenze.

Mega Block > Localization Service Access [Global]

Configurazione del server di localizzazione globale per Mega Block.

Mega Landmark > Localization Service Access [Global]

Configurazione del server di localizzazione globale per Mega Landmark.

Spatial Map

Configurazione delle funzionalità della mappa spaziale di EasyAR.

Service Access [Global]

Configurazione del server di mappe sparse globale.

Image Tracking

Configurazione delle funzionalità di tracciamento delle immagini di EasyAR.

Target Gizmo

Configurazione dei Gizmos per ImageTarget nell'editor.

L'apertura di queste opzioni farà visualizzare i relativi gizmo in Unity Editor. Se nella scena sono presenti troppi target di questo tipo, potrebbe influenzare le prestazioni di avvio nell'editor. Le prestazioni durante l'esecuzione sul dispositivo non saranno influenzate.

Cloud Recognition (CRS) > Service Access [Global]

Configurazione del server di riconoscimento cloud globale.

Object Tracking

Configurazione delle funzionalità di tracciamento degli oggetti di EasyAR.

Target Gizmo

Configurazione dei Gizmos per ObjectTarget nell'editor.

  • Enable：Abilita i Gizmos.

Third-Party Libraries

Configurazione delle librerie di terze parti.

ARCore SDK

Configurazione dell'ARCore SDK.

L'ARCore fornisce la capacità di tracciamento del movimento su alcuni dispositivi Android. Puoi leggere Motion Tracking and EasyAR Features per comprendere la relazione tra le funzionalità di EasyAR e il tracciamento del movimento, nonché se e quando è necessario utilizzare l'ARCore.

  • AR Foundation Or Optional: L'ARCore SDK distribuito con EasyAR o AR Foundation verrà incluso nell'applicazione, in base alla configurazione del plugin XR di ARCore. In genere, si consiglia di utilizzare questa opzione, poiché gestirà automaticamente la situazione di AR Foundation.
  • Optional: La funzionalità ARCore è utilizzabile sui dispositivi che supportano l'ARCore e hanno installato Google Play Services for AR.
  • Required: L'applicazione potrà essere eseguita solo sui dispositivi che supportano l'ARCore e hanno installato Google Play Services for AR.
  • External: Se si utilizza AR Foundation o un'altra distribuzione dell'ARCore SDK, è possibile utilizzare questa opzione. In questo modo, l'ARCore SDK distribuito con EasyAR non verrà utilizzato. È anche possibile utilizzare questa opzione per escludere completamente l'uso dell'ARCore SDK nell'applicazione.
Attenzione

Se si imposta ARCore SDK su Required, o se si imposta Requirement su Required nella configurazione ARCore di AR Foundation e si installa l'applicazione pacchettizzata su un dispositivo che non supporta l'ARCore, il dispositivo segnalerà erroneamente che l'ARCore è disponibile e lo eseguirà. Questo creerà un'illusione, come se questi dispositivi stessero eseguendo l'ARCore e non funzionassero correttamente (schermo nero o altri problemi anomali), ma è un errore.

Questo fenomeno si verifica perché Google Play Store impedisce l'installazione di applicazioni che contrassegnano l'ARCore come necessario sui dispositivi non supportati, quindi queste applicazioni presuppongono sempre di essere in esecuzione su dispositivi supportati.

Con una configurazione normale, questi dispositivi rilevano che l'ARCore non è supportato durante l'assemblaggio della sessione e utilizzano le funzionalità di EasyAR.

Per una spiegazione dettagliata di Optional e Required e per le altre configurazioni necessarie per pubblicare un'applicazione su Google Play Store, puoi fare riferimento alle istruzioni di Google (Mainland China, International).

Nota

Nel plugin Unity di EasyAR Sense, i file di libreria e la configurazione necessari per il supporto dell'ARCore sono già inclusi nel pacchetto del plugin, ma per eseguirlo sul telefono è necessario installare Google Play Services for AR sul telefono.

Sono disponibili tre diverse fonti dell'ARCore SDK:

  • Utilizzare l'ARCore SDK distribuito con il plugin

    Il plugin integra una versione dell'ARCore SDK. Per ulteriori informazioni, puoi fare riferimento a ARCore, AR Engine Version Compatibility. Quando si utilizza l'incapsulamento ARCore di EasyAR, non è necessario importare ulteriormente AR Foundation.

  • Utilizzare l'ARCore SDK di AR Foundation

    Se è necessario utilizzare l'ARCore SDK di AR Foundation, puoi fare riferimento alle istruzioni di Google (Mainland China, International) per la configurazione. In questo caso, l'opzione ARCore SDK deve essere impostata su AR Foundation Or Optional o External.

  • Utilizzare un altro ARCore SDK

    Se si dispone di un altro plugin di terze parti o di una distribuzione dell'ARCore SDK all'interno del progetto, è possibile utilizzare questi ARCore SDK. In questo caso, l'opzione ARCore SDK deve essere impostata su External e configurata in base alle esigenze del plugin o del progetto specifico.

Warn 32-bit-only ARCore-enabled build

Secondo le istruzioni di Google, l'esecuzione di un programma con solo file di libreria armv7 su un dispositivo arm64 non farà funzionare correttamente l'ARCore. Durante la creazione del pacchetto, se non si seleziona ARM64, verrà visualizzato un avviso:

alt text

In questo caso, è necessario modificare la configurazione del progetto, utilizzare la compilazione IL2CPP e selezionare il supporto per ARM64.

alt text

Attenzione

Se necessario, è possibile selezionare Continue and don't warn me again o disabilitare quest'opzione, ciò disabiliterà il controllo durante la creazione del pacchetto. La disabilitazione del controllo non farà visualizzare il messaggio durante la creazione del pacchetto, ma potrebbe causare problemi anomali in alcuni dispositivi durante l'esecuzione, inclusi ma non limitati a crash o schermo nero.

AR Engine SDK

Configurazione dell'AR Engine SDK.

L'AR Engine fornisce la capacità di tracciamento del movimento su alcuni dispositivi Android. Puoi leggere Motion Tracking and EasyAR Features per comprendere la relazione tra le funzionalità di EasyAR e il tracciamento del movimento, nonché se e quando è necessario utilizzare l'AR Engine.

  • AREngineInterop : AREngineInterop è disponibile. L'AR Engine SDK distribuito con EasyAR verrà incluso nell'applicazione.
  • External : AREngineInterop è disponibile. L'AR Engine SDK distribuito con EasyAR non verrà utilizzato.
  • Disabled : AREngineInterop non è disponibile. L'AR Engine SDK distribuito con EasyAR non verrà utilizzato. Tutte le funzionalità correlate all'AR Engine saranno disabilitate.

ONNX Runtime (Bundled)

Se utilizzare il runtime ONNX incorporato. È valido solo quando Lib Variant è impostato su Full.

Se è necessario utilizzare una versione diversa di ONNX, è possibile ottenere la versione più recente dal sito ufficiale di ONNX e disabilitare quest'opzione. L'uso di un ONNX binario in compatibile compilato autonomamente potrebbe causare errori sconosciuti.

Workaround For Unity

Soluzioni alternative 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.