Version 0.3.0 de l'exemple XBOX Godot

​

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

​

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

# 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 ce changement

​

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.

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

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

​

Comment effectuer la migration

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