다음을 통해 공유

로그인 및 샌드박스 오류 문제 해결

  • 아티클

이 항목은 PC의 개발 샌드박스에서 게임에 대한 일반적인 로그인 및 샌드박스 관련 오류를 해결하는 데 도움이 됩니다.

ID가 올바른지 확인

MicrosoftGame.config에서 다음 ID가 올바른지 확인해야 합니다.

  • StoreId
  • ID/이름
  • ID/게시자
  • TitleId
  • SCID
  • MSAAppId

StoreId, ID/이름, ID/게시자에 대한 값을 찾으려면 다음을 수행합니다.

  1. 파트너 센터로 이동합니다.
  2. 게임을 선택합니다.
  3. 왼쪽 탐색 창에서 게임 설정 섹션을 선택합니다.
  4. ID 세부 정보 섹션으로 이동하고 세부 정보 표시 링크를 클릭하여 섹션을 확장합니다.
  5. 다음의 값을 검토합니다.
    1. Package/Identity/Name - MicrosoftGame.config의 ID/이름 값에 해당합니다.
    2. Package/Identity/Publisher - MicrosoftGame.config의 ID/게시자 값에 해당합니다.
    3. Store ID - MicrosoftGame.config의 StoreId 값에 해당합니다.

TitleId, SCID 및 MSAAppId에 대한 값을 찾으려면 다음을 수행합니다.

  1. 파트너 센터로 이동합니다.
  2. 게임을 선택합니다.
  3. 왼쪽 탐색 창에서 Xbox 서비스>Xbox 설정 섹션을 선택합니다.
  4. 다음의 값을 검토합니다.
    1. 타이틀 ID(16진수) - MicrosoftGame.config의 TitleId 값에 해당합니다. 참고: 10진수 값이 아닌 16진수 값입니다.
    2. MSA App ID - MicrosoftGame.config의 MSAAppId 값에 해당합니다. MSAAppId는 GUID 또는 16진수 값일 수 있습니다.
    3. SCID - 이 값은 MicrosoftGame.config 파일에 지정되지 않습니다. 대신 XblInitialize 메서드에 매개 변수로 전달됩니다.

샌드박스 전환

샌드박스를 전환하려면 다음 지침을 따르세요.

  1. GDK 명령 프롬프트를 엽니다(시작 메뉴에서 "GDK"를 입력하면 Microsoft GDK 명령 프롬프트 폴더를 찾을 수 있음).
  2. "XblPCSandbox.exe [sandbox ID]"을(를) 입력합니다. 여기서 [샌드박스 ID]는 샌드박스의 이름입니다(대/소문자 구분).

문제 해결 프로세스

로그인이 작동하지 않을 수 있는 여러 가지 이유가 있습니다. 따라서 추가 조사를 진행하기 전에 근본 원인을 좁히는 것이 중요합니다.

다음 프로세스에 따라 표시되는 오류의 원인을 좁힙니다.

  1. Xbox 앱에 로그인하여 샌드박스 전환 작업이 성공했는지 확인합니다. 로그인할 수 있는 경우 샌드박스를 전환했습니다. 그렇지 않은 경우 올바른 샌드박스에 있지 않을 수 있습니다.
    1. 아직 없는 경우 Xbox 앱을 다운로드하세요.
    2. 아직 샌드박스에 액세스할 수 없는 경우 테스트 계정을 생성하세요.
    3. 샌드박스 전환 섹션의 지침에 따라 샌드박스를 전환합니다.
    4. Xbox 앱을 시작합니다. 시작 메뉴에서 "Xbox"를 입력할 수 있으며 아이콘이 나타납니다.
    5. 테스트 계정으로 Xbox에 앱 로그인해 보세요.
    6. 로그인할 수 없는 경우 샌드박스가 제대로 전환되지 않았거나 테스트 계정에 샌드박스에 대한 액세스 권한이 없습니다. 문제를 해결하려면 아래의 일반 오류 섹션을 확인하여 발생한 오류에 대한 정보를 찾습니다.
    7. 로그인할 수 있는 경우 샌드박스를 전환할 수 있고 테스트 계정에 샌드박스에 대한 액세스 권한이 있음을 의미합니다. 다음 단계로 진행할 수 있습니다.
  2. 다음으로 샘플 프로젝트 중 하나에 로그인해 봅니다.
    1. Unity를 사용하는 경우 Unity 플러그 인에서 로그인 장면을 사용할 수 있습니다. 다른 엔진을 사용하는 경우 보안 다운로드 사이트(aka.ms/gdkdl)에서 사용할 수 있는 소셜 샘플을 사용할 수 있습니다.
    2. 샘플의 MicrosoftGame.config에 있는 ID를 게임의 ID로 바꿉니다. ID를 가져오는 방법에 대한 자세한 내용은 ID가 올바른지 확인 섹션을 참조하세요.
    3. 샌드박스를 전환하지 않은 경우 샌드박스 전환 섹션의 지침에 따라 샌드박스를 전환합니다.
    4. 샘플을 빌드하고 실행합니다.
    5. 샘플에 로그인해 봅니다.
    6. 샘플을 사용하여 로그인할 수 없는 경우 파트너 센터 또는 MicrosoftGame.config에서 게임의 Xbox 서비스 구성에 문제가 있을 수 있습니다. 추가 문제 해결은 아래의 일반 오류 섹션을 참조하세요.
    7. 샘플에 로그인할 수 있지만 게임에 로그인할 수 없는 경우 게임과 문제의 원인이 되는 샘플 간에 차이가 있을 수 있습니다. 먼저 MicrosoftGame.config 파일의 차이점을 찾아 볼 수 있습니다. 샘플 로그인 코드와 게임 코드 간의 논리 차이점을 찾을 수도 있습니다.

