Freigeben über

Dialog — MRTK3

  • Artikel

Dialogfeld

Dialoge sind kurzlebige Benutzeroberflächenansichten, die kontextbezogene App-Informationen bereitstellen. Sie fordern häufig eine Aktion vom Benutzer an und geben das Ergebnis dann in einer asynchronen Aufgabe oder einem asynchronen Ergebnis an die Geschäftslogik der App zurück. Verwenden Sie Dialogfelder, um Benutzer über wichtige Informationen zu informieren oder eine Bestätigung anzufordern, bevor eine Aktion abgeschlossen werden kann.

Wenn Sie die Dokumentation zur Dialog-API und Die Verwendungsbeispiele suchen, lesen Sie hier die UXCore-Dokumentation.

Prefabs

MRTK3-UX-Komponenten bieten CanvasDialog.prefab als Ausgangspunkt für die Erstellung reaktionsfähiger, codegesteuerter modaler Dialoge.

Das Canvas-basierte Dialog-Prefab verwendet das automatische Layout, um nur die Steuerelemente anzuzeigen, die über die IDialog Fluent Builder-API angefordert werden. Bis die Untersteuerelemente vom API-Aufrufer angefordert werden, werden sie deaktiviert und sind im Layout nicht sichtbar. Daher wird nur ein Dialog-Prefab anstelle einer Vielzahl von Prefabs für jede Permutation von Schaltflächenoptionen oder Textlayout benötigt.

Um das vorgefertigte Dialogfeld UX-Komponenten zu verwenden, stellen Sie sicher, dass das DialogPool Prefab auf das richtige Medienobjekt festgelegt ist. Sie können das Prefab des DialogPool-Objekts zur Laufzeit auch über die DialogPool API zuweisen, entweder über den Get -Parameter oder durch direktes Festlegen der DialogPrefab -Eigenschaft. Beispiele für die Verwendung der DialogPool-Komponente finden Sie hier in der Dialog-API-Dokumentation.

Entwickler können auch eigene benutzerdefinierte Dialog-Prefabs erstellen. Wenn das benutzerdefinierte Prefab dieselben Features wie die Basisfunktion dialog bietet, sind keine Codeänderungen erforderlich, und das Basisskript Dialog kann verwendet werden. Wenn in der Dialogansicht Features hinzugefügt werden, die eine Bindung an die IDialog API erfordern (z. B. neue Schaltflächen, Bezeichnungen oder andere Untersteuerelemente), ist eine unterklassierte Implementierung von IDialog erforderlich. Stellen Sie beim Erstellen eines benutzerdefinierten Prefabs sicher, dass auf die verschiedenen Untersteuerelemente ordnungsgemäß auf monoBehaviour IDialog verwiesen wurde, da sie andernfalls nicht ordnungsgemäß gebunden oder hydratisiert werden.

Beispielszenen

Beispiele zum Erstellen von Dialogen finden Sie DialogExample.unity unter . Weitere Informationen, Codebeispiele und Details finden Sie in der UXCore-Dokumentation.