| Package | flash.ui |
| Classe | public final class GameInput |
| Héritage | GameInput  EventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3.7 |
GameInput est le point d’accès à l’API GameInput. Vous pouvez utiliser cette API pour gérer les communications entre une application et les périphériques d’entrée de jeux (à savoir, joysticks, manettes et bâtons).
Le principal objectif de cette classe est de fournir un accès aux périphériques d’entrée pris en charge connectés à la plate-forme de l’application. Cette classe statique énumère les périphériques d’entrée connectés d’une liste. Accédez à un périphérique de la liste à l’aide de la méthode getDeviceAt(index:int).
La propriété numDevices indique le nombre de périphériques de saisie actuellement connectés à votre plate-forme. Utilisez cette valeur pour déterminer la limite supérieure de la liste des périphériques.
Utilisez une occurrence de cette classe pour écouter les événements qui vous informent de l’ajout et de la suppression de périphériques d’entrée. Pour écouter ces événements, procédez comme suit :
-
Créez une occurrence de la classe
GameInput. -
Ajoutez des écouteurs d’événement pour les événements
GameInputEvent.DEVICE_ADDEDetGameInputEvent.DEVICE_REMOVED. (Les événements peuvent être enregistrés uniquement sur une occurrence de la classe.)
Cette classe comporte également l’indicateur isSupported, qui indique si l’API GameInput est prise en charge sur votre plate-forme.
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.
Comment détecter un périphérique d’entrée de jeux parmi des périphériques identiques
Une exigence commune aux jeux à deux ou plusieurs joueurs est la détection d’un périphérique parmi des périphériques identiques. Par exemple, les applications doivent parfois déterminer quel périphérique représente "Joueur 1", "Joueur 2", ..., "Player N".
Solution:
-
Ajoutez des écouteurs d’événement à chaque contrôle sur tous les périphériques d’entrée non détectés. Ces écouteurs d’événement écoutent les événements
Event.CHANGE, qui sont distribués chaque fois que la valeur d’un contrôle change. - Lors de la première activation d’un contrôle (par exemple l’appui sur un bouton ou sur un déclencheur), l’application étiquette ce périphérique.
- Supprimez toutes les écouteurs d’événement des périphériques d’entrée non détectés.
- Répétez les étapes 1 à 3 pour identifier le reste des périphériques d’entrée non détectés.
Eléments de l’API associés
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 | |
| isSupported : Boolean [statique] [lecture seule]
Indique si la plate-forme actuelle prend en charge l’API GameInput. | GameInput | ||
| numDevices : int [statique] [lecture seule]
Fournit le nombre de périphériques d’entrée connectés. | GameInput | ||
| 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 | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
[statique]
Récupère le périphérique d’entrée à l’emplacement d’index spécifié dans la liste des périphériques d’entrée connectés. | GameInput | ||
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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 | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
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énement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué lorsque vous connectez un périphérique d’entrée de jeux à votre plate-forme ou lorsque vous mettez sous tension un périphérique déjà connecté. | GameInput | |||
| Distribué lorsque vous déconnectez un périphérique d’entrée de jeux de votre plate-forme ou lorsque vous mettez hors tension un périphérique connecté. | GameInput | |||
| Envoyé lorsqu’un périphérique d’entrée de jeu est connecté, mais n’est pas utilisable. | GameInput | |||
isSupported | propriété |
numDevices | propriété |
numDevices:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3.7 |
Fournit le nombre de périphériques d’entrée connectés. Lors de la connexion d’un périphérique, l’événement GameInputEvent.DEVICE_ADDED est déclenché.
Implémentation
public static function get numDevices():intgetDeviceAt | () | méthode |
public static function getDeviceAt(index:int):GameInputDevice| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 3.7 |
Récupère le périphérique d’entrée à l’emplacement d’index spécifié dans la liste des périphériques d’entrée connectés.
L’ordre des périphériques dans l’index peut changer chaque fois qu’un périphérique est connecté ou déconnecté. Vous pouvez vérifier les propriétés name et id sur un objet GameInputDevice afin d’être en adéquation avec un périphérique d’entrée spécifique.
Paramètres
index:int — Position de l’index dans la liste des périphériques d’entrée.
|
GameInputDevice — L’objet GameInputDevice spécifié.
|
Valeur émise
RangeError — Lorsque l’index fourni est inférieur à zéro ou supérieur à (numDevices - 1).
|
deviceAdded | Evénement |
flash.events.GameInputEventDistribué lorsque vous connectez un périphérique d’entrée de jeux à votre plate-forme ou lorsque vous mettez sous tension un périphérique déjà connecté.
deviceRemoved | Evénement |
flash.events.GameInputEventDistribué lorsque vous déconnectez un périphérique d’entrée de jeux de votre plate-forme ou lorsque vous mettez hors tension un périphérique connecté.
deviceUnusable | Evénement |
flash.events.GameInputEventEnvoyé lorsqu’un périphérique d’entrée de jeu est connecté, mais n’est pas utilisable. Cet événement est réservé à Windows. Par exemple, cela se produit dans un navigateur Windows placé en sandbox lorsqu’une autre application DirectInput utilise déjà le périphérique.
Tue Jun 12 2018, 09:30 AM Z