샌드박스 설정

개요

이 항목에서는 샌드박스를 설정하고 XBOX services를 사용하도록 애플리케이션을 구성하는 데 필요한 ID를 얻는 방법에 대해 설명합니다. 샌드박스는 개별 개발 키트에 대한 콘텐츠 격리를 제공하여 개발 및 테스트를 위한 깨끗한 환경을 제공합니다. XBOX services는 이벤트, 도전 과제 및 멀티플레이어 기능과 같은 온라인 기능을 제공합니다. 샌드박스를 활성화하고 XBOX services를 사용하려면 dev kit과 타이틀을 구성하기 위해 여러 ID를 얻어야 합니다. 이는 동일한 프로세스로 수행할 수 있습니다. 프로세스는 다음과 같습니다.

ID를 얻습니다.
dev kit에서 샌드박스를 설정합니다.
TitleID를 다른 선택적 식별자와 함께 타이틀에 바인딩합니다.

중요한 ID

XBOX One(또는 이후)용 타이틀 및 애플리케이션 개발에 중요한 세 가지 ID가 있습니다: 샌드박스 ID, TitleID 및 서비스 구성 식별자(SCID)입니다. dev kit을 사용하려면 샌드박스 ID가 필요하지만 TitleID와 SCID는 초기 개발에는 필요하지 않지만 XBOX services를 사용하려면 필요합니다. 따라서 세 가지 모두 동시에 얻는 것을 권장합니다.

Sandbox ID

샌드박스는 개발 중에 dev kit에 대한 콘텐츠 격리를 제공하여 타이틀 개발 및 테스트를 위한 깨끗한 환경을 보장합니다. 샌드박스 ID는 샌드박스를 식별합니다. 콘솔은 한 번에 하나의 샌드박스에만 액세스할 수 있지만, 하나의 샌드박스는 여러 콘솔에서 액세스할 수 있습니다. Sandbox ID는 대소문자를 구분합니다.

TitleID

TitleID는 XBOX services에 타이틀을 고유하게 식별합니다. TitleID는 서비스 전반에 걸쳐 사용되어 사용자가 타이틀의 XBOX 콘텐츠, 사용자 통계, 도전 과제와 같은 항목에 액세스할 수 있게 하고 XBOX 멀티플레이어 기능을 활성화합니다. Title ID는 사용 방식과 위치에 따라 대소문자를 구분할 수 있습니다.

서비스 구성 식별자(SCID)

개발의 일환으로 이벤트, 도전 과제 및 기타 여러 온라인 기능을 만들 것입니다. 이는 모두 서비스 구성의 일부이며 액세스를 위해 SCID가 필요합니다. 이전 버전의 XBOX OS와 달리 Microsoft GDK Game OS용으로 개발된 타이틀에는 SCID가 하나만 있으므로 특정 샌드박스 내의 모든 타이틀 인스턴스가 동일한 구성을 공유합니다. Microsoft GDK Game OS SCID는 항상 TitleID와 동일한 값에 0이 앞에 추가된 GUID입니다. Microsoft Game Development Kit(GDK) 타이틀에서 XBOX services와의 상호 작용 대다수의 경우 SCID를 명시적으로 지정할 필요가 없지만, XBOX services REST 엔드포인트와 직접 상호 작용하는 경우 필요할 수 있습니다. SCID는 대소문자를 구분합니다.

ID 얻기

현재로서는 개발자 계정 관리자와 협력하여 ID를 얻습니다.

샌드박스 ID를 설정하지 않고는 dev kit을 시작할 수 없습니다. 이렇게 하려면 GDK 명령 창을 열고 다음과 같이 Configuration (xbconfig.exe) (NDA topic) 명령을 사용합니다.

현재 샌드박스를 확인합니다. 명령 프롬프트에 xbconfig sandboxid를 입력합니다.
예상한 것과 다르면 샌드박스 ID를 변경합니다. 명령 프롬프트에 **xbconfig sandboxid=<your sandbox id>**를 입력합니다.
명령 프롬프트에서 Reboot (xbreboot.exe) (NDA topic)을 사용하여 콘솔을 다시 시작합니다.
샌드박스가 올바르게 재설정되었는지 확인합니다. 명령 프롬프트에 xbconfig sandboxid를 입력합니다.

바이너리에 TitleID 및 기타 선택적 식별자 추가

샌드박스는 각 dev kit에 대해 플랫폼 수준에서 구성되지만 TitleID는 특정 바이너리에 바인딩됩니다. 바이너리에 TitleID를 추가하려면 다음과 같이 <Game> 노드에 새 노드를 추가하여 해당 바이너리의 MicrosoftGame.config 파일을 수정합니다.

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    ...
    <TitleId>yourTitleId</TitleId>
    <StoreId>yourStoreId</StoreId>
    <MSAAppId>yourMSAAppId</MSAAppId>
    ...
</Game>  

2022년 3월 Microsoft Game Development Kit(GDK)부터 MSAAppId와 TitleId 중 하나가 MicrosoftGame.config에 지정된 경우 둘 다 필요합니다. 자세한 내용은 MicrosoftGame.config Element - MSAAppId 및 MicrosoftGame.config Element - TitleId를 참조하세요.

RequiresXboxLive 플래그

RequiresXboxLive 플래그가 true로 설정된 경우 XBOX 네트워크에 대한 활성 연결이 있고 타이틀이 XBOX services 인증을 통과해야 타이틀이 실행됩니다. 이는 타이틀이 최신 콘텐츠 업데이트를 받았음을 보장합니다. 타이틀이 실행되는 동안 연결이 끊어지면 타이틀이 일시 중단되고 이후 종료됩니다. “인터넷 필수” 타이틀만 RequiresXboxLive를 true로 표시해야 합니다. 이러한 방식으로 타이틀을 표시한다고 해서 타이틀에 필요한 서비스가 가동 중임을 보장하지는 않습니다. RequiresXboxLive도 MicrosoftGame.config 파일 내 Game의 노드입니다.

XBOX Services