> ## 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 v0.3.0 de l'exemple XBOX Godot

> Renommage de types avec rupture de compatibilité, nouvelles fonctionnalités, améliorations et correctifs de la v0.3.0 de l'exemple XBOX Godot permettant de créer des jeux Godot publiés sur 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 services XBOX 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 commits, 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 une modification avec rupture de compatibilité. Tous les types visibles par les scripts de l'addon `godot_gdk` ont été renommés : `GDKUser` est désormais `XboxUser` et `GDKResult` est désormais `XboxResult`, et aucun alias déprécié n'est fourni. Si vous mettez à niveau un projet existant, consultez [Modification avec rupture de compatibilité : renommage des types de l'addon GDK](#breaking-change-gdk-addon-type-rename).
</Info>

## Points forts

* **Renommage de types avec rupture de compatibilité pour une compatibilité élargie avec les moteurs.** Les types visibles par les scripts ont été renommés, par exemple `GDKUser` en `XboxUser`, afin que l'addon puisse être intégré dans des forks de Godot qui fournissent une couche de plateforme console XBOX Series X|S sans entrer en conflit avec les types que ces forks enregistrent déjà.
* **Voix et conversation PlayFab Party plus riches.** Des indicateurs de conversation Party, des commandes vocales, la synthèse vocale et des diagnostics réseau ont été ajoutés au parcours PlayFab.
* **Couverture XUser plus complète.** Les wrappers d'API XUser manquants ont été implémentés, ce qui permet le travail de conformité XR-112.
* **Correctifs de l'exportation C#.** Une exportation « XBOX on PC » fournit 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 version liant la version de débogage de `godot-cpp` et à l'exemple GDK Tutorial 3.

## Modification avec rupture de compatibilité : renommage des types de l'addon GDK

Dans la v0.3.0, tous les types visibles par les scripts de l'addon `godot_gdk` ont reçu un nouveau nom : `GDKUser` est désormais `XboxUser`, `GDKResult` est désormais `XboxResult`, etc. **Aucun alias `GDK*` déprécié n'est fourni**. Tout projet qui nomme directement ces types doit donc être mis à jour pour pouvoir se charger.

### 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 le même mouvement : l'espace de noms `GodotGdk` devient `GodotXbox`, et la classe de point d'entrée statique `Gdk` est renommée en conséquence, comme indiqué ci-dessous.
* L'autoload d'amorçage est renommé de `GDKBootstrap` en `XboxBootstrap`.
* Les variables d'environnement du redirecteur d'empaquetage 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 cela a changé

Godot enregistre les classes d'extension dans un seul espace de noms plat `ClassDB`, de sorte que deux fournisseurs qui exposent le même nom de type ne peuvent pas coexister dans un même projet. Les forks de Godot qui ajoutent la prise en charge des consoles 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 forks utilisent déjà. Le renommage des types de l'addon les maintient distincts afin qu'il puisse être intégré dans un tel fork.

La même build de l'addon s'exécute sur PC et sur console. Il n'existe pas de compilation, de préréglage ou 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 tels que `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 est limité à l'addon GDK.
* La balise de fonctionnalité d'exportation `gdk`, la plateforme d'exportation « XBOX on PC » ainsi que le projet et le nom d'assembly `GodotGdkCSharp`.

<Warning>
  Le nom de classe `ClassDB` et le nom du singleton sont désormais des chaînes différentes. Le singleton est toujours enregistré sous le nom `GDK`, mais la classe sous-jacente ne l'est plus, de sorte qu'une vérification telle que `is_class("GDK")` ne correspond plus. Effectuez plutôt la comparaison avec la classe renommée :

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

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

### Comment migrer

L'exemple fournit un 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 consulter les tables de correspondance complètes entre anciens et 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 conversation Party, commandes vocales, synthèse vocale et diagnostics réseau dans l'addon `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 de l'addon GDK visibles par les scripts, par exemple `GDKUser` en `XboxUser`, avec un guide de migration et un codemod. Il s'agit d'une modification avec rupture de compatibilité.
* 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 blog et Discord.
* Nettoyage de la structure des titres de la documentation et correction des ancres rompues.

### Correctifs

* Une exportation « XBOX on PC » fournit 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 version ne lient plus silencieusement la version de débogage de `godot-cpp`.
* Suppression du chargement Title Storage de l'exemple GDK Tutorial 3.

### Ingénierie et CI

* Les vérifications de PR sont ignorées pour les modifications portant uniquement sur la documentation.

## Rubriques connexes

* [Prise en main de Godot](/fr/build/gdk-and-engines/godot)
* [Version v0.2.0 de l'exemple XBOX Godot](/fr/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

- [Versión v0.3.0 de XBOX Godot Sample](/es/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0.md)
- [Versión v0.1.0 de XBOX Godot Sample](/es/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-1-0.md)
- [Versión v0.2.0 de XBOX Godot Sample](/es/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0.md)
- [XBOX Godot Sample v0.3.0 Release](/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0.md)
- [Uso del GDK con Godot](/es/build/gdk-and-engines/godot.md)