Aggiungere un gruppo di frame source
Una sessione AR può contenere più componenti di origine dati fotogramma, chiamati gruppo di frame source (gruppo di origine dati fotogramma). Durante l'esecuzione, la sessione seleziona l'origine dati fotogramma più appropriata dal gruppo in base al dispositivo corrente e alle funzionalità AR abilitate. Questo articolo spiega come utilizzare e gestire un gruppo di frame source.
Inizia con
- Comprendi i concetti base, i tipi e i metodi di selezione in fase di esecuzione delle origini dati fotogramma.
Utilizza il gruppo di frame source della sessione AR preimpostata
Una sessione creata con la configurazione predefinita include un gruppo di frame source integrato, che è generalmente sufficiente quando si utilizza una singola funzionalità AR.
Le diverse sessioni preimpostate contengono origini dati fotogramma diverse.
La sessione creata con la preimpostazione ARSessionFactory.ARSessionPreset.ImageTracking o il menu
AR Session (Image Tracking Preset)contiene una singola origine dati fotogramma:
La sessione creata con la preimpostazione ARSessionFactory.ARSessionPreset.MegaBlock_MotionTracking_Inertial o il menu
AR Session (Mega Block Default Preset)contiene una struttura gerarchica di scena con più componenti di origine dati fotogramma:
Se la scena utilizza inizialmente una preimpostazione per creare la sessione, durante l'iterazione per aggiungere altre funzionalità, è necessario aggiungere sia i componenti frame filter corrispondenti che i componenti di origine dati fotogramma appropriati secondo necessità.
Importante
Dopo l'aggiornamento dalla versione 4.7 o precedente, è necessario eliminare completamente la sessione e ricrearla tramite menu o ARSessionFactory per utilizzare il gruppo di frame source preimpostato.
Di seguito sono elencati tutti i componenti sorgente frame dati predefiniti per le configurazioni di funzionalità AR preimpostate. Nota: l'ordine nella lista corrisponde all'ordine dei componenti sorgente frame dati nella scena:
| Preset | Componenti sorgente frame dati |
|---|---|
Nota
L'ordinamento dei componenti creati con le preimpostazioni garantisce l'utilizzo dell'origine dati fotogramma ottimale su tutti i dispositivi supportati dalle origini dati fotogramma integrate.
Utilizza la configurazione predefinita dell'origine dati fotogramma
Quando si utilizzano i parametri predefiniti, la configurazione dell'origine dati fotogramma viene regolata automaticamente in base al dispositivo e alle funzionalità AR abilitate in fase di esecuzione.
Se i parametri dell'origine dati fotogramma sono stati modificati manualmente, quando le funzionalità AR nella sessione cambiano (ad esempio, aggiungendo il tracciamento del movimento a una sessione che conteneva solo il tracciamento delle immagini), potrebbe essere necessario regolare manualmente i parametri dell'origine dati fotogramma per adattarli alle nuove esigenze funzionali, affinché tutte le funzionalità AR funzionino al meglio.
Importante
Dopo l'aggiornamento dalla versione 4.7 o precedente, è necessario eliminare completamente la sessione e ricrearla tramite menu o ARSessionFactory per utilizzare i parametri predefiniti corretti.
Aggiungi un gruppo di frame source
Nella vista Hierarchy, seleziona AR Session (EasyAR), fai clic con il pulsante destro del mouse e utilizza il menu EasyAR Sense > [ Funzionalità AR ] > Frame Source : * per aggiungere un componente frame source adatto a quella funzionalità. Puoi anche utilizzare il menu EasyAR Sense > Frame Source by Transform Type > * Dof > Frame Source : * per aggiungere il componente frame source necessario.
Nello script, puoi utilizzare ARSessionFactory.AddFrameSource<Source>(GameObject, bool) per aggiungere un componente frame source.
Ad esempio, tramite il menu EasyAR Sense > Frame Source by Transform Type > 3 Dof Rot-Only > Frame Source : Three Dof Camera Device puoi aggiungere un ThreeDofCameraDeviceFrameSource alla sessione attualmente selezionata.

Il codice dello script corrispondente è:
ARSessionFactory.AddFrameSource<ThreeDofCameraDeviceFrameSource>(session);
Ordina le origini dati fotogramma
Durante l'assemblaggio della sessione, solo un'origine dati fotogramma nel gruppo verrà selezionata e assemblata nella sessione. La regola di selezione dipende dal valore della proprietà AssembleOptions.FrameSourceSelection. Nella configurazione predefinita, puoi influenzare l'origine dati fotogramma finale selezionata regolando l'ordinamento dei vari componenti nel gruppo di frame source.
In genere, puoi utilizzare il metodo per ordinare gli oggetti nella scena nella vista Hierarchy spostando direttamente gli oggetti frame source per ordinarli.
Nello script, puoi utilizzare Transform.SetSiblingIndex(int) per regolare l'ordinamento degli oggetti.
Ad esempio, per posizionare MotionTrackerFrameSource prima delle altre origini dati fotogramma, seleziona l'oggetto Motion Tracker nella vista Hierarchy e trascinalo nella posizione più in alto.
Lo stesso effetto può essere ottenuto con il seguente codice dello script:
motionTrackerFrameSource.transform.SetSiblingIndex(0);
Sono disponibili anche alcuni metodi di ordinamento predefiniti. Nella vista Hierarchy, seleziona AR Session (EasyAR), fai clic con il pulsante destro del mouse e utilizza il menu EasyAR Sense > Utility > Sort Frame Source : * > * per ordinare specifici componenti di origine dati fotogramma.
Nello script, puoi utilizzare ARSessionFactory.SortFrameSource(GameObject, ARSessionFactory.FrameSourceSortMethod) per ottenere lo stesso risultato.
Ad esempio, tramite il menu EasyAR Sense > Utility > Sort Frame Source : Motion Tracker > System SLAM puoi posizionare MotionTrackerFrameSource prima di ARCoreFrameSource, ARCoreARFoundationFrameSource, ARKitFrameSource, ARKitARFoundationFrameSource e AREngineFrameSource.

Il codice dello script corrispondente è:
ARSessionFactory.SortFrameSource(session, new ARSessionFactory.FrameSourceSortMethod { MotionTracker = ARSessionFactory.FrameSourceSortMethod.MotionTrackerSortMethod.PreferEasyAR });
Dopo l'ordinamento sopra descritto, la struttura gerarchica della scena diventa:

Argomenti correlati
- Scopri come aggiungere e configurare l'origine dati fotogramma per i visori
- Prova a ottenere l'origine dati fotogramma in uso durante l'esecuzione
