GameInputControl - Guide de référence de l’API Adobe ActionScript® 3 (AS3 )

Package	flash.ui
Classe	public dynamic class GameInputControl
Héritage	GameInputControl EventDispatcher Object

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 3.7

La classe GameInputControl représente un contrôle sur un périphérique d’entrée. L’API GameInput mappe les commandes physiques d’un périphérique sur des commandes logiques simples.

Obtention des valeurs de contrôle :

La propriété value renvoie la valeur actuelle d’une commande. Cette méthode ne renvoie pas la dernière valeur directement à partir du contrôle. Elle renvoie plutôt la valeur mise en cache lors du dernier échantillonnage du contrôle.

Il existe trois façons d’obtenir les valeurs de contrôle à partir d’un contrôle individuel :

Interrogation : appelez la propriété value chaque fois que vous souhaitez obtenir la dernière valeur connue d’une commande.
Evénements change : enregistrez un événement change pour un contrôleur. L’événement Event.CHANGE est distribué chaque fois que la valeur d’un contrôle change. Lors de la réception de l’événement, appelez la propriété value pour obtenir la valeur correspondant à la commande ayant déclenché l’événement.
Mise en cache les valeurs d’échantillon : la mise en cache est effectuée au niveau du périphérique. Voir la documentation de la classe GameInputDevice pour plus d’informations sur la mise en cache et la récupération des valeurs de contrôle échantillonnées.

Toute tentative de lecture des valeurs de commande à partir d’un périphérique désactivé entraîne la propriété value à renvoyer une erreur IOError. Vous pouvez toutefois accéder à des propriétés décrivant une commande (id, minValue et maxValue) même si le périphérique n’est pas activé. Cette fonction permet de déterminer si un périphérique s’adapte aux besoins de votre application sans avoir à activer préalablement le périphérique.

Pour en savoir plus, reportez-vous à l’article du Centre des développeurs d’Adobe Air : Contrôleurs de jeu sur Adobe AIR.

Sous Android, cette fonction est compatible avec la version 4.1 ou ultérieure du système d’exploitation Android ; SWF version 20 ou ultérieure et un espace de noms version 3.7 ou ultérieure sont requis. Sous iOS, prend en charge la version 9.0 et requiert SWF version 34 ou ultérieure et un espace de noms version 23.0 ou ultérieure.

Eléments de l’API associés

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

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		device : GameInputDevice [lecture seule] Renvoie l’objet GameInputDevice qui contient ce contrôle.	GameInputControl
		id : String [lecture seule] Renvoie l’ID de cette commande.	GameInputControl
		maxValue : Number [lecture seule] Renvoie la valeur maximale de cette commande.	GameInputControl
		minValue : Number [lecture seule] Renvoie la valeur minimale de cette commande.	GameInputControl
		value : Number [lecture seule] Renvoie la valeur de cette commande.	GameInputControl

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	EventDispatcher

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
change	Distribué lorsqu’une valeur de contrôle change.	GameInputControl
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher

Détails de la propriété

device

propriété

device:GameInputDevice [lecture seule]

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 3.7

Renvoie l’objet GameInputDevice qui contient ce contrôle.

Implémentation
public function get device():GameInputDevice

id

propriété

id:String [lecture seule]

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 3.7

Renvoie l’ID de cette commande.

Implémentation
public function get id():String

maxValue

propriété

maxValue:Number [lecture seule]

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 3.7

Renvoie la valeur maximale de cette commande.

Implémentation
public function get maxValue():Number

minValue

propriété

minValue:Number [lecture seule]

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 3.7

Renvoie la valeur minimale de cette commande.

Implémentation
public function get minValue():Number

value

propriété

value:Number [lecture seule]

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 3.7

Renvoie la valeur de cette commande.

Implémentation
public function get value():Number

Valeur émise

IOError — Lorsque la propriété value est appelée alors que le périphérique est désactivé.

Détails de l’événement

change

Evénement

Type d’objet d’événement: flash.events.Event

Distribué lorsqu’une valeur de contrôle change.

Informations juridiques | Politique de confidentialité en ligne

GameInputControl - AS3

Classes x

device

id

maxValue

minValue

value

change