일반적인 오류

사용자가 이 샌드박스에 없습니다(0x8015DC12).

이 오류는 테스트 계정에 샌드박스에 대한 액세스 권한이 없거나 게임에 샌드박스에 대한 액세스 권한이 없음을 의미합니다. 다음은 이 오류의 일반적인 원인 목록입니다.

  • 이 오류의 가장 일반적인 원인은 ID가 일치하지 않는 것입니다. 해당 오류 문제를 해결하려면 아래의 잘못된 ID 섹션을 참조하세요.
  • 가능성이 낮지만 테스트 계정에 샌드박스에 대한 액세스 권한이 없을 수도 있습니다. 테스트 계정을 만들 때 새 테스트 계정 양식의 맨 아래에 있는 샌드박스에 계정 액세스를 할당할 수 있습니다.
  • 또 다른 가능성은 격리된 샌드박스를 사용하는 것입니다. 자세한 내용은 공유 샌드박스 대신 격리된 샌드박스의 섹션을 참조하세요.

잘못된 ID

로그인 오류의 일반적인 원인은 MicrosoftGame.config의 일부 값이 잘못되었다는 것입니다. MicrosoftGame.config 편집기에서 Microsoft Store 연결 마법사를 사용하여 게임을 연결하여 잘못된 입력으로 인한 오류를 최소화하는 것이 좋습니다. ID가 올바른지 확인 섹션의 지침에 따라 수동으로 매니페스트의 ID를 사용하여 파트너 센터 ID를 다시 확인할 수도 있습니다.

PC에서 로그인할 수 없지만 Xbox 설정 페이지에 PC 플랫폼을 추가하지 않았습니다(0x87dd0005, AM_E_XAST_UNEXPECTED).

0x87dd0005(AM_E_XAST_UNEXPECTED) 오류 메시지가 표시되면 PC 플랫폼이 Xbox 설정 페이지에 추가되지 않았음을 의미하는 경우가 많습니다. 이 문제를 해결하려면 다음과 같이 하세요.

  1. 파트너 센터로 이동합니다.
  2. 게임으로 이동합니다.
  3. 왼쪽 창에서 Xbox 서비스를 확장하고 Xbox 설정을 선택합니다.
  4. Windows 10 PC 확인란이 선택되어 있는지 확인합니다.
  5. 저장을 클릭합니다.
  6. 게임 플레이 설정 페이지에서 Xbox 서비스 설정을 개발 샌드박스에 게시합니다.
  7. 30분 정도 기다렸다가 다시 로그인해 보세요.

중요:Xbox 설정 페이지에서 저장을 선택한 후 개발자 샌드박스에 Xbox 서비스 설정을 게시했는지 확인합니다. 저장을 선택하여도 변경 내용이 게시되지는 않습니다. 게임에 대해 알고 작업에 로그인하려면 이러한 설정을 Xbox 서비스에 게시해야 합니다.

철자가 틀린 샌드박스 ID

