Haptique dans GameInput

​

Exigences

1. L’appareil doit être reconnu comme source audio dans Windows. Le moyen de connexion (USB, Bluetooth®, etc.) n’a pas d’importance.
2. L’appareil ne doit pas exposer plus d’un point de terminaison haptique.
3. L’appareil ne doit pas exposer plus de huit emplacements haptiques.
4. L’appareil ne doit pas modifier ses capacités haptiques une fois connecté.
5. L’appareil ne doit pas avoir plusieurs points de terminaison audio de formats identiques (bits par échantillon et échantillons par seconde).
6. L’appareil doit présenter le même ID de conteneur pour son point de terminaison audio que le reste de l’appareil.
7. L’appareil doit avoir une entrée de registre permettant d’identifier explicitement le point de terminaison haptique. Le format est le suivant :
   • Les appareils haptiques sont énumérés dans le registre sous HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\GameInput\Devices.
   • La clé propre à l’appareil est une combinaison de l’ID du fournisseur, de l’ID du produit, de la page d’utilisation et de l’ID d’utilisation, mise en forme sous forme de chaîne hexadécimale.
   • HapticSamplesPerSecond est une valeur DWORD qui indique le nombre d’échantillons par seconde (Hz) du format du point de terminaison haptique.
   • HapticsBitsPerSample est une valeur DWORD qui indique le nombre de bits par échantillon (taille d’échantillon) du format du point de terminaison haptique.
   • HapticLocations est un tableau BYTE de GUID d’emplacements haptiques. Ce tableau doit contenir entre un et huit GUID, correspondant au mappage des canaux haptiques.
   Pour mieux illustrer cela, prenons l’exemple d’appareil suivant :

   Champ	Valeur
   ID du fournisseur	0x045e
   ID du produit	0x1234
   Page d’utilisation	0x0001
   ID d’utilisation	0x0005
   Fréquence d’échantillonnage	0x0fa0
   Taille d’échantillon	0x0010
   Emplacements haptiques	GAMEINPUT_HAPTIC_LOCATION_GRIP_LEFT, GAMEINPUT_HAPTIC_LOCATION_GRIP_RIGHT

   L’entrée de registre haptique associée se présenterait comme suit :

    Windows Registry Editor Version 5.00

    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\GameInput\Devices\045E123400010005]
    "HapticSamplesPerSecond"=dword:00000fa0
    "HapticBitsPerSample"=dword:00000010
    "HapticLocations"=hex:c2,07,c7,08,bb,66,6c,40,a8,4a,df,e0,85,12,0a,92,77,0b,5a,\
    15,b2,8b,db,40,86,90,b6,d4,11,26,df,c1

​

Emplacements haptiques

// { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_NONE, 0x00000000, 0x0000, 0x0000, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00);

// { 0xc2, 0x07, 0xc7, 0x08, 0xbb, 0x66, 0x6c, 0x40, 0xa8, 0x4a, 0xdf, 0xe0, 0x85, 0x12, 0x0a, 0x92 }
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_GRIP_LEFT, 0x08c707c2, 0x66bb, 0x406c, 0xa8, 0x4a, 0xdf, 0xe0, 0x85, 0x12, 0x0a, 0x92);

// { 0x77, 0x0b, 0x5a, 0x15, 0xb2, 0x8b, 0xdb, 0x40, 0x86, 0x90, 0xb6, 0xd4, 0x11, 0x26, 0xdf, 0xc1 }
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_GRIP_RIGHT, 0x155a0b77, 0x8bb2, 0x40db, 0x86, 0x90, 0xb6, 0xd4, 0x11, 0x26, 0xdf, 0xc1);

// { 0x96, 0xd8, 0xe4, 0x8d, 0x59, 0x55, 0x81, 0x40, 0x86, 0xe5, 0x17, 0x24, 0xcc, 0x07, 0xc6, 0xbc }
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_TRIGGER_LEFT, 0x8de4d896, 0x5559, 0x4081, 0x86, 0xe5, 0x17, 0x24, 0xcc, 0x07, 0xc6, 0xbc);

// { 0x57, 0xb5, 0x0c, 0xff, 0xf5, 0x3a, 0x6b, 0x40, 0x8b, 0x0f, 0x55, 0x5a, 0x2d, 0x92, 0xa2, 0x20 }
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_TRIGGER_RIGHT, 0xff0cb557, 0x3af5, 0x406b, 0x8b, 0x0f, 0x55, 0x5a, 0x2d, 0x92, 0xa2, 0x20);

​

Documentation de référence de l’API

• GameInput (contenu de l’API)
  • Structures
    • GameInputHapticInfo

​

Voir aussi