GameInputControl - Guida di riferimento alle API Adobe ActionScript® 3 (AS3 )

Pacchetto	flash.ui
Classe	public dynamic class GameInputControl
Ereditarietà	GameInputControl EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 3.7

La classe GameInputControl rappresenta un controllo su un dispositivo di input. L’API GameInput mappa i controlli fisici di un dispositivo su controlli logici semplici.

Ottenimento di valori dei controlli:

La proprietà value restituisce il valore corrente di un controllo. Questo metodo non restituisce il valore più recente direttamente dal controllo. Al contrario, restituisce il valore che è stato memorizzato nella cache l'ultima volta che il controllo è stato campionato.

Per ottenere i valori dei controlli da un singolo controllo, è possibile procedere in tre diversi modi:

Polling: effettuate una chiamata a value ogni volta che desiderate ottenere il valore conosciuto più recente di un controllo.
Eventi di modifica: registrate l'evento di modifica di un controller. L'evento Event.CHANGE viene inviato ogni volta che il valore di un controllo cambia. Al ricevimento dell’evento, effettuate una chiamata a value per ottenere il valore che ha inviato l’evento.
Memorizzazione in cache dei valori dei controlli: la memorizzazione in cache viene eseguite a livello di dispositivo. Consultate la documentazione della classe GameInputDevice per maggiori dettagli sulla memorizzazione in cache e il recupero dei valori dei controlli campionati.

Il tentativo di lettura dei valori dei controlli da un dispositivo disattivato causa la generazione di un errore IOError da parte di value. Tuttavia, potete accedere a proprietà che descrivono un controllo (id, minValue e maxValue) anche se il dispositivo non è abilitato. Questa funzione rende possibile determinare se un dispositivo soddisfa le esigenze di una specifica applicazione, senza dover prima abilitare tale dispositivo.

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.

Elementi API correlati

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

Proprietà pubbliche

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
		device : GameInputDevice [sola lettura] Restituisce l'oggetto GameInputDevice che contiene questo controllo.	GameInputControl
		id : String [sola lettura] Restituisce l’ID di questo controllo.	GameInputControl
		maxValue : Number [sola lettura] Restituisce il valore massimo per questo controllo.	GameInputControl
		minValue : Number [sola lettura] Restituisce il valore minimo per questo controllo.	GameInputControl
		value : Number [sola lettura] Restituisce il valore per questo controllo.	GameInputControl

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	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
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[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
change	Inviato quando il valore di un controllo viene modificato.	GameInputControl
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher

Descrizione delle proprietà

device

proprietà

device:GameInputDevice [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 3.7

Restituisce l'oggetto GameInputDevice che contiene questo controllo.

Implementazione
public function get device():GameInputDevice

id

proprietà

id:String [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 3.7

Restituisce l’ID di questo controllo.

Implementazione
public function get id():String

maxValue

proprietà

maxValue:Number [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 3.7

Restituisce il valore massimo per questo controllo.

Implementazione
public function get maxValue():Number

minValue

proprietà

minValue:Number [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 3.7

Restituisce il valore minimo per questo controllo.

Implementazione
public function get minValue():Number

value

proprietà

value:Number [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 3.7

Restituisce il valore per questo controllo.

Implementazione
public function get value():Number

Genera

IOError — Quando viene effettuata una chiamata a value mentre il dispositivo è disabilitato.

Descrizione degli eventi

change

Evento

Tipo di oggetto evento: flash.events.Event

Inviato quando il valore di un controllo viene modificato.

Note legali | Informativa sulla privacy online

GameInputControl - AS3

Classi x

device

id

maxValue

minValue

value

change