GameInputControl - Adobe ActionScript® 3 (AS3 )

Pakiet	flash.ui
Klasa	public dynamic class GameInputControl
Dziedziczenie	GameInputControl EventDispatcher Object

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 3.7

Klasa GameInputControl reprezentuje element sterujący urządzenia wejściowego. Interfejs API GameInput odwzorowuje fizyczne elementy sterujące urządzenia na proste logiczne elementy sterujące.

Pobieranie wartości elementów sterujących:

Właściwość value zwraca bieżącą wartość elementu sterującego. Ta metoda nie zwraca najnowszej wartości bezpośrednio z elementu sterującego. Zwraca ona wartość zapisaną w buforze podczas ostatniego próbkowania elementu sterującego.

Istnieją trzy sposoby uzyskiwania wartości elementu sterującego z pojedynczego elementu sterującego:

Próbkowanie: Aby pobrać najnowszą znaną wartość elementu sterującego, w dowolnym momencie można odczytać właściwość value.
Zdarzenia zmian: Dla elementu sterującego należy zarejestrować zdarzenie dotyczące zmiany. Przy każdej zmianie wartości elementu sterującego jest wywoływane zdarzenie Event.CHANGE. Po otrzymaniu zdarzenia należy odczytać właściwość value, aby pobrać wartość elementu sterującego, który wywołał to zdarzenie.
Buforowanie wartości próbkowania: Buforowanie jest wykonywane na poziomie urządzenia. Szczegółowe informacje o buforowaniu i pobieraniu próbkowanych wartości elementów sterujących można znaleźć w dokumentacji klasy GameInputDevice.

Próba odczytania wartości elementów sterujących z wyłączonego urządzenia powoduje, że wywołanie metody value generuje błąd IOError. Dostęp do właściwości opisujących element sterujący ( id, minValue i maxValue) można uzyskać nawet wtedy, gdy urządzenie nie jest włączone. Ta funkcja umożliwia ustalenie, czy dane urządzenie spełnia wymagania aplikacji — bez konieczności uprzedniego włączania tego urządzenia.

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.

Powiązane elementy interfejsu API

flash.ui.GameInput
flash.ui.GameInputDevice
flash.events.GameInputEvent

Właściwości publiczne

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
		device : GameInputDevice [tylko do odczytu] Zwraca obiekt GameInputDevice, który zawiera ten element sterujący.	GameInputControl
		id : String [tylko do odczytu] Zwraca identyfikator elementu sterującego.	GameInputControl
		maxValue : Number [tylko do odczytu] Zwraca maksymalną wartość elementu sterującego.	GameInputControl
		minValue : Number [tylko do odczytu] Zwraca minimalną wartość elementu sterującego.	GameInputControl
		value : Number [tylko do odczytu] Zwraca wartość elementu sterującego.	GameInputControl

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	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
		dispatchEvent(event:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	EventDispatcher
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	EventDispatcher
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Usuwa detektor z obiektu EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		willTrigger(type:String):Boolean Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.	EventDispatcher

Zdarzenia

Kliknij, aby uzyskać więcej informacji o zdarzeniach

Ukryj zdarzenia dziedziczone

Pokaż zdarzenia dziedziczone

	Podsumowanie	Zdefiniowane przez
activate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.	EventDispatcher
change	Wywoływane w momencie zmiany wartości elementu sterującego.	GameInputControl
deactivate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.	EventDispatcher

Szczegół właściwości

device

właściwość

device:GameInputDevice [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 3.7

Zwraca obiekt GameInputDevice, który zawiera ten element sterujący.

Implementacja
public function get device():GameInputDevice

id

właściwość

id:String [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 3.7

Zwraca identyfikator elementu sterującego.

Implementacja
public function get id():String

maxValue

właściwość

maxValue:Number [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 3.7

Zwraca maksymalną wartość elementu sterującego.

Implementacja
public function get maxValue():Number

minValue

właściwość

minValue:Number [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 3.7

Zwraca minimalną wartość elementu sterującego.

Implementacja
public function get minValue():Number

value

właściwość

value:Number [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 3.7

Zwraca wartość elementu sterującego.

Implementacja
public function get value():Number

Zgłasza

IOError — Gdy metoda value jest wywoływana, kiedy urządzenie jest wyłączone.

Szczegół zdarzenia

change

Zdarzenie

Typ obiektu zdarzenia: flash.events.Event

Wywoływane w momencie zmiany wartości elementu sterującego.

Informacje prawne | Zasady prywatności online

GameInputControl - AS3

Klasy x

device

id

maxValue

minValue

value

change