Utilizzo dello strumento di verifica della session

Questo articolo spiega come utilizzare lo strumento di verifica della session per convalidare rapidamente il flusso di lavoro della session nell'editor e simulare l'esecuzione utilizzando file EIF.

Prima di iniziare

La simulazione utilizza file EIF come input, quindi prima di iniziare è necessario registrare un file EIF:

• Fare riferimento a Registrazione di un file EIF per registrare un file EIF

Inoltre, è necessario conoscere:

• I concetti di base di Registrazione di file EIF e simulazione
• I concetti fondamentali, la composizione e il flusso di lavoro di AR Session

Lo strumento di verifica della session

Lo strumento di verifica della session aiuta gli sviluppatori a convalidare rapidamente il flusso di lavoro della session nell'editor di Unity e a simulare l'esecuzione utilizzando file EIF.

Per impostazione predefinita, è possibile vedere lo strumento di verifica della session nella finestra Inspector dell'oggetto AR Session (EasyAR). Fa parte dell'editor di DiagnosticsController:

Facendo clic sul pulsante ↗ in alto a destra dello strumento, è possibile estrarlo come finestra indipendente per una visualizzazione e un'operazione più comode. Quando la finestra viene chiusa o si preme il pulsante ↘, lo strumento tornerà a essere visualizzato nella finestra Inspector.

L'effetto durante l'esecuzione dello strumento è mostrato in questo video:

Questo video mostra l'utilizzo dello strumento di verifica della session, registrato in modalità play di Unity. La parte superiore del video mostra a sinistra la vista Hierarchy, al centro la vista Scene e a destra la vista Game. La parte inferiore del video mostra lo strumento di verifica della session. Il contenuto della vista Game è lo stesso che l'utente vedrebbe nel mondo reale sul telefono.

Nella parte in alto a sinistra dello strumento viene mostrata la barra di avanzamento della riproduzione EIF, che cambia man mano che la riproduzione procede. Nella parte in basso a sinistra dello strumento viene mostrato lo stato corrente della session. Sulla destra dello strumento vengono mostrati i componenti della session e le modalità di centro disponibili.

Nella scena, è possibile vedere tre funzionalità AR che funzionano contemporaneamente:

• Motion tracking: fornito dal frame player, la sfera blu è XR Origin e il cono blu rappresenta la posizione dell'utente.
• Dense spatial mapping: si possono vedere mesh semitrasparenti che vengono generate continuamente man mano che la visuale si sposta.
• Sparse spatial tracking: nel video viene tracciato un albero di Natale, con gli oggetti virtuali sovrapposti rappresentati da una nuvola di punti azzurra.

Avvio dello strumento

Fare clic sul pulsante ▶ nella parte superiore dello strumento per avviarlo. Premere questo pulsante ha lo stesso effetto di premere il pulsante ▶ nella barra degli strumenti di Unity.

Se lo strumento è già avviato, il pulsante diventa ■ e facendo clic su di esso si interrompe lo strumento.

Quando lo strumento è visualizzato come finestra indipendente, la casella di selezione a destra del pulsante ▶ consente di selezionare l'oggetto session utilizzato dallo strumento. Se la finestra viene reimpostata e la session viene persa, è possibile selezionarla nuovamente da qui.

Controllo della riproduzione EIF

Per utilizzare la funzionalità di riproduzione EIF dello strumento, è necessario selezionare l'opzione Frame Player dello strumento prima dell'esecuzione. In questo caso, lo strumento gestirà la selezione della sorgente dei frame durante l'assemblaggio della session. Indipendentemente dal valore impostato per AssembleOptions.FrameSource, verrà abilitato il componente frame player.

Pertanto, durante l'esecuzione verrà visualizzato un popup che indica che l'attuale sorgente dei frame della session è gestita dallo strumento:

Nota

Lo strumento gestisce la selezione della sorgente dei frame solo nell'editor di Unity. Questa opzione non ha alcun effetto quando l'applicazione viene eseguita in versione compilata.

Durante un'esecuzione normale, la funzionalità di controllo della riproduzione EIF viene visualizzata nella parte superiore dello strumento, come evidenziato nell'immagine:

È possibile controllare la riproduzione del file EIF utilizzando questi pulsanti:

• ▶: Riproduci, riprende la riproduzione da uno stato di pausa o stop
• ▮▮: Pausa
• ■: Stop
• ▮◀: Salta indietro di 5 secondi (se supportato dal file)
• ◀◀: Riduce la velocità di riproduzione (se supportato dal file)
• ▶▶: Aumenta la velocità di riproduzione (se supportato dal file)
• ▶▮: Salta avanti di 5 secondi (se supportato dal file)
• ▲: Apri file
• Barra di avanzamento: Fare clic per saltare a una posizione di riproduzione (se supportato dal file)