샌드박스 값은 대/소문자를 구분합니다. 예를 들어 “RETAIL”은 “Retail” 또는 ”retail”과 동일하지 않습니다. 드물긴 하지만 이 문제가 발생할 수 있습니다. 또 다른 경우는 문자를 누락하여 샌드박스를 잘못 가져오는 것입니다. 마지막 사례는 샌드박스가 여러 개 있고 게임이 게시된 것과 다른 샌드박스로 전환한 경우입니다.

잘못된 SCID

Xbox 서비스를 호출할 때 올바른 SCID(서비스 구성 ID)를 보내는 것이 중요합니다. SCID는 XblInitialize 메서드에 전달됩니다. 올바른 값인지 확인합니다.

공유 샌드박스 대신 격리된 샌드박스

격리된 샌드박스를 사용할 이유가 없다면 공유 샌드박스를 사용하는 것이 좋습니다. 파트너 센터에서 개발자 샌드박스가 어떤 유형의 샌드박스인지 확인할 수 있습니다.

샌드박스를 전환할 때 Microsoft Store에서 내 게임 또는 추가 기능을 찾을 수 없습니다.

샌드박스를 전환할 때 Microsoft Store에서 게임 또는 추가 기능을 찾을 수 없다면 다음을 수행합니다.

파트너 센터의 가용성 설정을 확인합니다.

  1. 파트너 센터의 샌드박스에 게임 또는 추가 기능을 게시했습니다.
  2. Microsoft Store에서 이 제품을 사용할 수 있고 검색할 수 있도록 가용성이 설정되어 있는지 확인합니다. 참고: 다른 검색 기능 설정도 사용할 수 있습니다. 해당 설정을 의도적으로 설정했는지 확인합니다.
  3. 가용성 날짜가 설정되어 있는지 확인합니다. 이 날짜는 미래의 날짜가 아닙니다. 이렇게 하면 Microsoft Store에서 게임 또는 추가 기능을 볼 수 없습니다.

Xbox 앱을 사용합니다.

  1. XblPCSandbox.exe 도구를 사용하여 샌드박스를 전환합니다.
  2. Xbox 앱을 다시 시작합니다.
  3. 테스트 계정을 사용하여 Xbox 앱에 로그인합니다.
  4. 명령 프롬프트를 엽니다.
  5. 다음 명령을 실행합니다: msxbox://game/?productId=<store ID>

Microsoft Store에서 검색을 사용하여 게임 또는 추가 기능을 찾으려는 경우 게임의 정확한 이름을 입력해야 합니다. 그렇지 않으면 찾을 수 없습니다. 예를 들어 게임이 "TestGame1"이라고 하고 검색 상자에 "TestGame"을 입력하면 Microsoft Store에서 게임을 찾을 수 없습니다. 참고: 이는 "TestGa"를 입력할 수 있는 소매점과 다르며 여기서는 부분 문자열 일치를 통해 게임을 찾습니다.

PC를 다시 시작해 보세요.

경우에 따라 PC가 로그인에 필요한 서비스 중 하나가 잘못된 상태에 있게 되는 경우가 있습니다. 경우에 따라 다시 시작하면 문제가 해결될 수 있습니다.

게임 서비스가 최신 상태인지 확인

당사는 게임 서비스를 정기적으로 수정하므로 게임 서비스가 항상 최신 상태인지 확인하는 것이 좋습니다. 참고: 이러한 서비스도 자동으로 업데이트하지만 이전 버전을 가지고 있을 수 있는 경우도 있습니다. 설정의 프로그램 추가 또는 제거에서 게임 서비스가 마지막으로 업데이트된 시점과 버전 정보를 확인할 수 있습니다. 업데이트를 강제 적용하려면 다음을 수행합니다.

  1. PowerShell을 관리자로 실행하고 "get-appxpackage Microsoft.GamingServices | remove-AppxPackage -allusers"을(를) 입력합니다.
  2. 동일한 PowerShell 창에서 "start ms-windows-store://pdp/?productid=9MWPM2CQNLHN"를 입력합니다.
  3. 표시되가 되면 UAC 프롬프트 수락을 포함하여 해당 페이지에 앱을 설치합니다.
  4. 게임을 다시 설치해 보세요.

Xbox 앱이 최신 상태인지 확인

