Finestra di dialogo - MRTK3
Le finestre di dialogo sono visualizzazioni dell'interfaccia utente di breve durata che forniscono informazioni contestuali sull'app. Spesso richiedono un'azione da parte dell'utente e quindi restituiscono il risultato alla logica di business dell'app in un'attività o un risultato asincrono. Usare le finestre di dialogo per notificare agli utenti informazioni importanti o richiedere la conferma prima del completamento di un'azione.
Per gli esempi di utilizzo e documentazione dell'API Dialog, vedere la documentazione di UXCore qui.
Oggetti prefab
I componenti dell'esperienza utente MRTK3 forniscono CanvasDialog.prefab
come punto di partenza per la creazione di dialoghi modali basati su codice reattivi.
Il prefab Dialog basato su canvas usa il layout automatico per visualizzare solo i controlli richiesti tramite l'API IDialog
fluent builder. Finché i sottocontrolli non vengono richiesti dal chiamante API, verranno disabilitati e non saranno visibili nel layout. Di conseguenza, è necessario un solo prefab dialog, invece di un'ampia gamma di prefab per ogni permutazione di opzioni di pulsante o layout di testo.
Per usare la finestra di dialogo Componenti dell'esperienza utente predefinita, assicurarsi che DialogPool
il prefab sia impostato sull'asset corretto. È anche possibile assegnare il DialogPool
prefab in fase di esecuzione tramite l'API DialogPool
, tramite il Get
parametro o impostando direttamente la DialogPrefab
proprietà.
Per esempi sull'uso del componente DialogPool, vedere la documentazione dell'API Dialog qui.
Gli sviluppatori possono anche creare prefab dei dialoghi personalizzati. Se il prefab personalizzato offre le stesse funzionalità della funzionalità finestra di dialogo di base, non sono necessarie modifiche al codice e lo script di base Dialog
può essere usato. Se sono state aggiunte funzionalità nella visualizzazione Finestra di dialogo che richiedono l'associazione all'API IDialog
,ad esempio nuovi pulsanti, etichette o altri sottocontrolli, sarà necessaria un'implementazione sottoclassata di IDialog
. Quando si crea un prefab personalizzato, assicurarsi che i vari sottocontrolli siano stati correttamente referenziati in IDialog
MonoBehaviour oppure che non siano associati o idratati correttamente.
Scene di esempio
Vedere DialogExample.unity
per esempi su come generare dialoghi. Per altre informazioni, esempi di codice e dettagli, vedere la documentazione di UXCore qui.