> ## 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).

# Utiliser une manette ou un joystick physique comme entrée

PlayAbility peut utiliser une manette physique comme source de déclenchement. Vous pouvez remapper certaines commandes et, si vous le souhaitez, transmettre les autres commandes de la manette à la manette virtuelle PlayAbility.

## Prérequis

- Connectez une manette reconnue par votre système d’exploitation, par USB, Bluetooth ou son récepteur compatible.
- Si le mappage doit produire une sortie de manette, vérifiez que la manette virtuelle PlayAbility est disponible. Suivez toute alerte de pilote ou de configuration affichée dans l’application.
- Chargez un profil modifiable.

## Activer l’entrée de la manette connectée

1. Ouvrez **Manettes** depuis le menu latéral.
2. Activez **Activer la manette externe**.
3. Vérifiez que votre manette physique apparaît dans une carte de périphérique.
4. Décidez si vous souhaitez activer **Forward** pour cette manette :
   - Avec **Forward** activé, ses boutons et axes non mappés sont transmis à la manette virtuelle PlayAbility.
   - Avec **Forward** désactivé, cette transmission s’arrête, mais les mappages utilisant la manette comme déclencheur continuent de fonctionner.

La manette virtuelle PlayAbility peut également apparaître dans la liste sous le nom **Manette virtuelle Playability**. Il s’agit du périphérique de sortie, pas d’une manette physique à associer à un déclencheur.

Le commutateur principal **Activer la manette externe** doit rester activé. Le désactiver arrête le traitement des entrées de la manette, y compris les mappages qui utilisent une commande de manette comme déclencheur.

## Mapper un bouton de manette

1. Ouvrez **Mappage**.
2. Sélectionnez **Ajouter des actions** et ajoutez l’action que PlayAbility doit produire.
3. Sur la nouvelle ligne, sélectionnez **Sélectionner un déclencheur**.
4. Sélectionnez **Créer un nouveau déclencheur +**.
5. Sous **Comment voulez-vous le contrôler ?**, sélectionnez **Manette**.
6. Sous **Quel bouton de manette ?**, sélectionnez le bouton physique.
7. Choisissez un **Mode d'action**.
8. Sélectionnez **Enregistrer**.

Les commandes numériques disponibles incluent les boutons principaux, les boutons d’épaule, Back, Start, les boutons des joysticks, les directions du D-pad et le bouton Guide.

## Mapper un joystick ou une gâchette analogique

Les choix proposés dépendent de l’action :

- Pour une action d’axe analogique, sélectionnez l’axe X ou Y du joystick gauche ou droit. Le mouvement analogique est conservé.
- Pour une action de gâchette analogique, sélectionnez la gâchette physique gauche ou droite.
- Pour une action tout ou rien, sélectionnez une direction telle que **Stick Gauche Haut** ou **Stick Droite Gauche**.

Pour utiliser une direction de joystick :

1. Modifiez le mappage et choisissez **Manette**.
2. Sous **Quelle direction du stick ?**, sélectionnez une direction.
3. Réglez **Seuil d’activation (%)**. Une valeur plus élevée exige de déplacer davantage le joystick avant l’activation.
4. Choisissez le mode d’action, puis sélectionnez **Enregistrer**.

Utilisez un axe lorsque vous souhaitez une commande à valeur variable, par exemple pour diriger ou viser. Utilisez une direction de joystick pour une action tout ou rien, par exemple une touche du clavier ou un bouton.

## Combiner la transmission et le remappage

Lorsque **Forward** est activé, PlayAbility traite chaque commande physique de la manière suivante :

- Une commande utilisée par un mappage exécute l’action remappée et n’est pas transmise en même temps sans modification.
- Une commande sans mappage est transmise à la commande correspondante de la manette virtuelle.

Vous pouvez ainsi conserver les commandes que vous utilisez déjà et remplacer uniquement celles que vous souhaitez adapter.

Si la manette physique doit uniquement servir de source de déclenchement, laissez son commutateur **Forward** désactivé.

## Vérifier le mappage de la manette

1. Gardez **Activer la manette externe** activé.
2. Vérifiez que le bon profil est actuel.
3. Activez la **Sortie Principale** et le type de sortie nécessaire.
4. Appuyez sur la commande physique mappée ou déplacez-la.
5. Vérifiez que le mappage répond et que l’action cible s’active.
6. Si **Forward** est activé, testez une commande physique non mappée et vérifiez qu’elle est transmise sans modification.

## Dépannage et limitations

### Aucune manette n’apparaît

Vérifiez que la manette est visible dans le système d’exploitation, puis déconnectez-la et reconnectez-la. Revenez dans **Manettes** après la reconnexion. Si elle n’apparaît toujours pas, redémarrez PlayAbility avec la manette déjà connectée.

### La manette apparaît, mais le mappage ne se déclenche pas

Vérifiez que **Activer la manette externe** est activé. Le réglage **Forward** de la manette n’a pas besoin d’être activé pour les commandes mappées.

### La commande remappée produit aussi son action de manette d’origine

Vérifiez que le mappage utilise la même commande logique que celle signalée par la manette. Si l’action d’origine continue d’être transmise, désactivez **Forward** sur ce périphérique pendant le test.

### Les commandes non mappées ne sont pas transmises

Activez **Forward** sur cette manette physique et vérifiez que la manette virtuelle PlayAbility est disponible. La transmission cible la manette virtuelle ; elle ne corrige pas un pilote de manette virtuelle manquant.

### Une direction de joystick s’active trop tôt ou trop tard

Modifiez le mappage et réglez **Seuil d’activation (%)**. Augmentez-le pour exiger un mouvement plus important, ou réduisez-le pour faciliter l’activation.

### La mauvaise manette active le mappage

Les mappages de manette identifient des commandes logiques, telles que le bouton A, l’axe X du joystick gauche ou la gâchette droite ; ils ne sont pas liés à l’identifiant d’un périphérique précis. La même commande logique d’une autre manette connectée peut activer le mappage. Déconnectez les manettes inutilisées si un comportement propre à un périphérique est nécessaire.

### L’option Manette attendue n’est pas disponible

PlayAbility filtre les entrées de manette selon leur compatibilité avec la sortie. Les boutons et les directions de joystick sont proposés pour les actions tout ou rien, les axes pour les axes analogiques et les gâchettes physiques pour les actions de gâchette analogique.

### Une configuration de plateforme est demandée

Suivez le message affiché par PlayAbility. Linux peut nécessiter un accès ponctuel à `uinput` avant que la manette virtuelle fonctionne ; macOS peut nécessiter son composant HID virtuel ; Windows peut nécessiter le pilote de contrôleur virtuel. Redémarrez PlayAbility après avoir terminé la configuration indiquée.

## Articles connexes

- [Affecter des entrées à des actions de manette virtuelle](https://help.playability.gg/fr/article/affecter-des-entrees-a-des-actions-de-manette-virtuelle-qus4ac/)
- [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/)
- [Utiliser votre téléphone comme contrôleur mobile](https://help.playability.gg/fr/article/utiliser-votre-telephone-comme-controleur-mobile-1h0u8ii/)