PC가 개발 샌드박스에 오래 남아 있는 경우 Xbox 앱이 최신 상태가 아닐 수 있습니다. 당사는 Xbox 앱을 지속적으로 업데이트하고 있습니다. 업데이트하려면 RETAIL로 전환합니다. 자동으로 업데이트됩니다. 설정의 프로그램 추가 또는 제거에서 게임 서비스가 마지막으로 업데이트된 시점과 버전 정보를 확인할 수 있습니다. 최신 상태가 아닌 경우 다음을 수행할 수 있습니다.

  1. 현재 RETAIL 샌드박스에 있는지 확인합니다. 그렇지 않으면 Microsoft Store에서 Xbox 앱을 찾을 수 없습니다.
  2. PowerShell을 관리자로 실행하고 "get-appxpackage Microsoft.XboxApp | remove-AppxPackage -allusers"을(를) 입력합니다.
  3. 동일한 PowerShell 창에서 "start ms-windows-store://pdp/?productid=9mv0b5hzvk9z"를 입력합니다.
  4. 표시되가 되면 UAC 프롬프트 수락을 포함하여 해당 페이지에 앱을 설치합니다.

Xbox 앱을 찾을 수 없음

Xbox 앱은 Microsoft Store에서 제공되지만 사용자는 RETAIL 샌드박스에 있어야 합니다. 그렇지 않으면 표시되지 않습니다. 현재 RETAIL 샌드박스에 있는지 확인하고 Microsoft Store에서 "Xbox 앱"을 검색합니다.

0x89245106(E_GAMEUSER_NO_DEFAULT_USER)

즉, 현재 기본 사용자가 없습니다. 이 오류가 발생하는 경우 이는 개발자가 XUserAddAsync(AddDefaultUsersSilently, ...)를 호출했음을 의미할 수 있습니다. 이 문제를 해결하려면 사용자를 가져오기 위해 XUserAddAsync를 다시 호출하되 AddDefaultUserSilently를 포함하지 않아야 합니다. 또한 XUserAddOptions options = XUserAddOptions::AddDefaultUserAllowingUI 옵션을 사용하여 필요한 경우 UI를 표시하고 그렇지 않은 경우 자동으로 로그인하는 경우를 처리할 수 있습니다.

장치 포털: 샌드박스 전환이 작동하지 않음

Windows 장치 포털을 사용하여 샌드박스를 전환하는 동안 오류가 발생하면 대신 xblpcsandbox.exe를 사용합니다. 샌드박스를 전환하는 데는 Windows 장치 포털이 권장되지 않습니다. 샌드박스 전환 섹션에서 지침을 찾을 수 있습니다.

Xbox 서비스가 다운됨

여전히 해결을 찾을 수 없고 이 문서에서 다룬 오류가 나타나지 않으면 Xbox 서비스에 중단이 발생하는지 확인할 수 있습니다. 이는 Xbox 상태 페이지에서 확인할 수 있습니다.

Xbox 서비스를 사용할 수 없습니다.

로그인할 수 없는 경우 게임에 Xbox 서비스가 활성화되어 있는지 확인하세요. 다음을 통해 게임에 Xbox 서비스가 활성화되어 있는지 확인할 수 있습니다.

  1. 파트너 센터로 이동하여 게임을 클릭합니다.
  2. 측면 탐색에서 Xbox 서비스>Xbox 설정을 찾습니다.
  3. 왼쪽 탐색에 Xbox 서비스가 표시되지 않으면 게임에 Xbox 서비스가 활성화되어 있지 않은 것입니다.
  4. 게임에 개념 승인이 필요한 경우 Microsoft 담당자에게 문의하여 게임에 Xbox 서비스를 사용하도록 설정하세요.

라이선스 오류로 인해 Xbox 앱이 시작되지 않음

이전에 RETAIL 샌드박스에서 Xbox 앱을 시작하지 않고 샌드박스에 로그인하면 라이선스 오류(0x803F8001)가 발생할 수 있습니다. 다음 단계에 따라 문제를 resolve.

  1. 샌드박스를 RETAIL로 변경합니다.
  2. Xbox 앱을 엽니다.
  3. 앱이 시작되면 원래 샌드박스로 되돌리기. 이렇게 하면 라이선스 오류를 수정하고 정상적인 작업을 허용해야 합니다.

참고 항목

샌드박스 개요고급 샌드박스 개념 개요테스트 계정Xbox 서비스 구성 개요
MicrosoftGame.config 개요