| Pakiet | flash.ui |
| Klasa | public final class GameInput |
| Dziedziczenie | GameInput  EventDispatcher Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3.7 |
GameInput jest punktem wejścia interfejsu API GameInput. Za pomocą tego interfejsu API można zarządzać komunikacją pomiędzy aplikacją a urządzeniami wejściowymi do obsługi gier (takimi jak joysticki, kontrolery do gier i kontrolery ruchu).
Głównym celem tej klasy jest zapewnienie dostępu do obsługiwanych urządzeń wejściowych połączonych z daną platformą aplikacji. Ta klasa statyczna zawiera listę podłączonych urządzeń wejściowych. Dostęp do urządzenia z listy można uzyskać za pomocą metody getDeviceAt(index:int).
Właściwość numDevices wskazuje liczbę urządzeń wejściowych aktualnie podłączonych do platformy. Ta wartość pozwala określić górne ograniczenie listy urządzeń.
Za pomocą wystąpienia tej klasy można wykrywać zdarzenia powiadamiające o dodawaniu i usuwaniu urządzeń wejściowych. Aby wykrywać takie zdarzenia, należy zrealizować następujące operacje:
-
Utwórz wystąpienie klasy
GameInput. -
Dodaj detektory zdarzeń
GameInputEvent.DEVICE_ADDEDiGameInputEvent.DEVICE_REMOVED. (Zdarzenia mogą być rejestrowane tylko względem wystąpienia klasy).
Ta klasa obejmuje również flagę isSupported, która wskazuje, czy platforma obsługuje dany interfejs API GameInput.
Więcej informacji zawiera artykuł na temat kontrolerów gier w środowisku Adobe AIR dostępny w Adobe Air Developer Center: .
W przypadku systemu Android funkcja ta obsługuje system operacyjny Android w wersji 4.1 lub nowszej i wymaga plików SWF w wersji 20 lub nowszej oraz przestrzeni nazw 3.7. W przypadku systemu iOS funkcja ta obsługuje system iOS w wersji 9.0 lub nowszej i wymaga plików SWF w wersji 34 lub nowszej oraz przestrzeni nazw 23.0.
Wykrywanie konkretnego urządzenia wejściowego do obsługi gier wśród identycznych urządzeń
Typowym wymaganiem gier wieloosobowych jest rozpoznawanie konkretnego urządzenia wśród wielu identycznych urządzeń. Na przykład aplikacje muszą czasami ustalić, które urządzenie reprezentuje Gracza1, Gracza2 itd.
Rozwiązanie:
-
Do każdego elementu sterującego na wszystkich niewykrytych urządzeniach wejściowych należy dodać detektor zdarzeń. Te detektory zdarzeń wykrywają zdarzenia
Event.CHANGE, które są wywoływane za każdym razem, gdy zmienia się wartość elementu sterującego. - Przy każdym pierwszym uaktywnieniu elementu sterującego (na przykład przez naciśnięcie przycisku lub pociągnięcie spustu) aplikacja dodaje etykietę do danego urządzenia.
- Następnie należy usunąć wszystkie detektory zdarzeń z pozostałych niewykrytych urządzeń wejściowych.
- Należy powtarzać kroki 1–3 do momentu zidentyfikowania pozostałych niewykrytych urządzeń wejściowych.
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| isSupported : Boolean [statyczny] [tylko do odczytu]
Wskazuje, czy bieżąca platforma obsługuje interfejs API GameInput. | GameInput | ||
| numDevices : int [statyczny] [tylko do odczytu]
Dostarcza liczbę podłączonych urządzeń wejściowych. | GameInput | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | |
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | |
[statyczny]
Pobiera urządzenie wejściowe o określonym indeksie na liście podłączonych urządzeń wejściowych. | GameInput | ||
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
|
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher | |
| Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
|---|---|---|---|---|
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | ||
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | ||
| Wywoływane, gdy urządzenie wejściowe do obsługi gier jest podłączane do platformy lub podłączone urządzenie jest włączane. | GameInput | |||
| Wywoływane, gdy urządzenie wejściowe do obsługi gier jest usuwane z platformy lub podłączone urządzenie jest wyłączane. | GameInput | |||
| Wywoływane, gdy urządzenie wejściowe do obsługi gier jest podłączone, ale nie nadaje się do użytku. | GameInput | |||
isSupported | właściwość |
numDevices | właściwość |
getDeviceAt | () | metoda |
public static function getDeviceAt(index:int):GameInputDevice| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3.7 |
Pobiera urządzenie wejściowe o określonym indeksie na liście podłączonych urządzeń wejściowych.
Kolejność urządzeń w indeksie może ulegać zmianie przy każdym dodaniu lub usunięciu urządzenia. Zgodność właściwości name oraz id z określonym urządzeniem wejściowym można sprawdzić w obiekcie GameInputDevice.
Parametry
index:int — Indeks na liście urządzeń wejściowych.
|
GameInputDevice — Określony obiekt GameInputDevice.
|
Zgłasza
RangeError — Gdy dostarczony indeks jest mniejszy niż zero lub większy niż (numDevices - 1).
|
deviceAdded | Zdarzenie |
flash.events.GameInputEventWywoływane, gdy urządzenie wejściowe do obsługi gier jest podłączane do platformy lub podłączone urządzenie jest włączane.
deviceRemoved | Zdarzenie |
flash.events.GameInputEventWywoływane, gdy urządzenie wejściowe do obsługi gier jest usuwane z platformy lub podłączone urządzenie jest wyłączane.
deviceUnusable | Zdarzenie |
flash.events.GameInputEventWywoływane, gdy urządzenie wejściowe do obsługi gier jest podłączone, ale nie nadaje się do użytku. To zdarzenie jest specyficzne wyłącznie dla systemu Windows. Dzieje się to na przykład w przeglądarce działającej w trybie izolowanym w systemie Windows, gdy inna aplikacja korzystająca z biblioteki DirectInput używa już urządzenia.
Tue Jun 12 2018, 12:06 PM Z