> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUser의 헤드리스 자동화

> XUser의 헤드리스 자동화

테스트를 위해 게임은 게임에 사용자 추가를 자동화하려고 할 수 있습니다. Microsoft Game Development Kit(GDK)에서는
게임이 [XUserAddAsync](/reference/system/xuser/functions/xuseraddasync)를 호출할 때만 사용자가 추가됩니다.
자동화와 관련하여 이 함수에는 다음 두 가지 주요 제한 사항이 있습니다.

* `AddDefaultUserSilently` 플래그와 함께 `XUserAddAsync`를 호출하면 UI가 표시되지 않습니다(자동화에
  도움이 됩니다). 그러나 게임을 실행한 사용자만 얻을 수 있습니다.
  이 플래그로 API를 반복적으로 호출해도 결과가 변경되지 않습니다. 동일한 사용자에 대한
  새 핸들만 계속 얻게 됩니다.
* `AddDefaultUserSilently` 플래그 없이 `XUserAddAsync`를 호출하면 UI가
  나타나고 누군가 버튼을 누를 때까지 기다립니다. 이는 자동화를 중단시킵니다.

테스트 코드에서 사용자 추가 자동화를 돕기 위해, Microsoft Game Development Kit(GDK)는 사용자 입력을 요구하는 UI를
표시하지 않고 사용자를 추가할 수 있는 헤드리스 옵션을 켜는 지원을 제공합니다. 다음
단계는 기본 접근 방식을 설명합니다.

1. 콘솔에 로그인된 사용자를 추가하려면 `signin` 옵션과 함께
   [xbuser(NDA 항목)](/tools/tools-console/commandlinetools/xbuser)
   명령줄 도구를 사용할 수 있습니다. 각 사용자에 대해 이 단계를 반복합니다.
2. 게임에 사용자를 추가할 때 일반적으로 표시되는 UI를 억제하려면
   다음과 같이 `HeadlessXuser` 옵션과 함께 [xbconfig(NDA 항목)](/tools/tools-console/commandlinetools/xbconfig) 명령줄 도구를 사용할 수 있습니다.

```
    xbconfig HeadlessXUser=true
```

3. 게임을 실행합니다.
4. 게임에 들어가면 `AddDefaultUserSilently` 플래그가 없는
   `XUserAddAsync`에 대한 각 호출은 콘솔에 로그인되어 있고
   게임에서 아직 연결된 `XUserHandle` 개체가 없는 첫 번째 사용자를 반환합니다.
5. 게임이 `XUserAddAsync`를 계속 호출하면 결국 콘솔에 로그인된 사용자 수를
   모두 소모합니다. 이 일이 발생한 후, `XUserAddAsync`는
   `E_ABORT`를 반환합니다. 이는 사용자가 콘솔 로그인을 취소했거나(또는 다른 방법으로
   UI에서 나갔을 경우)에 `XUserAddAsync`가 반환했을 것과 정확히 동일한 오류입니다.
6. 테스트 목적으로 게임은 콘솔에 로그인된 [테스트 계정](/services/xbox-services/develop/test-accounts/live-setup-testaccounts)의
   수를 알고자 할 수 있습니다. 이를 용이하게 하기 위해 게임은 `CreateProcess`를 호출하고
   `list` 옵션과 함께 `wduser` 명령줄 도구를 실행할 수 있습니다.


## Related topics

- [GDK의 사용자 ID 및 XUser API](/ko/build/core-features/common/user/index.md)
- [사용자](/ko/build/core-features/common/user/user-toc.md)
- [PlayFab 릴리스 노트 2015](/ko/services/playfab/release-notes/2015.md)
- [XBOX Manager: 콘솔 자동화 관리](/ko/tools/tools-console/xbom/manager-tool-automation.md)
- [PlayFab 릴리스 노트 2020](/ko/services/playfab/release-notes/2020.md)