Skip to main content
테스트를 위해 게임은 게임에 사용자 추가를 자동화하려고 할 수 있습니다. Microsoft Game Development Kit(GDK)에서는 게임이 XUserAddAsync를 호출할 때만 사용자가 추가됩니다. 자동화와 관련하여 이 함수에는 다음 두 가지 주요 제한 사항이 있습니다.
  • AddDefaultUserSilently 플래그와 함께 XUserAddAsync를 호출하면 UI가 표시되지 않습니다(자동화에 도움이 됩니다). 그러나 게임을 실행한 사용자만 얻을 수 있습니다. 이 플래그로 API를 반복적으로 호출해도 결과가 변경되지 않습니다. 동일한 사용자에 대한 새 핸들만 계속 얻게 됩니다.
  • AddDefaultUserSilently 플래그 없이 XUserAddAsync를 호출하면 UI가 나타나고 누군가 버튼을 누를 때까지 기다립니다. 이는 자동화를 중단시킵니다.
테스트 코드에서 사용자 추가 자동화를 돕기 위해, Microsoft Game Development Kit(GDK)는 사용자 입력을 요구하는 UI를 표시하지 않고 사용자를 추가할 수 있는 헤드리스 옵션을 켜는 지원을 제공합니다. 다음 단계는 기본 접근 방식을 설명합니다.
  1. 콘솔에 로그인된 사용자를 추가하려면 signin 옵션과 함께 xbuser(NDA 항목) 명령줄 도구를 사용할 수 있습니다. 각 사용자에 대해 이 단계를 반복합니다.
  2. 게임에 사용자를 추가할 때 일반적으로 표시되는 UI를 억제하려면 다음과 같이 HeadlessXuser 옵션과 함께 xbconfig(NDA 항목) 명령줄 도구를 사용할 수 있습니다.
  1. 게임을 실행합니다.
  2. 게임에 들어가면 AddDefaultUserSilently 플래그가 없는 XUserAddAsync에 대한 각 호출은 콘솔에 로그인되어 있고 게임에서 아직 연결된 XUserHandle 개체가 없는 첫 번째 사용자를 반환합니다.
  3. 게임이 XUserAddAsync를 계속 호출하면 결국 콘솔에 로그인된 사용자 수를 모두 소모합니다. 이 일이 발생한 후, XUserAddAsyncE_ABORT를 반환합니다. 이는 사용자가 콘솔 로그인을 취소했거나(또는 다른 방법으로 UI에서 나갔을 경우)에 XUserAddAsync가 반환했을 것과 정확히 동일한 오류입니다.
  4. 테스트 목적으로 게임은 콘솔에 로그인된 테스트 계정의 수를 알고자 할 수 있습니다. 이를 용이하게 하기 위해 게임은 CreateProcess를 호출하고 list 옵션과 함께 wduser 명령줄 도구를 실행할 수 있습니다.
마지막 수정일 2026년 8월 13일