È possibile regolare i contenuti e la logica di interazione nella scena durante la riproduzione, consentendo di svolgere la maggior parte dello sviluppo sul computer e vedere i risultati in modo visivo.

Nota

Durante la riproduzione di nuovi dati o il salto di posizione, i dati esistenti nella scena non vengono cancellati. Lo stato dei componenti AR non viene reimpostato e si comporteranno come se i dati della fotocamera fossero improvvisamente passati dal frame precedente ai nuovi dati.

Sebbene ciò non abbia un grande impatto su alcune funzionalità, per funzionalità che dipendono dal motion tracking (come dense spatial mapping, Mega, ecc.), potrebbe causare uno stato anomalo della funzionalità, influenzando l'esecuzione.

Controllo del flusso di lavoro della session

Per utilizzare la funzionalità di controllo del flusso di lavoro della session dello strumento, è necessario selezionare l'opzione Session Workflow dello strumento prima dell'esecuzione. Questa opzione è selezionata per impostazione predefinita.

Durante un'esecuzione normale, la funzionalità di controllo del flusso di lavoro della session viene visualizzata sotto il controllo di riproduzione dello strumento, come evidenziato nell'immagine:

Nella parte superiore dell'area, vengono mostrate le informazioni sullo stato di EasyARController.IsReady e ARSession.State.

Nella parte inferiore dell'area, vengono forniti questi pulsanti per controllare il flusso di lavoro della session:

• Initialize: Inizializza la session, è possibile scegliere di utilizzare la chiave di licenza configurata in Project Settings o inserirla manualmente
• Assemble: Assembla ma non avvia la session
• StartSession (Assembled): Avvia la session assemblata
• StartSession: Assembla e avvia la session
• StopSession: Interrompe la session
• StopSession (keep image): Interrompe la session, ma mantiene lo sfondo dell'immagine
• Deinitialize: Deinizializza la session

Nota

Poiché queste funzionalità di controllo chiamano direttamente i metodi rilevanti di ARSession e EasyARController, è possibile utilizzare questi pulsanti per verificare l'impatto dei cambiamenti di stato della session sui contenuti. Tuttavia, è importante notare che se l'applicazione chiama metodi simili nei suoi script, il flusso di esecuzione dell'applicazione potrebbe andare oltre le aspettative dell'applicazione stessa.

Controllo dei componenti della session

Per utilizzare la funzionalità di controllo dei componenti della session dello strumento, è necessario selezionare l'opzione Session Workflow dello strumento prima dell'esecuzione. Questa opzione è selezionata per impostazione predefinita.

Durante un'esecuzione normale, il controllo dei componenti della session viene visualizzato nella parte inferiore o destra dello strumento, come evidenziato nell'immagine, con la posizione esatta che varia a seconda della larghezza della finestra:

Il contenuto di questa area dipende dalla session specifica. Ad esempio, nell'immagine sopra, la session utilizzata include tre componenti funzionali: image tracking, dense spatial mapping e sparse spatial tracking, quindi lo strumento mostra le caselle di controllo per queste tre funzionalità.

In generale, questa area mostra tutti i componenti funzionali AR disponibili nella session e fornisce il controllo di abilitazione/disabilitazione (enabled) per questi componenti, tra cui:

• AR Session: controlla l'abilitazione/disabilitazione della session stessa
• Image Renderer: controlla l'abilitazione/disabilitazione del rendering dell'immagine della fotocamera fisica
• Camera: controlla l'abilitazione/disabilitazione della fotocamera virtuale
• Frame Source: controlla l'abilitazione/disabilitazione della sorgente dei frame, controllabile solo quando frame player non è abilitato. Quando frame player è abilitato, il controllo funzionale è sostituito dalla parte di controllo della riproduzione EIF
• Frame Filter: controlla l'abilitazione/disabilitazione di specifiche funzionalità AR
• Frame Recorder: controlla l'abilitazione/disabilitazione del componente di registrazione EIF, visibile solo quando frame player non è abilitato. Quando frame player è abilitato, questo componente non viene assemblato nella session

Nell'area vengono inoltre mostrate le modalità di centro disponibili per la session e il report della session.

Nota

Le modalità di centro disponibili e il report della session mostrati nello strumento sono il risultato dell'esecuzione nell'editor e saranno diversi durante l'esecuzione su dispositivi reali.

Argomenti correlati

• Prova Simulazione con file EIF per controllare la riproduzione dei file EIF tramite script
• Prova a controllare l'esecuzione della session negli script Controllo dell'esecuzione della session
• Prova ad accedere ai componenti funzionali AR negli script Componenti della session
• Prova a ottenere i risultati dell'esecuzione della session negli script Output della session
• Prova l'inizializzazione negli script Inizializzazione
• Prova a ottenere il report della session e determinare il supporto del dispositivo negli script Assemblaggio della session