샌드박스 설정
개요
이 항목에서는 샌드박스를 설정하고 Xbox 서비스 사용을 위해 애플리케이션을 구성하는 데 필요한 ID를 얻는 방법을 설명합니다.
샌드박스는 개별 개발 키트에 대한 콘텐츠 격리 기능을 통해 개발과 테스트를 위한 깔끔한 환경을 제공합니다.
Xbox 서비스는 이벤트, 도전 과제, 멀티 플레이어 기능과 같은 온라인 기능을 제공합니다.
샌드박스를 사용하도록 설정하고 및 Xbox 서비스를 사용하려면 개발 키트 및 타이틀을 구성할 수 있도록 몇 개의 ID를 획득해야 합니다.
이러한 작업은 동일한 프로세스를 통해 할 수 있습니다.
프로세스는 다음과 같습니다.
- ID를 가져옵니다.
- 개발 키트에서 샌드박스를 설정합니다.
- 다른 선택적 ID와 함께 TitleID를 타이틀에 바인딩합니다.
중요 ID
Xbox One(또는 이상)의 타이틀과 응용 프로그램을 개발하는 데 중요한 세 개의 ID는 샌드박스 ID, 타이틀 ID 및 SCID(서비스 구성 식별자)입니다.
개발 키트를 사용하려면 샌드박스 ID가 있어야 하지만 TitleID 및 SCID는 초기 개발에는 필요하지 않지만 Xbox 서비스 사용에는 필요합니다. 따라서 세 ID를 한 번에 가져오는 것이 좋습니다.
샌드박스 ID
샌드박스는 개발 과정에서 개발 키트용 콘텐츠 격리를 제공하므로 깔끔한 환경에서 타이틀을 개발하고 테스트할 수 있습니다. 샌드박스 ID는 샌드박스를 식별하는 역할을 합니다. 본체는 한 번에 샌드박스 하나에만 액세스할 수 있지만, 같은 샌드박스로 여러 본체에 액세스할 수 있습니다.
샌드박스 ID는 대/소문자를 구분합니다.
TitleID
TitleID는 Xbox 서비스에 대한 타이틀을 고유하게 식별합니다. TitleID는 서비스 전체에서 사용되어 사용자가 타이틀의 Xbox 콘텐츠, 사용자 통계, 도전 과제와 같은 항목에 액세스하고 Xbox 멀티 플레이 기능을 활성화할 수 있습니다.
TitleID는 사용 장소 및 방식에 따라 대/소문자를 구분하기도 합니다.
SCID(서비스 구성 식별자)
개발 과정의 일환으로 이벤트, 도전 과제 및 기타 온라인 기능의 호스트를 만들게 됩니다. 이 작업은 모두 서비스 구성에 속하며, 액세스하려면 SCID가 있어야 합니다.
Xbox OS의 이전 버전과 달리 Microsoft GDK 게임 OS용으로 개발된 타이틀은 하나의 SCID만 있으므로 특정 샌드박스 내의 모든 타이틀 인스턴스는 동일한 구성을 공유합니다.
Microsoft GDK r게임 OS SCID는 항상 TitleID와 동일한 값을 가진 GUID이며 앞에 0이 붙습니다. Microsoft GDK(게임 개발 키트) 타이틀의 Xbox 서비스와의 대부분의 상호 작용에 대해 SCID를 더 이상 명시적으로 지정할 필요가 없지만 Xbox 서비스 REST 끝점과 직접 상호 작용하는 경우 SCID가 필요할 수 있습니다.
SCID는 대/소문자를 구분합니다.
ID 받기
당분간 개발자 계정 관리자에게 ID를 얻을 수 있습니다.
샌드박스 설정
샌드박스 ID를 설정하지 않으면 개발 키트를 시작할 수 없습니다. 이를 위해 GDK 명령 창을 열고 다음과 같이 구성(xbconfig.exe)(NDA 항목)권한 부여 필요 명령을 사용합니다.
- 현재 샌드박스를 확인합니다. 명령 프롬프트에서 xbconfig sandboxid를 입력합니다.
- 기대한 대로 되지 않으면 샌드박스 ID를 변경합니다. 명령 프롬프트에서 xbconfig sandboxid=<your sandbox id>를 입력합니다.
- 명령 프롬프트에서 재부팅(xbreboot.exe)(NDA 항목)권한 부여 필요을 사용하여 콘솔을 다시 시작합니다.
- 샌드박스가 올바르게 다시 설정되었는지 확인합니다. 명령 프롬프트에서 xbconfig sandboxid를 입력합니다.
이진에 TitleID와 기타 선택적 ID를 추가합니다.
각 개발 키트의 플랫폼 수준에서 샌드박스가 구성되지만, 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 GDK(게임 개발 키트)를 기준으로 MSAAppId 및 TitleId는 둘 중 하나가 MicrosoftGame.config 지정된 경우 필요합니다. 자세한 내용은 MicrosoftGame.config 요소 - MSAAppId 및 MicrosoftGame.config 요소 - TitleId를 참조하세요.
RequiresXboxLive 플래그
RequiresXboxLive 플래그가 true로 설정된 경우 Xbox 네트워크(Xbox Live라고도 함)에 대한 활성 연결이 없으면 타이틀이 실행되지 않으며 타이틀이 Xbox 서비스 인증을 지웁니다. 이렇게 하면 타이틀이 최신 콘텐츠 업데이트를 가져왔는지 확인할 수 있습니다. 제목이 실행되는 동안 연결이 끊어지는 경우 제목이 일시 중단되고 종료됩니다.
"인터넷 필수" 타이틀만 RequiresXboxLive를 true로 표시해야 합니다. 이런 방법으로 타이틀을 표시한다고 해서 반드시 타이틀에 필요한 서비스가 이상 없이 실행되는 것은 아닙니다.
RequiresXboxLive도 유사하게 MicrosoftGame.config .config 파일의 Game 내에 있는 노드입니다.