GameMaker Studio 2 dispose d'un certain nombre de fonctions dédiées qui peuvent être utilisées pour détecter les contrôles analogiques et numériques à partir de plusieurs pads de jeu connectés. Ces fonctions fonctionnent de la même manière que les entrées de l' appareil, en ce sens que vous pouvez détecter jusqu'à quatre pads de jeu XInput connectés (et jusqu'à 8 manettes de jeu DirectInput) et gérer les entrées de chacun en utilisant les mêmes fonctions. Notez que lorsqu'une manette est branchée sur votre appareil (ou qu'elle est retirée), un événement système asynchrone est déclenché, dans lequel vous pouvez gérer la situation en utilisant les fonctions appropriées.

Les gamepad "slots" sont indexés à partir de 0 avec les slots 0 - 3 inclus étant uniquement pour les gamepads Xinput, à savoir: les contrôleurs Xbox360 et compatibles. Cependant, vous pouvez également vérifier les slots 4 - 11 inclus pour les gamepads DirectInput, ce qui signifie que vous pouvez détecter de nombreux autres modèles de contrôleurs lorsqu'ils sont connectés via ces slots. Il convient de noter que lorsque vous utilisez les manettes de jeu DirectInput, les constantes indiquées ci-dessous peuvent ne pas correspondre exactement aux boutons que vous attendez lorsqu'elles sont enfoncées, à cause de la manière fragmentée et non standardisée de l'API. Il est recommandé d'avoir une sorte d'écran de configuration de la manette de jeu dans vos jeux où les gens peuvent redéfinir les boutons de la manette en fonction de l'entrée de n'importe quel appareil connecté pour atténuer les problèmes. Notez également que l'interface d'entrée directe est exécutée en mode coopératif, ce qui signifie que votre jeu n'a d'accès que lorsqu'il est l'application de premier plan, ce qui provoque la perte des contrôleurs d'entrée directe si le jeu utilise le focus et le trouve ensuite à nouveau quand il revient sur le point (cela peut être détecté dans l'événement système et traité).

Lorsque vous travaillez avec les fonctions de la manette de jeu, il y a un certain nombre de constantes intégrées qui devraient être utilisées pour obtenir / définir les boutons et l'axe du bâton etc...:

Pour mieux comprendre exactement quelle partie du contrôleur chaque constante représente, vous pouvez vous référer à l'image suivante d'une manette standard:

Vous trouverez ci-dessous une liste de toutes les fonctions du gamepad:

1. gamepad_is_supported
   
2. gamepad_get_device_count
   
3. gamepad_is_connected
   
4. gamepad_get_description
   
5. gamepad_get_button_threshold
   
6. gamepad_set_button_threshold
   
7. gamepad_axis_count
   
8. gamepad_axis_value
   
9. gamepad_button_check
   
10. gamepad_button_check_pressed
    
11. gamepad_button_check_released
    
12. gamepad_button_count
    
13. gamepad_button_value
    
14. gamepad_set_vibration
    
15. gamepad_set_axis_deadzone
    
16. gamepad_set_colour
    

Compatibilité

La liste suivante montre la compatibilité actuelle entre les plates-formes (notez que cela va changer avec les futures mises à jour):

• Windows est entièrement pris en charge avec un maximum de 12 périphériques connectés autorisés à la fois (numérotés de 0 à 11, 0-3 étant des périphériques XInput et 4 - 11 étant DirectInput).
  
• Mac OS est pris en charge avec un maximum de 4 périphériques connectés autorisés à la fois, et ces périphériques ne peuvent être que du type Playstation 3 ou Xbox 360. Veuillez noter que l'option " Build for Mac AppStore " dans Mac Options de jeu doit être DÉSACTIVÉ pour que le support de pad fonctionne.
  
  
• Ubuntu prend également en charge l'entrée Gamepad, mais vous devrez peut-être installer des bibliothèques supplémentaires à partir du référentiel Ubuntu. Vous pouvez le faire facilement en ouvrant un terminal de ligne de commande et en tapant ce qui suit:

  sudo apt-get install jstest-gtk
  sudo apt-get install joystick.
  

  Cela va installer le support de l'interface graphique pour le joystick / gamepad ainsi que l'API joystick / gamepad elle-même.
  
  

• Les jeux HTML5 utilisant des manettes sont pris en charge par la plupart des principaux navigateurs, à l'exception de Safari.
  
  
• La prise en charge de la manette de jeu s'étend également à iOS avec l'armoire iCade. L'axe de gauche est mappé au contrôleur de manche (bien que l'entrée soit numérique, pas analogique), les quatre boutons «visage» correspondent aux boutons du devant de l'armoire et les quatre boutons aux épaules correspondent à ceux situés à l'arrière de l'armoire.
  
  
• Android exportation Android prend en charge les contrôleurs NYKO et les contrôleurs Bluetooth génériques (y compris l'OUYA), mais uniquement lorsqu'ils sont activés, ce qui signifie que vous devrez cocher l'option iCade / Bluetooth dans la section Général des Options de jeu Android. Ils requièrent le niveau 12 de l'API pour qu'ils fonctionnent pleinement et il convient de noter que GameMaker Studio 2 enregistrera comme étant connectés tous les appareils Bluetooth auxquels votre appareil est associé, qu'il soit ou non connecté. Par conséquent, ceci doit être pris en compte lors de l'attribution et de la vérification de "slots".
  
  
• Sur PS4, si vous souhaitez utiliser le pavé tactile, vous devez utiliser device_mouse_* boutons.
  
  

Idéalement, sur toutes les plates-formes cibles, vous souhaitez énumérer une liste des "slots" de gamepad disponibles, puis les vérifier pour voir si des périphériques sont détectés, quelque chose comme ceci:

var maxpads = gamepad_get_device_count();for (var i = 0; i < maxpads; i++)
    {
    if (gamepad_is_connected(i))
        {
        // do stuff with pad "i"
        }
    }