Versión v0.3.0 de XBOX Godot Sample

​

Aspectos destacados

• Cambio importante de nombre de tipos para una compatibilidad más amplia con el motor. Se cambió el nombre de los tipos visibles desde scripts, como GDKUser a XboxUser, para que el complemento pueda incorporarse a bifurcaciones de Godot que proporcionan una capa de plataforma para la consola XBOX Series X|S sin entrar en conflicto con los tipos que esas bifurcaciones ya registran.
• Voz y chat de PlayFab Party más completos. Se agregaron indicadores de chat de Party, controles de voz, texto a voz y diagnósticos de red a la ruta de PlayFab.
• Cobertura de XUser más completa. Se implementaron los contenedores de la API XUser que faltaban, lo que habilita el trabajo de conformidad con XR-112.
• Correcciones de exportación de C#. Una exportación “XBOX on PC” ahora incluye los ensamblados de C#, y el ejecutable y el .pck se delegan a la propia ruta de exportación de Windows de Godot.
• Correcciones notificadas por la comunidad. Se resolvieron problemas relacionados con las consultas de cuota de guardado de juegos, las compilaciones de versión que vinculaban el godot-cpp de depuración y el ejemplo GDK Tutorial 3.

​

Cambio importante: cambio de nombre de los tipos del complemento del GDK

​

Qué cambió

• Se cambió el nombre de los tipos de GDScript, por ejemplo, GDKUser a XboxUser, GDKResult a XboxResult y GDKAchievement a XboxAchievement.
• La fachada de C# se movió con ellos: el espacio de nombres GodotGdk pasa a ser GodotXbox, y la clase de punto de entrada estática Gdk se renombra en consecuencia, como se muestra a continuación.
• El autoload de arranque se renombró de GDKBootstrap a XboxBootstrap.
• Las variables de entorno del reenviador de empaquetado MSIXVC se renombraron de GDKPKG_* a 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>();

​

Por qué cambió

​

Qué no cambió

• El singleton del motor sigue registrado como GDK. Las llamadas como GDK.initialize() y GDK.users.add_default_user_async() siguen funcionando sin cambios.
• La carpeta addons/godot_gdk, el punto de entrada godot_gdk.gdextension y los valores de Project Settings gdk/runtime/* y gdk/packaging/*.
• Los tipos PlayFab* y GameInput*. El cambio de nombre se limita al complemento del GDK.
• La etiqueta de característica de exportación gdk, la plataforma de exportación “XBOX on PC” y el nombre del proyecto y ensamblado GodotGdkCSharp.

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

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

​

Cómo migrar

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

​

Cambios destacados

​

Nuevas características

• Indicadores de chat de Party, controles de voz, texto a voz y diagnósticos de red en el complemento godot_playfab.
• Los contenedores de la API XUser que faltaban, que habilitan el trabajo de conformidad con XR-112.
• Un valor de Project Setting que controla el nombre del singleton del motor.

​

Mejoras

• Se cambió el nombre de los tipos del complemento del GDK visibles desde scripts, por ejemplo, GDKUser a XboxUser, con una guía de migración y un codemod. Este es un cambio importante.
• Se mejoró la capacidad de descubrimiento del README con un inicio rápido, insignias y limpieza del texto, además de vínculos al blog y a Discord.
• Se limpió la estructura de encabezados de la documentación y se corrigieron anclas rotas.

​

Correcciones

• Una exportación “XBOX on PC” ahora incluye los ensamblados de C#.
• La exportación “XBOX on PC” delega el ejecutable y el .pck a la ruta de exportación de Windows de Godot.
• La consulta de cuota de guardado de juegos ahora se ejecuta fuera del hilo principal.
• Las compilaciones de versión ya no vinculan de forma silenciosa el godot-cpp de depuración.
• Se eliminó la carga de Title Storage del ejemplo GDK Tutorial 3.

​

Ingeniería y CI

• Las puertas de PR se omiten para los cambios que solo afectan a la documentación.

​

Temas relacionados

• Introducción a Godot
• Versión v0.2.0 de XBOX Godot Sample
• Versiones del ejemplo de Godot para XBOX