Versão v0.3.0 do XBOX Godot Sample

​

Principais destaques

• Renomeação de tipos com alteração significativa para maior compatibilidade com mecanismos. Os tipos visíveis em script foram renomeados, como GDKUser para XboxUser, para que o complemento possa ser incluído em forks do Godot que fornecem uma camada de plataforma de console XBOX Series X|S sem colidir com os tipos que esses forks já registram.
• Voz e chat do PlayFab Party mais completos. Indicadores de chat do Party, controles de voz, conversão de texto em fala e diagnósticos de rede foram adicionados à trilha do PlayFab.
• Cobertura mais completa do XUser. Os wrappers de API do XUser que faltavam foram implementados, o que possibilita o trabalho de conformidade com o XR-112.
• Correções na exportação em C#. Uma exportação “XBOX on PC” agora inclui os assemblies em C#, e o executável e o .pck são delegados ao próprio caminho de exportação para Windows do Godot.
• Correções relatadas pela comunidade. Foram resolvidos problemas relacionados a consultas de cota de salvamento de jogo, builds de versão que vinculavam o godot-cpp de depuração e o exemplo GDK Tutorial 3.

​

Alteração significativa: renomeação de tipos do complemento GDK

​

O que mudou

• Os tipos do GDScript foram renomeados, por exemplo, GDKUser para XboxUser, GDKResult para XboxResult e GDKAchievement para XboxAchievement.
• A fachada em C# foi alterada junto com eles: o namespace GodotGdk passa a ser GodotXbox, e a classe estática de ponto de entrada Gdk foi renomeada de forma correspondente, conforme mostrado abaixo.
• O autoload de inicialização foi renomeado de GDKBootstrap para XboxBootstrap.
• As variáveis de ambiente do encaminhador de empacotamento MSIXVC foram renomeadas de GDKPKG_* para 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 que mudou

​

O que não mudou

• O singleton do mecanismo ainda é registrado como GDK. Chamadas como GDK.initialize() e GDK.users.add_default_user_async() continuam funcionando sem alterações.
• A pasta addons/godot_gdk, o ponto de entrada godot_gdk.gdextension e as Configurações do Projeto gdk/runtime/* e gdk/packaging/*.
• Os tipos PlayFab* e GameInput*. A renomeação se limita ao complemento GDK.
• A tag de recurso de exportação gdk, a plataforma de exportação “XBOX on PC” e o nome do projeto e do assembly GodotGdkCSharp.

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

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

​

Como 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

​

Alterações notáveis

​

Novos recursos

• Indicadores de chat do Party, controles de voz, conversão de texto em fala e diagnósticos de rede no complemento godot_playfab.
• Os wrappers de API do XUser que faltavam, que possibilitam o trabalho de conformidade com o XR-112.
• Uma Configuração do Projeto que controla o nome do singleton do mecanismo.

​

Melhorias

• Os tipos do complemento GDK visíveis em script foram renomeados, por exemplo, GDKUser para XboxUser, com um guia de migração e um codemod. Esta é uma alteração significativa.
• A capacidade de descoberta do README foi aprimorada com um início rápido, selos e revisão de texto, além de links para o blog e o Discord.
• A estrutura de títulos da documentação foi organizada e âncoras quebradas foram corrigidas.

​

Correções

• Uma exportação “XBOX on PC” agora inclui os assemblies em C#.
• A exportação “XBOX on PC” delega o executável e o .pck ao caminho de exportação para Windows do Godot.
• A consulta de cota de salvamento de jogo agora é executada fora do thread principal.
• Os builds de versão não vinculam mais silenciosamente o godot-cpp de depuração.
• O upload para o Title Storage foi removido do exemplo GDK Tutorial 3.

​

Engenharia e CI

• As verificações de PR são ignoradas em alterações somente de documentação.

​

Tópicos relacionados

• Introdução ao Godot
• Versão v0.2.0 do XBOX Godot Sample
• Versões do exemplo XBOX Godot