> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer une disposition de commandes tactiles personnalisée avec GitHub Copilot

> Créer une disposition de commandes tactiles personnalisée avec GitHub Copilot

Découvrez une méthode plus rapide et plus intelligente pour créer des commandes tactiles personnalisées. **Plus besoin de modifier fastidieusement du JSON !** Avec GitHub Copilot et Visual Studio Code, vous pouvez facilement créer et modifier des dispositions de commandes tactiles personnalisées en donnant simplement des instructions en langage naturel.

Ce guide fournit des étapes claires et pratiques : configuration des outils nécessaires, conception et modification des dispositions tactiles avec Copilot, puis création et test des bundles d'adaptation tactile. Apprenez à donner des instructions efficaces à Copilot et découvrez des astuces pour simplifier votre flux de travail, afin que même les utilisateurs débutants puissent facilement se lancer dans le développement de commandes tactiles. Pour en savoir plus sur la conception des commandes tactiles, consultez [Guide du concepteur pour la création de commandes tactiles](/fr/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide).

**Figure 1.  Capture d'écran de la génération d'une disposition tactile par Copilot Chat dans VS Code.**

<img src="https://mintcdn.com/microsoft-4404708b/nTPVBuko1tKGsd6P/images/gdk/features/common/github-copilot-generate-touch-layout.webp?fit=max&auto=format&n=nTPVBuko1tKGsd6P&q=85&s=6caeeb2b79dd47f63548fc0d32b3f2ef" alt="Capture d'écran de la génération d'une disposition tactile par Copilot Chat dans VS Code." width="1920" height="1080" data-path="images/gdk/features/common/github-copilot-generate-touch-layout.webp" />

## Prérequis

