> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.playability.gg/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Affecter des entrées à des actions de manette virtuelle

Les actions de manette permettent à un jeu compatible de recevoir les entrées de PlayAbility comme celles d’une manette standard. Choisissez une action numérique pour une commande tout ou rien, ou une action analogique lorsque l’amplitude du mouvement doit suivre celle du déclencheur.

## Avant de commencer

- Chargez un profil modifiable.
- Vérifiez que le jeu cible accepte les entrées de manette.
- Installez la prise en charge de la manette virtuelle requise par votre système d’exploitation :
  - **Windows :** ViGEmBus
  - **Linux :** accès à `uinput` et script de configuration PlayAbility fourni
  - **macOS :** VirtualHIDGamepad

Si PlayAbility ne parvient pas à créer la manette virtuelle, une alerte rouge s’affiche en bas de la fenêtre.

## Choisir la bonne action de manette

- **Boutons :** A, B, X, Y, boutons d’épaule, boutons des sticks, Back, Start et Guide
- **Croix directionnelle :** haut, bas, gauche ou droite
- **Directions des sticks :** déplacement tout ou rien du stick gauche ou droit dans une direction
- **Axes des sticks :** déplacement horizontal ou vertical proportionnel du stick gauche ou droit
- **Gâchettes :** gâchette analogique gauche ou droite

Utilisez une direction de stick avec un déclencheur numérique comme une touche, un contacteur, une commande vocale ou une cible dwell. Utilisez un axe de stick pour diriger ou viser progressivement à partir d’une entrée analogique comme un mouvement de tête, un mouvement de souris ou un axe de manette physique. Les gestes faciaux peuvent également piloter progressivement les actions analogiques compatibles.

## Affecter un bouton ou une direction de manette

1. Ouvrez **Mappage** dans la barre latérale et vérifiez que le bon profil est actif.
2. Sélectionnez **Ajouter des actions**.
3. Sélectionnez **Manette**.
4. Sélectionnez le bouton, la direction de croix directionnelle ou la direction de stick souhaitée.
5. Sélectionnez le bouton **Ajouter** qui indique le nombre d’actions choisies.
6. Sur la nouvelle ligne, sélectionnez **Sélectionner un déclencheur**.
7. Choisissez un déclencheur compatible existant, ou sélectionnez **Créer un nouveau déclencheur +** et configurez-le.
8. Sélectionnez un **Mode d'action** :
   - **Par défaut** maintient l’action active tant que le déclencheur l’est.
   - **Bascule** active ou désactive l’action à chaque déclenchement.
   - **Appui court** envoie un appui de 100 ms.
   - **Appui long** envoie un appui de 300 ms.
   - **Double appui** ou **Triple appui** envoie plusieurs appuis rapides.
9. Sélectionnez **Enregistrer**.

## Affecter un axe de stick ou une gâchette analogique

1. Sélectionnez **Ajouter des actions**, puis ouvrez **Manette**.
2. Sélectionnez l’axe X ou Y du stick gauche ou droit, ou **Gâchette Gauche** ou **Gâchette Droite**.
3. Ajoutez l’action, puis sélectionnez **Sélectionner un déclencheur**.
4. Choisissez une entrée analogique proposée par l’éditeur.
5. Réglez si nécessaire sa plage, sa zone morte, sa sensibilité, son seuil ou les autres paramètres disponibles.
6. Pour un axe de stick, utilisez l’option d’inversion si le mouvement est inversé.
7. Pour une gâchette analogique, conservez le mode **Par défaut** pour une sortie progressive. Les autres modes d’appui produisent un comportement numérique.
8. Sélectionnez **Enregistrer**.

Les axes de stick n’utilisent pas de Mode d'action, car leur sortie suit une valeur continue.

## Activer la manette virtuelle

1. Activez **Sortie Principale** avec la commande lecture/pause de PlayAbility.
2. Vérifiez que **Sortie manette** est active dans la zone des contrôles.
3. Résolvez toute alerte rouge de manette virtuelle affichée en bas de la fenêtre.
4. Si vous voulez utiliser la manette virtuelle locale, ouvrez **Connecteurs** et désactivez les sorties **PlayAbility Receiver** et **8BitDo Micro**.
5. Lancez ou redémarrez le jeu une fois la manette virtuelle prête.

PlayAbility Receiver et 8BitDo Micro sont des sorties alternatives. L’activation de l’une d’elles déconnecte la manette virtuelle locale.

## Vérifier le mappage

1. Commencez avec une action simple comme le bouton **A**.
2. Activez son déclencheur et vérifiez que le retour en direct du mappage change.
3. Vérifiez que **Sortie Principale** et **Sortie manette** restent actives.
4. Testez l’action dans un jeu qui accepte les entrées de manette.
5. Pour un axe ou une gâchette, parcourez toute sa plage utile et vérifiez que la réponse est fluide et revient au neutre.

## Dépannage et limitations

### Une alerte rouge de manette virtuelle est affichée

- Sous Windows, sélectionnez **Lancer l’installateur ViGEm**, laissez PlayAbility se fermer, terminez l’installation, puis rouvrez-le.
- Sous Linux, ouvrez **Manettes**, exécutez le script fourni avec le chemin exact affiché, puis redémarrez PlayAbility.
- Sous macOS, installez et activez VirtualHIDGamepad, puis redémarrez PlayAbility.

### Le mappage réagit, mais le jeu ne reçoit rien

- Vérifiez que le bon profil est actif.
- Activez **Sortie Principale** et **Sortie manette**.
- Désactivez la sortie PlayAbility Receiver ou 8BitDo Micro si vous voulez utiliser la manette virtuelle locale.
- Vérifiez les règles de sortie par application au premier plan.
- Redémarrez les jeux qui ne recherchent les manettes qu’au lancement.

### Le mouvement est toujours à pleine amplitude

Vous avez sélectionné une direction de stick. Remplacez-la par l’axe X ou Y correspondant et choisissez une entrée analogique.

### Un axe ou une gâchette est inversé ou trop sensible

Modifiez le mappage. Inversez l’axe si nécessaire, puis ajustez la plage, la zone morte, le seuil et la sensibilité maximale de l’entrée.

### Une action de manette reste active

Exécutez **Tout relâcher**. Utilisez ensuite le mode **Par défaut** ou un mode d’appui à la place de **Bascule** si l’action ne doit pas rester verrouillée.

### Le jeu ignore toujours la manette

PlayAbility peut créer le périphérique virtuel, mais chaque jeu décide des API et périphériques de manette qu’il accepte. Testez une autre application compatible avec les manettes afin de distinguer un problème de sortie PlayAbility d’un problème de détection propre au jeu.

## Articles connexes

- [Créer et modifier un mappage](https://help.playability.gg/fr/article/creer-et-modifier-un-mappage-1gdwimb/)
- [Dépanner la sortie de manette virtuelle](https://help.playability.gg/fr/article/depanner-la-sortie-de-manette-virtuelle-1rehk6i/)
- [Configurer le PlayAbility Adaptive Receiver](https://help.playability.gg/fr/article/configurer-le-playability-adaptive-receiver-g8tx7l/)
- [Utiliser PlayAbility sur Xbox avec Remote Play ou Cloud Gaming](https://help.playability.gg/fr/article/utiliser-playability-sur-xbox-avec-remote-play-ou-cloud-gaming-bw9fz6/)