| Pakket | flash.ui |
| Klasse | public final class GameInput |
| Overerving | GameInput  EventDispatcher Object |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 3.7 |
GameInput-klasse is het ingangspunt voor de GameInput-API. U kunt deze API gebruiken om de communicatie tussen een toepassing en spelbesturingsapparaten (zoals joysticks, gamepads en leespennen) te beheren.
Het belangrijkste doel van deze klasse is toegang te bieden tot de ondersteunde invoerapparaten die verbonden zijn met uw toepassingsplatform. Deze statische klasse verschaft een lijst met de aangesloten invoerapparaten. Met de methode getDeviceAt(index:int) krijgt u toegang tot een apparaat in de lijst.
De eigenschap numDevices geeft het aantal invoerapparaten op dat momenteel met uw platform is verbonden. Gebruik deze waarde om de bovengrens van de lijst met apparaten te bepalen.
Gebruik een instantie van deze klasse om naar gebeurtenissen te luisteren die u op de hoogte stellen van het toevoegen en verwijderen van invoerapparaten. Ga als volgt te werk om naar deze gebeurtenissen te luisteren:
-
Maak een instantie van de klasse
GameInput. -
Voeg gebeurtenislisteners toe voor de gebeurtenissen
GameInputEvent.DEVICE_ADDEDenGameInputEvent.DEVICE_REMOVED. (Gebeurtenissen kunnen alleen op een instantie van de klasse worden geregistreerd.)
Deze klasse bevat ook de isSupported-markering, die aangeeft op de GameInput-API op uw platform wordt ondersteund.
Raadpleeg voor meer informatie het Adobe AIR Developer Center-artikel:Spelbesturingen op Adobe AIR.
Voor Android biedt deze functie ondersteuning voor Android OS-versies vanaf 4.1 en wordt SWF-versie 20 of hoger en een naamruimteversie van 3.7 of hoger vereist. Voor iOS biedt deze functie ondersteuning voor iOS-versies vanaf 9.0 en wordt SWF-versie 34 of hoger en een naamruimteversie van 23.0 of hoger vereist.
Hoe één spelbesturingsapparaat detecteren tussen identieke apparaten
Een algemene vereiste voor spelletjes voor twee of meer spelers is het detecteren van één apparaat tussen identieke apparaten. Toepassingen bijvoorbeeld moeten soms bepalen welk apparaat "Speler 1", "Speler 2", ..., "Speler N" vertegenwoordigt.
Oplossing:
-
Voeg gebeurtenislisteners toe aan elk besturingselement op alle niet-gedetecteerde invoerapparaten. Deze gebeurtenislisteners luisteren naar
Event.CHANGE-gebeurtenissen, die worden verzonden wanneer de waarde van een besturingselement wijzigt. - Wanneer een besturingselement voor de eerste maal wordt geactiveerd (bijvoorbeeld door een druk op een knop of het opnemen van een trigger), wordt het apparaat gelabeld door de toepassing.
- Verwijder alle gebeurtenislisteners van de resterende niet-gedetecteerde invoerapparaten.
- Herhaal indien nodig stappen 1-3 om de rest van de niet-gedetecteerde invoerapparaten te identificeren.
Verwante API-elementen
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
 | constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | |
| isSupported : Boolean [statisch] [alleen-lezen]
Geeft op of het huidige platform de GameInput-API ondersteunt. | GameInput | ||
| numDevices : int [statisch] [alleen-lezen]
Geeft het aantal verbonden invoerapparaten op. | GameInput | ||
| Methode | Gedefinieerd door | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | |
|
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | |
[statisch]
Haalt het invoerapparaat op de opgegeven indexlocatie op in de lijst met verbonden invoerapparaten. | GameInput | ||
|
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | |
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | |
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
|
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | |
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
|
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher | |
| Gebeurtenis | Overzicht | Gedefinieerd door | ||
|---|---|---|---|---|
| [uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | ||
| [uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | ||
| Wordt verzonden wanneer een spelbesturingsapparaat van uw platform wordt verwijderd, of wanneer een apparaat dat al verbonden is, wordt ingeschakeld. | GameInput | |||
| Wordt verzonden wanneer een spelbesturingsapparaat van uw platform wordt verwijderd, of wanneer een verbonden apparaat wordt uitgeschakeld. | GameInput | |||
| Wordt verzonden wanneer een spelbesturingsapparaat is aangesloten, maar niet bruikbaar is. | GameInput | |||
isSupported | eigenschap |
numDevices | eigenschap |
getDeviceAt | () | methode |
public static function getDeviceAt(index:int):GameInputDevice| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 3.7 |
Haalt het invoerapparaat op de opgegeven indexlocatie op in de lijst met verbonden invoerapparaten.
De volgorde van apparaten in de index kan wijzigen wanneer een apparaat wordt toegevoegd of verwijderd. U kunt de eigenschappen name en id op een GameInputDevice-object controleren om een overeenkomst te krijgen met een specifiek invoerapparaat.
Parameters
index:int — De indexpositie in de lijst met invoerapparaten.
|
GameInputDevice — Het opgegeven GameInputDevice.
|
Gegenereerde uitzondering
RangeError — Wanneer de opgegeven index kleiner dan nul is of groter dan (numDevices - 1).
|
deviceAdded | Gebeurtenis |
flash.events.GameInputEventWordt verzonden wanneer een spelbesturingsapparaat van uw platform wordt verwijderd, of wanneer een apparaat dat al verbonden is, wordt ingeschakeld.
deviceRemoved | Gebeurtenis |
flash.events.GameInputEventWordt verzonden wanneer een spelbesturingsapparaat van uw platform wordt verwijderd, of wanneer een verbonden apparaat wordt uitgeschakeld.
deviceUnusable | Gebeurtenis |
flash.events.GameInputEventWordt verzonden wanneer een spelbesturingsapparaat is aangesloten, maar niet bruikbaar is. Deze gebeurtenis is specifiek voor alleen Windows. Dit gebeurt bijvoorbeeld in een in een sandbox geplaatste browser in Windows wanneer een andere op DirectInput gebaseerde toepassing het apparaat al gebruikt.
Wed Jun 13 2018, 11:42 AM Z