GameInputDevice  - AS3

Active ou désactive ce périphérique. Les périphériques sont désactivés par défaut. Activez un périphérique pour accéder à ses valeurs de contrôle ou les échantillonner. Par ailleurs, un périphérique et ses contrôles individuels distribuent des événements uniquement lorsque le périphérique est activé.

Lorsqu’un périphérique est supprimé, il est désactivé. Vous pouvez toujours obtenir des informations sur un périphérique désactivé, mais vous ne pouvez pas accéder aux valeurs de contrôle ou démarrer la mise en cache. Par ailleurs, vous ne pouvez pas activer le périphérique s’il elle a été déconnecté. Si un périphérique est déconnecté, enabled renvoie toujours false.

Renvoie l’ID de ce périphérique. Vous pouvez différencier les périphériques par leurs ID.

Remarque : Pour les appareils Android, cette information est fournie par le fabricant. Pour les appareils iOS, l’ID peut changer quand vous reconnectez l’appareil.

Renvoie le nom de ce périphérique. Le nom peut aider à identifier le type de périphérique.

Remarque : le fabricant du périphérique fournit les noms de ses périphériques.

Renvoie le nombre de commandes de ce périphérique.

Indique la cadence (en millisecondes) à laquelle récupérer les valeurs de contrôle. La valeur par défaut est 0, ce qui signifie que les valeurs sont mises à jour une fois par image. La définition d’une valeur sampleValue supérieure pousse GameInput à échantillonner les valeurs de contrôle à une cadence plus rapide que celle de l’application.

Bien que les valeurs puissent être mises à jour plus fréquemment qu’une fois par image, seul un événement par contrôle est distribué. Par conséquent, si deux mises à jour d’une valeur se produisent dans une seule image, seul un événement change est distribué et seule la valeur la plus récente peut être récupérée.

Pour récupérer d’autres valeurs que la valeur la plus récente, vous pouvez mettre en cache les valeurs d’échantillon à l’aide des méthodes de mise en cache de cette classe. Lorsque vous mettez en cache des valeurs échantillonnées, cette propriété détermine la fréquence à laquelle les valeurs sont écrites dans la mémoire cache.

La valeur par défaut est 0.

Ecrit les valeurs d’échantillons mis en cache sur l’objet ByteArray. Les valeurs d’échantillons mis en cache sont écrites dans le ByteArray dans l’ordre où elles ont été récupérées (valeurs plus anciennes en premier, valeurs plus récentes en dernier).

Cette méthode renvoie le nombre de valeurs d’échantillons mis en cache écrites dans le ByteArray (et non des valeurs elles-mêmes). Si le paramètre append est false (valeur par défaut), l’objet ByteArray est supprimé avant que les valeurs d’échantillon soient écrites à partir du cache. Si append est true, les valeurs d’échantillon sont ajoutées au ByteArray et les anciennes valeurs sont préservées. Ajoutez les valeurs d’échantillon si :

• Vous devez conserver un certain nombre de valeurs disponibles.
• Vous devez conserver un historique plus grand que la mémoire cache.

Le cache est effacé après que les valeurs d’échantillon sont écrites dans le ByteArray.

Une erreur IOError est renvoyée si le périphérique est désactivé lorsque cette méthode est appelée.

Paramètres

Récupère un contrôle spécifique à partir d’un périphérique.

GameInputDevice enregistre les contrôles d’un périphérique dans une liste. Vous pouvez accéder aux commandes individuelles sur un périphérique à l’aide de la méthode getControlAt().

L’ordre des contrôles dans l’index peut changer chaque fois qu’un périphérique est connecté ou déconnecté. Vous pouvez vérifier la propriété id sur un objet GameInputControl et la faire correspondre à un contrôle spécifique.

Vous pouvez obtenir les contrôles même si un périphérique n’est pas activé. En revanche, vous ne pouvez pas lire les valeurs de contrôle à partir d’un périphérique désactivé. Cette fonction permet de lire les propriétés d’un contrôle avant d’activer le périphérique auquel il appartient. Vous pouvez utiliser cette fonctionnalité pour déterminer si un périphérique est convient à votre application avant d’activer le périphérique.

Paramètres

Demande à ce périphérique de commencer la mise en cache des valeurs échantillonnées. La propriété sampleInterval détermine la fréquence d’échantillonnage. Le paramètre numSamples spécifie le nombre d’échantillons à mettre en cache. Le paramètre controls spécifie les valeurs d’ID des contrôles à échantillonner.

Les valeurs de contrôle sont mises en cache dans l’ordre spécifié. Pour récupérer les valeurs échantillonnées, appelez la méthode getCachingSamples().

Si la quantité de mémoire nécessaire pour mettre en cache les valeurs échantillonnées est supérieure à la valeur spécifiée dans la constante MAX_BUFFER_SIZE, cette méthode renvoie une erreur MemoryError. Une erreur IOError est renvoyée si le périphérique n’a pas été activé avant l’appel de cette méthode.

Paramètres

Arrête la mise en cache de l’échantillon. Bien que les événements change soient toujours distribués sur les contrôles, plus aucun échantillon n’est enregistré dans la mémoire cache. Bien que les valeurs soient toujours récupérées à la fréquence spécifiée par sampleInterval, elles ne sont pas stockées dans la mémoire cache. Vous pouvez donc uniquement récupérer la dernière valeur.

Spécifie la taille maximale de la mémoire tampon utilisée pour mettre en cache les valeurs de contrôles échantillonnées. Si startCachingSamples renvoie des échantillons qui nécessitent davantage de mémoire que celle spécifiée, une erreur de mémoire est renvoyée.