Paket | flash.ui |
Klasse | public dynamic class GameInputControl |
Vererbung | GameInputControl EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 3.7 |
Abrufen von Steuerungswerten:
Die value
-Eigenschaft gibt den aktuellen Wert eines Steuerelements zurück. Diese Methode gibt nicht den neuesten Wert direkt von der Steuerung zurück Stattdessen gibt sie den Wert zurück, der beim letzten Sampling der Steuerung im Cache gespeichert wurde.
Es gibt drei Möglichkeiten, Steuerungswerte von einer einzelnen Steuerung abzurufen:
-
Polling: Rufen Sie
value
auf, wenn Sie den letzten bekannten Wert für eine Steuerung abrufen möchten. -
Änderungsereignisse: Registrieren Sie ein Änderungsereignis für einen Controller. Das
Event.CHANGE
-Ereignis wird abgesetzt, wenn sich der Wert einer Steuerung ändert. Beim Erhalt des Ereignisses rufen Sievalue
auf, um den Wert für das Steuerelement, das das Ereignis abgesetzt hat, abzurufen. -
Zwischenspeichern von Samplewerten: Das Speichern im Cache erfolgt auf Geräteebene. Ausführliche Informationen zum Zwischenspeichern und Abrufen von gesampelten Steuerungswerten finden Sie in der Beschreibung der
GameInputDevice
-Klasse.
Wenn Sie versuchen, Steuerungswerte von einem deaktivierten Gerät zu lesen, gibt value
einen IOError
aus. Sie können jedoch auf Eigenschaften zugreifen, die ein Steuerelement beschreiben(id
, minValue
und maxValue
), auch wenn das Gerät nicht aktiviert ist. Mit dieser Funktion können Sie feststellen, ob ein Gerät die Anforderungen Ihrer Anwendung erfüllt, ohne dass Sie das Gerät zuerst aktivieren müssen.
Weitere Informationen finden Sie im Artikel zum Adobe Air Developer Center: Game controllers on Adobe AIR (Spielecontroller unter Adobe AIR).
Bei Android unterstützt diese Funktion Android OS-Versionen ab 4.1 und benötigt mindestens die SWF-Version 20 und Namespace 3.7. Bei iOS ist mindestens die iOS-Version 9.0, die SWF-Version 34 und Namespace 23.0 erforderlich.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
device : GameInputDevice [schreibgeschützt]
Gibt das GameInputDevice-Objekt zurück, das diese Steuerung enthält. | GameInputControl | ||
id : String [schreibgeschützt]
Gibt die ID dieses Steuerelements zurück. | GameInputControl | ||
maxValue : Number [schreibgeschützt]
Gibt den Maximalwert für dieses Steuerelement zurück. | GameInputControl | ||
minValue : Number [schreibgeschützt]
Gibt den Mindestwert für dieses Steuerelement zurück. | GameInputControl | ||
value : Number [schreibgeschützt]
Gibt den Wert für dieses Steuerelement zurück. | GameInputControl |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
Wird abgesetzt, wenn sich ein Steuerungswert ändert. | GameInputControl | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher |
device | Eigenschaft |
device:GameInputDevice
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 3.7 |
Gibt das GameInputDevice-Objekt zurück, das diese Steuerung enthält.
Implementierung
public function get device():GameInputDevice
id | Eigenschaft |
maxValue | Eigenschaft |
minValue | Eigenschaft |
value | Eigenschaft |
change | Ereignis |
Tue Jun 12 2018, 10:04 AM Z