Boîte de dialogue — MRTK3

Les boîtes de dialogue sont des vues d’interface utilisateur de courte durée qui fournissent des informations contextuelles sur l’application. Ils demandent souvent une action à l’utilisateur, puis retournent le résultat à la logique métier de l’application dans une tâche ou un résultat asynchrone. Utilisez des boîtes de dialogue pour informer les utilisateurs des informations importantes ou demander une confirmation avant qu’une action ne puisse être effectuée.

Si vous recherchez la documentation et des exemples d’utilisation de l’API Dialog, consultez la documentation UXCore ici..

Prefabs

Les composants d’expérience utilisateur MRTK3 fournissent CanvasDialog.prefab un point de départ pour la création de dialogues modals réactifs pilotés par le code.

Le préfabriqué de la boîte de dialogue basé sur un canevas utilise la disposition automatique pour afficher uniquement les contrôles demandés via l’API IDialog Fluent Builder. Tant que les sous-contrôle ne sont pas demandés par l’appelant d’API, ils sont désactivés et ne sont pas visibles dans la disposition. Par conséquent, un seul préfabriqué de dialogue est nécessaire, au lieu d’une grande variété de préfabriqués pour chaque permutation d’options de bouton ou de disposition de texte.

Pour utiliser la boîte de dialogue Composants d’expérience utilisateur prédéfinis, vérifiez que votre DialogPool préfabriqué est défini sur la ressource appropriée. Vous pouvez également affecter le DialogPoolpréfabriqué au moment de l’exécution via l’API DialogPool , soit via le Get paramètre, soit en définissant directement la DialogPrefab propriété. Consultez la documentation de l’API Dialog ici pour obtenir des exemples d’utilisation du composant DialogPool.

Les développeurs peuvent également créer leurs propres préfabriqués de dialogue personnalisés. Si le préfabriqué personnalisé offre les mêmes fonctionnalités que la fonctionnalité De dialogue de base, aucune modification du code n’est requise et le script de base Dialog peut être utilisé. S’il existe des fonctionnalités ajoutées dans la vue Boîte de dialogue qui nécessitent une liaison à l’API IDialog (comme de nouveaux boutons, étiquettes ou autres sous-contrôles), une implémentation sous-classée de IDialog sera requise. Lors de la création d’un préfabriqué personnalisé, vérifiez que les différents sous-contrôles ont été correctement référencés sur le IDialog MonoBehaviour, sinon ils ne seront pas liés ou hydratés correctement.

Exemples de scènes

Consultez DialogExample.unity pour obtenir des exemples sur la façon de générer des dialogues. Pour plus d’informations, des exemples de code et des détails, consultez la documentation UXCore ici..