Okno dialogowe — MRTK3

Okna dialogowe to krótkotrwałe widoki interfejsu użytkownika, które zapewniają kontekstowe informacje o aplikacji. Często żądają pewnej akcji od użytkownika, a następnie zwracają wynik z powrotem do logiki biznesowej aplikacji w asynchronicznym zadaniu lub wyniku. Użyj okien dialogowych, aby powiadomić użytkowników o ważnych informacjach lub potwierdzeniu żądania przed ukończeniem akcji.

Jeśli szukasz dokumentacji interfejsu API okna dialogowego i przykładów użycia, zapoznaj się z dokumentacją dotyczącą rdzenia użytkownika tutaj.

Prefabs

Składniki środowiska użytkownika MRTK3 są CanvasDialog.prefab punktem wyjścia do tworzenia dynamicznych, modalnych okien dialogowych opartych na kodzie.

Prefab okna dialogowego opartego na kanwie używa automatycznego układu do wyświetlania tylko kontrolek żądanych za pośrednictwem płynnego interfejsu IDialog API konstruktora. Dopóki podkontrole nie zostaną żądane przez obiekt wywołujący interfejs API, zostaną one wyłączone i nie będą widoczne w układzie. W związku z tym potrzebny jest tylko jeden prefab okna dialogowego zamiast szerokiej gamy prefab dla każdej permutacji opcji przycisku lub układu tekstu.

Aby użyć wstępnie utworzonego okna dialogowego Składniki środowiska użytkownika, upewnij się, że DialogPool prefab jest ustawiony na prawidłowy element zawartości. Prefab w czasie wykonywania można również przypisać DialogPoolza pomocą interfejsu DialogPool API za pośrednictwem parametru GetDialogPrefab lub bezpośrednio ustawiając właściwość . Zapoznaj się z dokumentacją interfejsu API okna dialogowego tutaj, aby zapoznać się z przykładami użycia składnika DialogPool.

Deweloperzy mogą również tworzyć własne niestandardowe prefabryki okien dialogowych. Jeśli niestandardowa prefab oferuje te same funkcje co podstawowe funkcje okna dialogowego, nie są wymagane żadne zmiany kodu i można użyć skryptu podstawowego Dialog . Jeśli w widoku okna dialogowego są dodane funkcje, które wymagają powiązania z interfejsem IDialog API (na przykład nowe przyciski, etykiety lub inne podkontrolery), wymagana będzie podklasowana implementacja IDialog elementu . Podczas tworzenia niestandardowej prefabrykatu upewnij się, że różne podkontrole zostały prawidłowo przywoływane na IDialog serwerze MonoBehaviour lub w przeciwnym razie nie zostaną prawidłowo powiązane ani nawilżone.

Przykładowe sceny

Zobacz DialogExample.unity przykłady sposobu duplikowania okien dialogowych. Aby uzyskać więcej informacji, przykłady kodu i szczegóły, zobacz dokumentację dotyczącą rdzenia użytkownika tutaj.