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

# Version 0.3.0 de l'exemple XBOX Godot

> Changement de noms de types non rétrocompatible, nouvelles fonctionnalités, améliorations et correctifs de la v0.3.0 de l'exemple XBOX Godot pour créer des jeux Godot destinés à XBOX sur PC.

***Date de publication : 19 août 2026***

L'[exemple XBOX Godot](https://aka.ms/XBOXGodotSample) est une référence publique, fournie uniquement sous forme de code source, qui montre comment créer une extension Godot intégrant le Microsoft GDK, les XBOX services et PlayFab, afin que vous puissiez créer votre titre pour XBOX sur PC. Cet article résume les modifications de la version **v0.3.0 - Compatibility + Community Fixes**.

Pour obtenir la liste complète des validations, consultez le [journal des modifications complet de la v0.3.0](https://github.com/microsoft/XBOX-Godot-Sample/compare/v0.2.0...v0.3.0) sur GitHub. Pour obtenir la version, consultez [v0.3.0 sur GitHub](https://github.com/microsoft/XBOX-Godot-Sample/releases/tag/v0.3.0).

<Info>
  Cette version contient un changement non rétrocompatible. Chaque type visible par les scripts dans le module complémentaire `godot_gdk` a été renommé : `GDKUser` est maintenant `XboxUser` et `GDKResult` est maintenant `XboxResult`, et aucun alias déprécié n'est fourni. Si vous mettez à niveau un projet existant, consultez [Changement non rétrocompatible : renommage des types du module complémentaire GDK](#breaking-change-gdk-addon-type-rename).
</Info>

## Points saillants

* **Renommage non rétrocompatible des types pour une compatibilité élargie avec les moteurs.** Les types visibles par les scripts ont été renommés, par exemple `GDKUser` en `XboxUser`, afin que le module complémentaire puisse être intégré à des duplications (forks) de Godot qui fournissent une couche de plateforme console XBOX Series X|S, sans entrer en conflit avec les types que ces duplications enregistrent déjà.
* **Voix et clavardage PlayFab Party enrichis.** Des indicateurs de clavardage Party, des commandes vocales, la synthèse vocale et des diagnostics réseau ont été ajoutés au parcours PlayFab.
* **Couverture plus complète de XUser.** Les wrappers d'API XUser manquants ont été implémentés, ce qui permet le travail de conformité XR-112.
* **Correctifs d'exportation C#.** Une exportation « XBOX on PC » inclut désormais les assemblys C#, et l'exécutable ainsi que le fichier `.pck` sont délégués au propre chemin d'exportation Windows de Godot.
* **Correctifs signalés par la communauté.** Résolution de problèmes liés aux requêtes de quota de sauvegarde de jeu, aux builds de mise en production liées à la version de débogage de `godot-cpp` et à l'exemple GDK Tutorial 3.

## Changement non rétrocompatible : renommage des types du module complémentaire GDK

Dans la v0.3.0, chaque type visible par les scripts dans le module complémentaire `godot_gdk` a reçu un nouveau nom : `GDKUser` est maintenant `XboxUser`, `GDKResult` est maintenant `XboxResult`, et ainsi de suite. **Aucun alias `GDK*` déprécié n'est fourni**; tout projet qui nomme directement ces types doit donc être mis à jour avant de pouvoir être chargé.

### Ce qui a changé

* Les types GDScript sont renommés, par exemple `GDKUser` en `XboxUser`, `GDKResult` en `XboxResult` et `GDKAchievement` en `XboxAchievement`.
* La façade C# a suivi : l'espace de noms `GodotGdk` devient `GodotXbox`, et la classe de point d'entrée statique `Gdk` est renommée en conséquence, comme illustré ci-dessous.
* Le chargement automatique d'amorçage est renommé de `GDKBootstrap` en `XboxBootstrap`.
* Les variables d'environnement du redirecteur de création de packages MSIXVC sont renommées de `GDKPKG_*` en `XBOXPKG_*`.

```gdscript theme={null}
# Before
var result: GDKResult = GDK.initialize()
var user: GDKUser = result.data

# After
var result: XboxResult = GDK.initialize()
var user: XboxUser = result.data
```

```csharp theme={null}
// Before
using GodotGdk;
GdkResult init = Gdk.Initialize();
GdkUser user = res.DataAs<GdkUser>();

// After
using GodotXbox;
XboxResult init = Xbox.Initialize();
XboxUser user = res.DataAs<XboxUser>();
```

### Pourquoi ce changement

Godot enregistre les classes d'extension dans un espace de noms `ClassDB` unique et plat; deux fournisseurs qui exposent le même nom de type ne peuvent donc pas coexister dans un même projet. Les duplications de Godot qui ajoutent la prise en charge de la console XBOX Series X|S fournissent leur propre couche de plateforme, leurs exportations et leurs types, et le préfixe `GDK` entrait en conflit avec des noms que ces duplications utilisent déjà. Renommer les types du module complémentaire les garde distincts, ce qui permet de l'intégrer à une telle duplication.

La même build du module complémentaire s'exécute sur PC et sur console. Il n'y a pas de compilation, de préréglage ni de définition conditionnelle distincts pour la console, et `godot_gdk.gdextension` continue de déclarer uniquement les bibliothèques `windows.*.x86_64`.

### Ce qui n'a pas changé

* Le singleton du moteur est toujours enregistré sous le nom `GDK`. Les appels comme `GDK.initialize()` et `GDK.users.add_default_user_async()` continuent de fonctionner sans modification.
* Le dossier `addons/godot_gdk`, le point d'entrée `godot_gdk.gdextension` et les paramètres de projet `gdk/runtime/*` et `gdk/packaging/*`.
* Les types `PlayFab*` et `GameInput*`. Le renommage se limite au module complémentaire GDK.
* La balise de fonctionnalité d'exportation `gdk`, la plateforme d'exportation « XBOX on PC » ainsi que le nom du projet et de l'assembly `GodotGdkCSharp`.

<Warning>
  Le nom de classe `ClassDB` et le nom du singleton sont maintenant des chaînes différentes. Le singleton est toujours enregistré sous le nom `GDK`, mais la classe sous-jacente ne l'est plus; une vérification comme `is_class("GDK")` ne correspond donc plus. Comparez plutôt avec la classe renommée :

  ```gdscript theme={null}
  # Before
  if GDK.get_class() == "GDK":

  # After
  if GDK.get_class() == "Xbox":
  ```
</Warning>

### Comment effectuer la migration

L'exemple fournit un outil de modification de code (codemod) avec le guide de migration. Validez d'abord votre projet, car le codemod réécrit les fichiers sur place.

```powershell theme={null}
.\tools\migrate_gdk_to_xbox.ps1 -Path C:\path\to\your\godot\project -WhatIf
.\tools\migrate_gdk_to_xbox.ps1 -Path C:\path\to\your\godot\project
```

Le codemod ne réécrit délibérément pas un jeton `GDK` isolé, car dans la plupart des projets, ce jeton correspond au singleton, qui ne doit pas changer. Il signale les occurrences ambiguës qu'il trouve afin que vous puissiez les examiner manuellement.

Pour les tableaux de correspondance complets entre les anciens et les nouveaux noms pour GDScript et C#, consultez [Migrating to v0.3.0](https://github.com/microsoft/XBOX-Godot-Sample/blob/main/docs/gdk/migration-v0.3.md) dans le dépôt de l'exemple.

## Modifications notables

### Nouvelles fonctionnalités

* Indicateurs de clavardage Party, commandes vocales, synthèse vocale et diagnostics réseau dans le module complémentaire `godot_playfab`.
* Les wrappers d'API XUser manquants, qui permettent le travail de conformité XR-112.
* Un paramètre de projet qui contrôle le nom du singleton du moteur.

### Améliorations

* Renommage des types du module complémentaire GDK visibles par les scripts, par exemple `GDKUser` en `XboxUser`, avec un guide de migration et un codemod. Il s'agit d'un changement non rétrocompatible.
* Amélioration de la découvrabilité du README avec un démarrage rapide, des badges et un nettoyage du texte, ainsi que des liens vers le blogue et Discord.
* Nettoyage de la structure des titres de la documentation et correction des ancres brisées.

### Correctifs

* Une exportation « XBOX on PC » inclut désormais les assemblys C#.
* L'exportation « XBOX on PC » délègue l'exécutable et le fichier `.pck` au chemin d'exportation Windows de Godot.
* La requête de quota de sauvegarde de jeu s'exécute désormais en dehors du thread principal.
* Les builds de mise en production ne sont plus liées silencieusement à la version de débogage de `godot-cpp`.
* Retrait du téléversement Title Storage de l'exemple GDK Tutorial 3.

### Ingénierie et intégration continue

* Les barrières de PR sont ignorées pour les modifications touchant uniquement la documentation.

## Rubriques connexes

* [Bien démarrer avec Godot](/fr-CA/build/gdk-and-engines/godot)
* [Version 0.2.0 de l'exemple XBOX Godot](/fr-CA/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0)
* [Versions de l'exemple XBOX Godot](https://github.com/microsoft/XBOX-Godot-Sample/releases)


## Related topics

- [Version 0.1.0 de l'exemple XBOX Godot NetRumble](/fr-CA/build/gdk-and-engines/godot-release-notes/godot-netrumble-release-notes-0-1-0.md)
- [Utiliser le GDK avec Godot](/fr-CA/build/gdk-and-engines/godot.md)
- [Version 0.1.0 de l'exemple XBOX Godot](/fr-CA/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-1-0.md)
- [Version 0.2.0 de l'exemple XBOX Godot](/fr-CA/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0.md)
- [Aperçu de Godot et des moteurs communautaires](/fr-CA/paths/community-engines/overview.md)