* Installez la dernière version de [Visual Studio Code](https://code.visualstudio.com/download).
* Installez l'[outil en ligne de commande du Touch Adaptation Kit (TAK CLI)](https://github.com/microsoft/xbox-game-streaming-tools?tab=readme-ov-file#touch-adaptation-kit-command-line-tool-tak-cli).
* Installez l'[extension Touch Adaptation Kit Editor pour Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=xbox-tools.vscode-xbox-input-editor-extension) et effectuez la [configuration de TAK Editor](/fr/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-setup).
* [Configurez GitHub Copilot dans Visual Studio Code](https://code.visualstudio.com/docs/copilot/setup).
* Téléchargez [copilot-instructions.md](https://github.com/microsoft/xbox-game-streaming-tools/tree/main/touch-adaptation-kit/copilot-instructions) sur votre PC.
  Ce fichier sert d'ensemble d'instructions personnalisées pour adapter les réponses de GitHub Copilot lors de la création de dispositions de commandes tactiles personnalisées. Pour plus d'informations, consultez [À propos de la personnalisation des réponses de GitHub Copilot](https://docs.github.com/en/copilot/concepts/prompting/response-customization).

## Étapes

1. Lancez Visual Studio Code.

2. Suivez la [configuration de TAK Editor pour ouvrir un espace de travail](/fr/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-setup#open-a-folder-or-workspace) et [créez un nouveau bundle et une nouvelle disposition](/fr/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-create-bundle).

3. Créez un dossier `.github` à la racine du dossier de l'espace de travail où se trouve le bundle, puis placez le fichier copilot-instructions.md dans le dossier `.github`. En plaçant les instructions à cet endroit, vous permettez à Copilot de se référer aux règles de conception lors de la modification du JSON de la disposition.

   **Figure 2.  Capture d'écran de l'arborescence du dossier .github et du fichier copilot-instructions.md.**

   <img src="https://mintcdn.com/microsoft-4404708b/UZTRJSf0emX1fheE/images/gdk/features/common/github-folder-copilot-instructions.png?fit=max&auto=format&n=UZTRJSf0emX1fheE&q=85&s=4357244630aa6bf7a70d69961088522d" alt="Capture d'écran de l'arborescence du dossier .github et du fichier copilot-instructions.md." width="407" height="385" data-path="images/gdk/features/common/github-folder-copilot-instructions.png" />

4. [Ouvrez la fenêtre Copilot Chat](https://code.visualstudio.com/docs/copilot/chat/getting-started-chat) (raccourci clavier `Ctrl+Alt+I`).

5. Dans l'explorateur de Visual Studio Code, sélectionnez le fichier JSON de disposition que vous avez créé dans le dossier des dispositions. Cette sélection garantit que Copilot Chat utilise le fichier comme contexte pour votre session de modification.

   **Figure 3.  Capture d'écran de la sélection du fichier JSON cible pour l'ajouter comme contexte pour Copilot.**

   <img src="https://mintcdn.com/microsoft-4404708b/UZTRJSf0emX1fheE/images/gdk/features/common/select-json-file-to-add-as-context.png?fit=max&auto=format&n=UZTRJSf0emX1fheE&q=85&s=07537d4f75db57712b310d13a1691892" alt="Capture d'écran de la sélection du fichier JSON cible pour l'ajouter comme contexte pour Copilot." width="709" height="217" data-path="images/gdk/features/common/select-json-file-to-add-as-context.png" />

6. Assurez-vous que le mode `Agent` est sélectionné afin que Copilot fournisse une explication détaillée du résultat de la modification, puis sélectionnez le [modèle d'IA](https://code.visualstudio.com/docs/copilot/customization/language-models) de votre choix.

   **Figure 4.  Capture d'écran de la vérification du mode agent et de la sélection du modèle d'IA.**

   <img src="https://mintcdn.com/microsoft-4404708b/UZTRJSf0emX1fheE/images/gdk/features/common/select-agent-mode-and-ai-model.png?fit=max&auto=format&n=UZTRJSf0emX1fheE&q=85&s=f2373c7b7d031d952339d513e8141f8a" alt="Capture d'écran de la vérification du mode agent et de la sélection du modèle d'IA." width="540" height="173" data-path="images/gdk/features/common/select-agent-mode-and-ai-model.png" />

7. Il est recommandé de préparer le mappage des boutons de manette de votre titre afin de garantir une configuration et une facilité d'utilisation optimales.
   Par exemple :

```
   A button: Jump
   B button: Dodge
   X button: Punch
   Y button: Kick
   Directional Pad: Select items
   Left Stick: Move character
   Right Stick: Camera control
   Left Trigger: Throw granade
   Right Trigger: Fire weapon
   View button: Open map
   Menu button: Open menu
```

1. Demandez à Copilot de modifier le JSON de la disposition cible à l'aide de votre mappage des boutons de manette.
   Par exemple :

```
   Can you edit the touch layout JSON for a game scene that consists of the following controller button mapping?
   A button: Jump
   B button: Dodge
   X button: Punch
   Y button: Kick
   Directional Pad: Select items
   Left Stick: Move character
   Right Stick: Camera control
   Left Trigger: Throw granade
   Right Trigger: Fire weapon
   View button: Open map
   Menu button: Open menu
```

<Note>
  Assurez-vous que Copilot se réfère à copilot-instructions.md après lui avoir demandé d'effectuer la modification, afin qu'il puisse appliquer les règles de conception appropriées à votre disposition.

  **Figure 5.  Capture d'écran de la confirmation de l'utilisation des instructions Copilot.**

  <img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/confirm-copilot-instructions-usage.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=30fbc0faf30b123df423f94cd6b0e943" alt="Capture d'écran de la confirmation de l'utilisation des instructions Copilot." width="547" height="222" data-path="images/gdk/features/common/confirm-copilot-instructions-usage.png" />

  Veillez à autoriser Copilot à récupérer les ressources, le schéma et le guide du concepteur à partir des URL de référence lorsque cela vous est demandé dans la fenêtre de conversation. Cette action garantit des réponses précises et fournit les meilleurs résultats possibles pour votre demande.

  **Figure 6.  Capture d'écran de l'autorisation donnée à Copilot de récupérer les ressources.**

  <img src="https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/copilot-allow-fetch-resources.png?fit=max&auto=format&n=sIrPFR_ir_sNKVEv&q=85&s=9c754ec8283b7b994c73f20b4510f88b" alt="Capture d'écran de l'autorisation donnée à Copilot de récupérer les ressources." width="841" height="207" data-path="images/gdk/features/common/copilot-allow-fetch-resources.png" />
</Note>

9. Itérer et tester jusqu'à la finalisation

Utilisez Copilot Chat pour affiner le fichier JSON de disposition jusqu'à ce qu'il réponde à vos exigences de conception. Renommez le fichier pour refléter le scénario de jeu prévu (par exemple, `battle.json`, `menu.json`, `map.json`). Si plusieurs dispositions sont nécessaires, répétez le même processus pour chacune d'elles.

Après chaque modification, validez la disposition dans votre environnement de jeu :

* Diffusez votre titre en streaming à l'aide de l'[application de test de contenu web (CTA)](/fr/build/core-features/common/game-streaming/game-streaming-web-content-test-application).
* Servez la disposition tactile avec la [commande serve de TAK](/fr/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command).

Continuez à alterner entre les modifications effectuées par Copilot et les tests en jeu jusqu'à ce que la disposition soit finalisée.

**Figure 7.  Capture d'écran des dispositions de commandes tactiles générées par Copilot.**

<img src="https://mintcdn.com/microsoft-4404708b/CwRBzaXvHw9zaPoe/images/gdk/features/common/touch-control-layouts-generated-by-copilot.png?fit=max&auto=format&n=CwRBzaXvHw9zaPoe&q=85&s=cc2f05aea2e65528cd16e684f30135d5" alt="Capture d'écran des dispositions de commandes tactiles générées par Copilot." width="2560" height="1380" data-path="images/gdk/features/common/touch-control-layouts-generated-by-copilot.png" />

<Tip>
  **Utilisez la terminologie officielle pour de meilleurs résultats**
  Utilisez uniquement les termes du [guide du concepteur](/fr/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide) pour que Copilot puisse fournir de meilleurs résultats :

  * « move A button to the right wheel inner. »
  * « move B button to the left in the same right outer wheel. »
  * « can you assign an interact icon to the A button? »
  * « exchange the position of the X button and Y button in the right outer wheel. »
  * « remove R thumb from the layout. »

  **Conseil de pro :** vous pouvez également modifier le fichier `copilot-instructions.md` pour l'adapter à vos besoins spécifiques. En personnalisant les instructions, vous pouvez affiner le comportement de Copilot et recevoir des conseils parfaitement alignés sur vos objectifs de conception.
</Tip>


## Related topics

- [Création de dispositions de commandes tactiles](/fr/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-building-touch-layout.md)
- [Guide du concepteur pour la création de commandes tactiles](/fr/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide.md)
- [Optimiser les flux de travail de développement de jeux avec Visual Studio et l'IA](/fr/build/core-features/graphics/overviews/presentations/xdd2024/gc-graphics-xdd-2024-gr12.md)
- [Création de dispositions de contrôles tactiles pour le streaming de jeux XBOX](/fr/build/core-features/common/game-streaming/building-touch-layouts/index.md)
- [Prise en main des dispositions de bundles tactiles](/fr/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-getting-started-with-sample-layouts.md)
