Skip to main content
릴리스 날짜: 2026년 7월 30일 XBOX Godot 샘플은 Microsoft GDK, XBOX 서비스, PlayFab을 통합하는 Godot 확장을 빌드하는 방법을 보여주는 공개 소스 전용 참조 자료로, XBOX for PC용 타이틀을 빌드할 수 있도록 지원합니다. 이 문서는 v0.2.0 - Community Fixes + Godot .NET Support 릴리스의 변경 사항을 요약합니다. 전체 커밋 목록은 GitHub의 v0.2.0 전체 변경 로그를 참조하세요. 릴리스를 받으려면 GitHub의 v0.2.0을 참조하세요.

주요 하이라이트

  • Godot .NET(C#) 지원. 파사드(facade) 애드온, 튜토리얼 샘플, 패리티 게이트가 포함된 관리형 C# 트랙을 통해 Godot .NET 프로젝트에서 GDK와 PlayFab을 통합할 수 있습니다.
  • 더 광범위한 GDK 및 Godot 버전 지원. 샘플은 이제 더 넓은 범위의 GDK 에디션(빌드 타임 셀렉터를 사용하는 2025년 10월 에디션 포함)과 Godot 버전(CI는 이제 새 기본값인 Godot 4.7.1-stable까지 테스트)에서 작동합니다.
  • 더 모듈화된 샘플. 각 통합을 개별적으로 또는 함께 채택할 수 있도록 샘플이 모듈화된 GDK, PlayFab, Integrated 트랙으로 재구성되었습니다.
  • GDK API 참조 100% 커버리지. text-to-speech, Store 및 Game UI show-UIs, 이벤트, feature probe, Game Save, XSAPI fills, GameChat2를 포함한 전체 GDK API 표면으로 커버리지가 확장되었습니다.
  • 커뮤니티 보고 수정 사항. MicrosoftGame.config 초기화 및 GDK 빌드/내보내기 실패를 포함하여 커뮤니티에서 제기한 여러 이슈가 해결되었습니다.

주요 변경 사항

새 기능

  • Godot .NET(C#) 트랙: 관리형 파사드 애드온, 튜토리얼 샘플, 패리티 게이트.
  • 토큰 기반 PlayFab 로그인 방식(Steam, OpenID Connect, Battle.net).
  • 빌드 타임 셀렉터와 에디션 이식 가능한 활성화를 통한 2025년 10월 GDK 에디션 지원.
  • GDK add_user_with_ui_async 흐름에서 게스트 로그인이 이제 옵트인 방식으로 변경되었습니다.

개선 사항

  • Party 채팅 강화와 함께 샘플을 모듈화된 GDK / PlayFab / Integrated 트랙으로 재구성.
  • GDK API 참조 커버리지를 100%로 확장.
  • godot_gdk_packaging 애드온의 이름을 godot_gdk_editortools로 변경.
  • 버그 신고 이슈 템플릿을 추가하고 README에서 링크했으며, 추가 문서 링크도 함께 제공.

수정 사항

  • GDK 내보내기 “unexpected error code 47” 실패를 수정.
  • MicrosoftGame.config 선택기 검사를 편집기에서만 사용하도록 제한.
  • GDK/PlayFab async 프레임 콜백 auto-pump을 컴파일하여 포함.
  • Godot 4.5.x에서 GDK 내보내기 플랫폼 감지를 수정.
  • 누락된 GDExtension DLL에 대한 GDK 내보내기 견고성 강화.
  • setup_sample.ps1에서 발생하는 샌드박스 명령의 오타를 수정.
  • getting-started.md에서 xbox-sandbox-and-test-accounts.md에 대한 링크 대소문자 구분 문제 수정.

엔지니어링 및 CI

  • PlayFab Party 및 GDK 요청 파싱 seam이 포함된 libFuzzer 인프라 추가.
  • PR 게이트(파싱 매트릭스, 퍼즈 재생) 추가와 함께, 공급망 강화가 적용된 야간 PlayFab 라이브 테스트 추가.
  • GDK 에디션별로 애드온을 한 번씩 빌드하며, Godot 버전 전반에 걸쳐 캐싱 및 테스트를 수행.

관련 항목

마지막 수정일 2026년 8월 6일