Version v0.3.0 de l'exemple XBOX Godot

​

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

​

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_*.

# Before
var result: GDKResult = GDK.initialize()
var user: GDKUser = result.data

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

// 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é

​

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.

# Before
if GDK.get_class() == "GDK":

# After
if GDK.get_class() == "Xbox":

​

Comment migrer

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

​

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
• Version v0.2.0 de l’exemple XBOX Godot
• Versions de l’exemple XBOX Godot