Dialoogvenster — MRTK3

Dialoogvensters zijn korte ui-weergaven die contextuele app-informatie bieden. Ze vragen vaak om een actie van de gebruiker en retourneren vervolgens het resultaat terug naar de bedrijfslogica van de app in een asynchrone taak of resultaat. Gebruik dialoogvensters om gebruikers op de hoogte te stellen van belangrijke informatie of om bevestiging te vragen voordat een actie kan worden voltooid.

Als u op zoek bent naar de documentatie en gebruiksvoorbeelden van de Dialog-API, raadpleegt u de UXCore-documentatie hier.

Prefabs

MRTK3 UX Components is CanvasDialog.prefab een uitgangspunt voor het bouwen van responsieve, codegestuurde modale dialoogvensters.

De prefab dialog op basis van canvas maakt gebruik van automatische indeling om alleen de besturingselementen weer te geven die zijn aangevraagd via de IDialog Fluent Builder-API. Totdat de subbesturingselementen zijn aangevraagd door de API-aanroeper, worden ze uitgeschakeld en zijn ze niet zichtbaar in de indeling. Als gevolg hiervan is er slechts één dialoogvensterprefab nodig, in plaats van een grote verscheidenheid aan prefabs voor elke permutatie van knopopties of tekstindeling.

Als u het dialoogvenster vooraf gemaakte UX-onderdelen wilt gebruiken, moet u DialogPool ervoor zorgen dat de prefab is ingesteld op de juiste asset. U kunt de DialogPoolprefab ook tijdens runtime toewijzen via de DialogPool API, via de Get parameter of door de DialogPrefab eigenschap rechtstreeks in te stellen. Zie de documentatie voor de Dialoogvenster-API hier voor voorbeelden van het gebruik van het onderdeel DialogPool.

Ontwikkelaars kunnen ook hun eigen aangepaste dialog-prefabs bouwen. Als de aangepaste prefab dezelfde functies biedt als de basisfunctie voor dialoogvensters, zijn er geen codewijzigingen vereist en kan het basisscript Dialog worden gebruikt. Als er in de dialoogvensterweergave functies zijn toegevoegd waarvoor binding met de IDialog API is vereist (zoals nieuwe knoppen, labels of andere subbesturingselementen), is een subklasse-implementatie van IDialog vereist. Zorg er bij het bouwen van een aangepaste prefab voor dat naar de verschillende subbesturingselementen is verwezen op de IDialog MonoBehaviour, anders worden ze niet correct gebonden of gehydrateerd.

Voorbeeldscènes

Zie DialogExample.unity voor voorbeelden van het spawn van dialoogvensters. Zie de UXCore-documentatie hier voor meer informatie, codevoorbeelden en details.