| Pacchetto | flash.ui |
| Classe | public final class GameInput |
| Ereditarietà | GameInput  EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3.7 |
GameInput è il punto di ingresso dell'API GameInput. Potete usare questo API per gestire le comunicazioni tra un'applicazione e dispositivi di input di gioco (ad esempio: joystick, gamepad e bacchette).
Lo scopo principale di questa classe è fornire accesso ai dispositivi di input supportati collegati alla piattaforma dell'applicazione. Questa classe statica enumera i dispositivi di input collegati in un elenco. Per accedere a un dispositivo dall'elenco, utilizzate il metodo getDeviceAt(index:int).
La proprietà numDevices indica il numero di dispositivi di input attualmente connessi alla piattaforma. Usate questo valore per determinare il limite superiore dell'elenco di dispositivi.
Utilizzate un'istanza di questa classe per intercettare eventi che segnalano l'aggiunta e la rimozione di dispositivi di input. Per intercettare questi eventi, procedete come segue:
-
Create un'istanza della classe
GameInput. -
Aggiungete listener di eventi per gli eventi
GameInputEvent.DEVICE_ADDEDeGameInputEvent.DEVICE_REMOVED. (Gli eventi possono essere registrati solo su un'istanza della classe.)
Questa classe presenta anche il contrassegno isSupported, che indica se l'API GameInput è supportato dalla piattaforma.
Per ulteriori informazioni, vedete l'articolo nel centro sviluppatori per Adobe Air: Game controllers on Adobe AIR (controller per giochi in Adobe AIR).
Per Android, questa funzione supporta Android OS 4.1 e versioni successive e richiede almeno SWF versione 20 e namespace 3.7. Per iOS, questa funzione supporta iOS 9.0 e versioni successive e richiede almeno SWF versione 34 e namespace 23.0.
Come rilevare un dispositivo di input di gioco tra dispositivi identici
Un requisito comune ai giochi a due o più giocatori è la possibilità di rilevare uno specifico dispositivo tra una serie di dispositivi identici. Ad esempio, le applicazioni talvolta devono determinare quale dispositivo rappresenta "Player 1", "Player 2", ..., "Player N".
Soluzione:
-
Aggiungete listener di eventi per ogni controllo su tutti i dispositivi di input non rilevati. Questi listener di eventi intercettano eventi
Event.CHANGE, che vengono inviati ogni volta che il valore di un controllo viene modificato. - La prima volta che un qualsiasi controllo viene attivato (ad esempio, la pressione di un pulsante o l'attivazione di un interruttore), l'applicazione assegna un'etichetta a tale dispositivo.
- Rimuovete tutti i listener di eventi dai rimanenti dispositivi di input non rilevati.
- Ripetete i passaggi 1-3 in base alle necessità, per identificare i restanti dispositivi di input non rilevati.
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| isSupported : Boolean [statico] [sola lettura]
Indica se la piattaforma corrente supporta l’API GameInput. | GameInput | ||
| numDevices : int [statico] [sola lettura]
Fornisce il numero di dispositivi di input collegati. | GameInput | ||
| Metodo | Definito da | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
[statico]
Porta il dispositivo di input nella posizione di indice specificata nell'elenco dei dispositivi di input collegati. | GameInput | ||
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | ||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| Inviato quando un dispositivo di input di gioco viene collegato alla piattaforma o quando un dispositivo collegato viene acceso. | GameInput | |||
| Inviato quando un dispositivo di input di gioco viene rimosso dalla piattaforma o quando un dispositivo collegato viene spento. | GameInput | |||
| Inviato quando un dispositivo di input di gioco è collegato, ma non utilizzabile. | GameInput | |||
isSupported | proprietà |
numDevices | proprietà |
getDeviceAt | () | metodo |
public static function getDeviceAt(index:int):GameInputDevice| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3.7 |
Porta il dispositivo di input nella posizione di indice specificata nell'elenco dei dispositivi di input collegati.
L'ordine dei dispositivi nell'indice può cambiare ogni volta che un dispositivo viene aggiunto o rimosso. Potete verificare se le proprietà name e id di un oggetto GameInputDevice corrispondono a un dispositivo di input specifico.
Parametri
index:int — La posizione di indice nell'elenco dei dispositivi di input.
|
GameInputDevice — Il GameInputDevice specificato.
|
Genera
RangeError — Se l'indice fornito è inferiore a zero o superiore a (numDevices - 1).
|
deviceAdded | Evento |
flash.events.GameInputEventInviato quando un dispositivo di input di gioco viene collegato alla piattaforma o quando un dispositivo collegato viene acceso.
deviceRemoved | Evento |
flash.events.GameInputEventInviato quando un dispositivo di input di gioco viene rimosso dalla piattaforma o quando un dispositivo collegato viene spento.
deviceUnusable | Evento |
flash.events.GameInputEventInviato quando un dispositivo di input di gioco è collegato, ma non utilizzabile. Questo evento è specifico per Windows. Ad esempio, questo si verifica in un browser sandbox Windows quando un’altra applicazione DirectInput sta già utilizzando il dispositivo.
Tue Jun 12 2018, 02:44 PM Z