XBOX Godot Sample v0.3.0 Release

​

주요 하이라이트

• 더 넓은 엔진 호환성을 위한 호환성이 깨지는 타입 이름 변경. 스크립트에서 볼 수 있는 타입 이름이 변경되었습니다. 예를 들어 GDKUser는 XboxUser로 변경되어, XBOX Series X|S 콘솔 플랫폼 계층을 제공하는 Godot 포크에 애드온을 추가하더라도 해당 포크가 이미 등록한 타입과 충돌하지 않게 됩니다.
• 더 풍부한 PlayFab Party 음성 및 채팅. PlayFab 트랙에 Party 채팅 인디케이터, 음성 컨트롤, 텍스트-음성 변환, 네트워크 진단이 추가되었습니다.
• 더 완전한 XUser 커버리지. 누락된 XUser API 래퍼가 구현되어 XR-112 적합성 작업을 가능하게 합니다.
• C# 익스포트 수정. “XBOX on PC” 익스포트가 이제 C# 어셈블리를 함께 제공하며, 실행 파일과 .pck는 Godot 자체의 Windows 익스포트 경로로 위임됩니다.
• 커뮤니티가 보고한 수정 사항. 게임 저장 할당량 쿼리, 릴리스 빌드가 디버그 godot-cpp를 링크하던 문제, GDK Tutorial 3 샘플과 관련된 이슈가 해결되었습니다.

​

Breaking change: GDK addon type rename

​

무엇이 변경되었는가

• GDScript 타입 이름이 변경되었습니다. 예: GDKUser는 XboxUser, GDKResult는 XboxResult, GDKAchievement는 XboxAchievement.
• C# 파사드도 함께 이동했습니다. 네임스페이스 GodotGdk는 GodotXbox가 되고, 정적 진입점 클래스 Gdk도 그에 맞게 이름이 변경됩니다. 아래를 참조하세요.
• 부트스트랩 오토로드 이름이 GDKBootstrap에서 XboxBootstrap로 변경되었습니다.
• MSIXVC 패키징 포워더 환경 변수 이름이 GDKPKG_*에서 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>();

​

왜 변경되었는가

​

변경되지 않은 것

• 엔진 싱글톤은 여전히 GDK로 등록됩니다. GDK.initialize()와 GDK.users.add_default_user_async() 같은 호출은 변경 없이 계속 동작합니다.
• addons/godot_gdk 폴더, godot_gdk.gdextension 진입점, gdk/runtime/* 및 gdk/packaging/* Project Settings.
• PlayFab* 및 GameInput* 타입. 이름 변경은 GDK 애드온으로 범위가 한정됩니다.
• gdk 익스포트 기능 태그, “XBOX on PC” 익스포트 플랫폼, GodotGdkCSharp 프로젝트 및 어셈블리 이름.

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

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

​

마이그레이션 방법

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

​

주목할만한 변경 사항

​

새로운 기능

• godot_playfab 애드온의 Party 채팅 인디케이터, 음성 컨트롤, 텍스트-음성 변환, 네트워크 진단.
• 누락된 XUser API 래퍼로 XR-112 적합성 작업을 지원합니다.
• 엔진 싱글톤 이름을 제어하는 Project Setting.

​

개선 사항

• 스크립트 노출 GDK 애드온 타입 이름 변경(예: GDKUser에서 XboxUser)과 함께 마이그레이션 가이드 및 코드모드 제공. 이는 호환성이 깨지는 변경입니다.
• 빠른 시작, 배지, 문구 정리와 함께 블로그 및 Discord 링크를 추가하여 README 발견 가능성을 개선했습니다.
• 문서 헤딩 구조를 정리하고 깨진 앵커를 수정했습니다.

​

수정 사항

• “XBOX on PC” 익스포트가 이제 C# 어셈블리를 함께 제공합니다.
• “XBOX on PC” 익스포트는 실행 파일과 .pck를 Godot의 Windows 익스포트 경로로 위임합니다.
• 게임 저장 할당량 쿼리가 이제 메인 스레드 밖에서 실행됩니다.
• 릴리스 빌드가 더 이상 디버그 godot-cpp를 조용히 링크하지 않습니다.
• GDK Tutorial 3 샘플에서 Title Storage 업로드가 제거되었습니다.

​

엔지니어링 및 CI

• 문서 전용 변경에 대해 PR 게이트가 건너뛰어집니다.

​

관련 항목

• Godot 시작하기
• XBOX Godot Sample v0.2.0 Release
• XBOX Godot sample releases