Skip to main content
Steamworks를 게임의 프로젝트에 추가한 후 사용을 시작하려면 API를 초기화하기 위해 SteamAPI_Init 함수를 호출해야 합니다. 선택적으로 SteamAPI_RestartAppIfNecessary를 호출해 필요한 경우 앱을 Steam을 통해 다시 실행할 수 있습니다. XBOX Game Development Kit(GDK)의 초기화는 조금 더 관여도가 높습니다. Steam처럼 게임을 실행하고 다양한 게이밍 서비스와 통신하는 통합 앱이 없기 때문입니다. XBOX Game Development Kit(GDK)의 API 사용을 시작하려면 다음 단계를 사용해야 합니다.
  1. 프로젝트에 MicrosoftGame.config 파일을 추가합니다.
  2. Gaming Runtime 서비스를 초기화합니다.
  3. 사용자 신원, 클라우드 저장, 업적 등을 위해 XBOX Live로 호출하기 위해 XBOX Services API를 초기화합니다.
  4. 사용자를 XBOX Live에 로그인시킵니다. 로그인 성공 후 반환된 핸들과 XBOX User ID(XUID)를 향후 사용을 위해 저장합니다.
Steam에서는 Steam 런처가 게임이 실행될 때 사용자의 계정 정보를 자동으로 주입하므로 로드 시점에 사용자의 Steam ID와 모든 API에 접근할 수 있습니다. XBOX Live API는 여러 런처에서 사용하는 게임에서 사용되므로, 이러한 것을 무료로 얻을 수 없습니다. 실행 시 사용자를 수동으로 로그인시켜야 합니다.
1단계를 수행하는 방법에 대한 정보는 MicrosoftGame.config 개요를 참조하세요. 2~4단계를 수행하는 방법은 XBOX Live API 시작하기에서 확인할 수 있으며(또는 다음과 같이 요약됨), 그 항목의 XSAPI 정리 섹션에서 설명하는 동작도 반드시 구현하세요. Gaming Runtime과 XBOX Services API가 초기화된 후 사용자를 XBOX Live에 로그인시킬 수 있습니다. 비워두면 자동으로 생성되므로 XTaskQueue를 생성할 필요는 없습니다.

사용자를 XBOX Live에 로그인시키기

XUserAddAsync API를 사용해 사용자를 XBOX Live에 로그인시킵니다. 게임에 처음 로그인하는 경우 게임이 요청하는 권한 목록이 표시됩니다. XBOX Live 계정에 접근하려면 이 권한을 명시적으로 승인해야 합니다. 로그인에 성공한 후에는 XUserAddResult 함수에 전달한 XUserHandle 참조를 사용할 수 있습니다. 이는 게이머태그, 게이머 사진, 로그인 상태, 연령 그룹, 권한과 같은 해당 XBOX Live 사용자에 대한 정보를 얻는 데 사용할 수 있습니다. 사용자가 처음 로그인한 후에는 마지막으로 게임을 실행한 이후로 해결해야 할 UI 프롬프트(예: 새 개인정보 처리방침)가 없다면 사용자의 어떠한 조치 없이(즉, 조용히) 성공적으로 로그인할 수 있어야 합니다. 그러나 신원 접근을 얻으려면 여전히 이러한 API 호출을 해야 합니다. XBOX Live API를 호출하려면 XblContextHandle이 필요합니다. XblContextCreateHandle 함수를 사용해 XUserHandleXblContextHandle을 얻을 수 있습니다.
마지막 수정일 2026년 8월 13일