GameInputControl - Referencia de la API de Adobe ActionScript® 3 (AS3 )

Paquete	flash.ui
Clase	public dynamic class GameInputControl
Herencia	GameInputControl EventDispatcher Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 3.7

La clase GameInputControl representa un control en un dispositivo de entrada. La API GameInput asigna los controles físicos de un dispositivo a controles lógicos sencillos.

Obtención de valores de control:

La propiedad value devuelve el valor actual de un control. Este método no devolverá el valor más reciente directamente desde el control. En su lugar, devuelve el valor que se ha almacenado en caché la última vez que se tomaron muestras del control.

Hay tres formas de obtener valores de control a partir de un control individual:

Sondear: llame a value siempre que quiera obtener el último valor conocido para un control.
Eventos change: registre un evento change para un controlador. El evento Event.CHANGE se distribuye siempre que cambia el valor de un control. Después de recibir el evento, llame a value para obtener el valor del control que activó el evento.
Almacenamiento en caché de valores de muestra: el almacenamiento en caché se realiza en el nivel del dispositivo. Consulte la documentación de la clase GameInputDevice para obtener más información sobre el almacenamiento en caché y la recuperación de los valores de control muestreados.

Si intenta leer los valores de control desde un dispositivo desactivado, value emitirá un error IOError. Pero podrá acceder a las propiedades que describen un control (id, minValue y maxValue) incluso si el dispositivo no está activado. Esta función hace posible determinar si un dispositivo se ajusta a las necesidades de la aplicación, sin tener que activar el dispositivo primero.

Para obtener más información, consulte el artículo del Centro de desarrolladores de Adobe Air:Controladores de juego en Adobe AIR.

Para Android, esta función es compatible con una versión del SO Android mínima de 4.1 y requiere la versión de SWF mínima de 20 y espacio de nombre 3.7. Para iOS, esta función es compatible con una versión mínima de iOS 9.0 y requiere la versión de SWF mínima de 34 y espacio de nombre 23.0.

Elementos de API relacionados

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

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		device : GameInputDevice [solo lectura] Devuelve el objeto GameInputDevice que contiene este control.	GameInputControl
		id : String [solo lectura] Devuelve el ID de este control.	GameInputControl
		maxValue : Number [solo lectura] Devuelve el valor máximo para este control.	GameInputControl
		minValue : Number [solo lectura] Devuelve el valor mínimo para este control.	GameInputControl
		value : Number [solo lectura] Devuelve el valor para este control.	GameInputControl

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.	EventDispatcher
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		hasEventListener(type:String):Boolean Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object
		willTrigger(type:String):Boolean Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.	EventDispatcher

Eventos

Haga clic para obtener más información sobre los eventos

Ocultar eventos heredados

Mostrar eventos heredados

	Resumen	Definido por
activate	[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.	EventDispatcher
change	Se distribuye cuando cambia un valor de control.	GameInputControl
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher

Información sobre propiedades

device

propiedad

device:GameInputDevice [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 3.7

Devuelve el objeto GameInputDevice que contiene este control.

Implementación
public function get device():GameInputDevice

id

propiedad

id:String [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 3.7

Devuelve el ID de este control.

Implementación
public function get id():String

maxValue

propiedad

maxValue:Number [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 3.7

Devuelve el valor máximo para este control.

Implementación
public function get maxValue():Number

minValue

propiedad

minValue:Number [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 3.7

Devuelve el valor mínimo para este control.

Implementación
public function get minValue():Number

value

propiedad

value:Number [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 3.7

Devuelve el valor para este control.

Implementación
public function get value():Number

Emite

IOError — Cuando se llama a value mientras el dispositivo está desactivado.

Información sobre eventos

change

Evento

Tipo de objeto de evento: flash.events.Event

Se distribuye cuando cambia un valor de control.

Avisos legales | Política de privacidad en línea

GameInputControl - AS3

Clases x

device

id

maxValue

minValue

value

change