XR-112 초기 활성화 및 다시 시작 시 사용자 및 컨트롤러 설정

버전 2.0, 11/1/2025 타이틀은 타이틀에서 기본 사용자 역할을 할 하나 이상의 활성 사용자를 설정해야 하며, 일시 중단, 절전 또는 최대 절전 모드에서 다시 시작할 때 해당 사용자를 처리해야 합니다. GDK에서 타이틀은 Simplified User Model 또는 Advanced User Model을 사용하여 이 작업을 수행합니다. GDK Simplified User Model 타이틀 GDK의 Simplified User Model은 타이틀을 대신하여 기본 사용자 획득을 처리합니다. 타이틀은 여전히 컨트롤러가 사용자에게 할당되었는지 확인하고 해당 컨트롤러를 게임 입력에 사용할 책임이 있습니다. 기본 사용자에게 할당된 컨트롤러가 없는 경우 타이틀은 XUserFindControllerForUserWithUiAsync를 사용하여 컨트롤러를 선택하는 시스템 대화 상자를 표시하고 플레이어의 입력을 받기 시작해야 합니다. GDK Advanced User Model 초기 활성화 시 게임은 타이틀을 실행한 사용자를 사용하거나 명시적으로 사용자를 묻는 방식으로, 게임 디자인 및 기본 설정에 따라 초기 사용자를 결정하도록 선택할 수 있습니다. 타이틀은 해당 사용자의 프로필에서 첫 번째 프로필 관련 작업(예: 진행 상황 또는 설정 저장)이 수행되기 전에 활성 사용자를 표시해야 합니다. Advanced User Model을 사용하는 모든 Microsoft Game Development Kit(GDK) 타이틀은 활성 사용자를 변경할 수 있도록 계정 선택기에 대한 진입점을 제공해야 합니다. 타이틀이 일시 중단, 절전 또는 최대 절전 모드에서 다시 시작되면 타이틀은 사용자/컨트롤러 페어링의 유효성을 검사하고 이전 사용자의 세션을 다시 시작하거나 하나 이상의 새 사용자를 획득하여 적절히 대응해야 합니다.

​

추가 정보

초기 활성화 시 사용자 설정 GDK Simplified User Model 초기 사용자는 XUserAddAsync(silent)를 호출하여 타이틀에 제공되며, 항상 실행한 사용자에 대한 단일 결과를 반환합니다. GDK Advanced User Model, ERA 및 UWP 다중 사용자 애플리케이션 게임이 타이틀을 실행한 사용자를 사용하는 경우:

• GDK의 경우 XUserAddAsync(silent)를 호출하여 활성 사용자를 확인할 수 있습니다. 시스템에서 기본 사용자가 없다고 반환하면 타이틀은 silent 옵션 없이 XUserAddAsync를 사용하여 사용자를 묻는 프롬프트를 표시해야 합니다. 그러면 사용자에게 계정 선택기가 표시됩니다.
• ERA 및 UWP의 경우 앱 활성화 컨텍스트의 권장 사용자(CoreApplicationContext.CurrentUser)에서 활성 사용자를 찾을 수 있습니다. 앱 활성화 컨텍스트에서 권장 사용자를 제공하지 않았고 타이틀이 프로필 관련 작업을 수행하는 경우, 타이틀은 계정 선택기를 실행하고 사용자의 프로필 선택에 따라 활성 사용자를 설정해야 합니다.

사용자를 묻는 경우:

• 타이틀은 참여 프롬프트를 표시하고 계정 선택기를 표시해야 합니다. 사용자는 선택에 따라 결정됩니다.
• GDK의 경우 계정 선택기는 XUserAddAsync를 사용하여 호출됩니다.
• ERA 및 UWP의 경우 계정 선택기는 ShowAccountPickerAsync를 사용하여 호출됩니다.

사용자가 로그인을 취소하도록 선택하면 타이틀은 계속 진행할 경우 진행 상황이 저장되지 않는다는 것을 사용자에게 알려야 합니다. 실행 시 사용자가 선택되거나 식별되면 타이틀은 프로필 관련 작업을 수행하기 전에 게이머태그를 표시합니다. 타이틀이 활성 사용자를 표시하는 방법이나 위치에 대한 요구 사항은 없습니다. 모범 사례로는 앱의 기본 화면이나 게임의 타이틀 메뉴에 사용자의 게이머 사진과 표시 이름을 표시하는 것이 있습니다. 초기 활성화 시 컨트롤러 설정 게임은 로그인한 사용자로 게임을 실행할 때 계정 선택기 또는 플랫폼에서 설정한 컨트롤러 및 사용자 바인딩을 준수해야 합니다. XBOX 플랫폼은 게임 플레이 중이든 아니든 계정 선택기에서 플레이어가 선택될 때마다 컨트롤러를 플레이어에 바인딩합니다. 타이틀이 타이틀을 실행한 사용자를 사용하는 경우 타이틀은 해당 사용자에게 할당된 연결된 게임패드를 사용하여 게임 플레이와 상호 작용을 진행해야 합니다. 일시 중단 또는 제한 모드에서 다시 시작 GDK Simplified User Model XBOX 플랫폼은 처음에 게임을 실행한 사용자가 여전히 로그인되어 있는지 확인합니다. 타이틀은 UDA를 통해 변경 알림을 등록할 수 있으며, 변경 사항이 있으면 새로 바인딩된 컨트롤러를 사용하여 게임 플레이를 진행합니다. 게임 플레이에 참여하는 추가 사용자는 일시 중단 또는 제한된 상태에서 다시 시작할 때 Advanced User Model의 다음 지침에 따라 적절하게 처리해야 합니다. GDK Advanced User Model, ERA 및 UWP 다중 사용자 애플리케이션 타이틀이 일시 중단에서 다시 시작되거나 제한 모드를 종료하면 타이틀은 사용자/컨트롤러 페어링의 유효성을 검사하고 다음과 같이 적절히 대응해야 합니다.

• 사용자/컨트롤러 페어링에 변경 사항이 없으면 타이틀은 계속 진행해야 합니다.
• ERA 또는 UWP에서 타이틀의 이전 활성 사용자가 여전히 로그인되어 있지만 새 User 개체에 있는 경우(일반적으로 타이틀이 일시 중단된 동안 사용자가 로그아웃했다가 다시 로그인하여 발생함), 타이틀은 로그아웃된 User 개체를 대체하여 새로 로그인한 User 개체를 사용해야 합니다. 사용자가 로그아웃한 적이 없는 것처럼 계속 사용되어야 합니다.
• 예상되는 모든 사용자가 유효하지만 다른 컨트롤러와 페어링된 경우 타이틀은 새 시스템 컨트롤러 페어링으로 업데이트하고 이를 사용해야 합니다.
• 예상되는 사용자에게 유효한 컨트롤러가 없으면 타이틀은 계정 선택기를 사용하여 사용자의 활성 컨트롤러를 설정해야 합니다.
• 예상되는 플레이어가 로그인되어 있지 않으면 타이틀은 게임에서 플레이어를 제거하거나 사용자와 활성 컨트롤러를 다시 설정해야 합니다. 타이틀은 일반적으로 계정 선택기를 표시하여 이 작업을 수행합니다. 사용자를 다시 설정하는 과정에서 새 사용자가 선택되고 게임 상태가 사용자별로 저장되는 경우, 타이틀은 게임 플레이에 해당 새 사용자의 상태를 사용해야 합니다.

​

추가 리소스

GDK를 사용한 플레이어 ID에 대한 자세한 내용은 사용자 섹션을 참조하세요.

​

인증 테스트 사례

다음 표는 GDK Simplified User Model 또는 GDK Advanced User Model, ERA 및 UWP 다중 사용자 애플리케이션을 사용하는 경우 타이틀에 적용되는 XR-112 테스트 사례를 보여 줍니다.

​

112-02 초기 사용자 및 컨트롤러

테스트 단계

1. 프로필 A에 로그인하고 타이틀을 실행합니다.
2. 활성 사용자가 타이틀을 제어할 수 있는지 확인합니다.
3. 로그인한 프로필이 없는 상태에서 [1]단계를 반복하고 타이틀이 활성 사용자를 설정하라는 메시지를 표시하는지 확인합니다.
4. 활성 사용자를 설정하고 해당 사용자가 타이틀을 제어할 수 있는지 확인합니다.

예상 결과
타이틀은 타이틀을 실행한 컨트롤러/사용자 페어링을 활성 사용자로 설정하거나, 컨트롤러와 사용자를 식별하기 위한 참여 프롬프트를 표시하거나, 로그인을 위한 계정 선택기를 표시해야 합니다. 통과 예

1. 타이틀이 타이틀을 실행한 컨트롤러/사용자 페어링을 활성 사용자로 설정합니다.
2. 타이틀이 컨트롤러와 사용자를 식별하기 위한 참여 프롬프트를 표시합니다.
3. 타이틀이 로그인을 위한 계정 선택기를 표시합니다.

실패 예

1. 타이틀에서 사용자가 처음 사용한 컨트롤러로 타이틀을 제어할 수 없습니다.
2. 로그인한 사용자 없이 실행했을 때 타이틀이 사용자에게 활성 사용자를 설정하라는 메시지를 표시하지 않습니다.

​

112-03 로그인한 사용자 없음

테스트 단계

1. 로그인한 사용자가 없는지 확인합니다.
2. 타이틀을 실행하고 사용자 데이터 저장을 지원하는 모든 모드에 들어갑니다.
3. 각 모드에서 데이터 손실이 발생하기 전에 사용자에게 로그인할 기회를 제공하는지 확인합니다.
4. 로그인 기회를 취소하고 타이틀이 진행 상황이 저장되지 않는다는 경고를 표시하는지 확인합니다.

예상 결과
타이틀이 일반적으로 사용자 데이터나 게임 상태를 저장하는 모드에 있는 경우 타이틀은 사용자에게 로그인할 기회를 제공해야 합니다. 타이틀은 사용자가 로그인하지 않고 게임 플레이를 계속하면 진행 상황이 저장되지 않는다는 것을 사용자에게 알려야 합니다. 통과 예

1. 로그인하지 않은 사용자가 일반적으로 사용자 데이터나 게임 상태를 저장하는 타이틀 모드에 액세스할 때 로그인하라는 메시지가 표시됩니다.
2. 사용자가 로그인하지 않고 모드를 계속 진행하면 진행 상황이 저장되지 않는다는 알림을 받습니다.

실패 예

1. 일반적으로 사용자 데이터나 게임 상태를 저장하는 모드에 있는 동안 사용자가 로그인하지 않고 해당 모드를 계속 진행하면 진행 상황이 저장되지 않는다는 알림을 받지 않습니다.
2. 데이터 손실이 이미 발생한 후에 사용자가 진행 상황을 저장할 수 없다는 알림을 받습니다.

​

112-04 활성 사용자 표시

테스트 단계

1. 이전에 타이틀을 실행한 적이 없고 연결된 저장 데이터가 없는 프로필에 로그인합니다.
2. 타이틀을 실행합니다.
3. 프로필 관련 작업을 수행하기 전에 타이틀이 UI 내에서 활성 사용자를 식별하는지 확인합니다. “프로필 관련 작업”의 예로는 사용자의 저장된 게임 또는 기본 설정 변경, 사용자 프로필에 데이터 저장, 도전 과제 부여, 사용자에 대한 통계 작성, 기타 사용자 데이터 또는 상태의 로컬 또는 클라우드 사용이나 조작이 있습니다.
4. 저장 데이터를 만듭니다.
5. 타이틀을 다시 실행하고 프로필 관련 작업을 수행하기 전에 타이틀이 UI 내에서 활성 사용자를 식별하는지 확인합니다.
6. XBOX Live에서 연결을 끊습니다.
7. 타이틀을 다시 실행하고 프로필 관련 작업을 수행하기 전에 타이틀이 UI 내에서 활성 사용자를 식별하는지 확인합니다.

예상 결과
타이틀은 첫 번째 프로필 관련 작업 전에 현재 사용자 컨텍스트를 표시해야 합니다. 통과 예

1. 타이틀이 프로필 관련 작업을 수행하기 전에 타이틀 내에 사용자의 게이머태그 및/또는 게이머 사진을 표시합니다.
2. 사용자 프로필을 사용하지 않는 타이틀은 활성 사용자를 표시하지 않습니다.
3. 타이틀이 여러 사용자를 지원하는 게임 모드에서 여러 활성 사용자를 표시합니다.

실패 예

1. 타이틀이 프로필 관련 작업을 수행하기 전에 타이틀의 활성 사용자를 표시하지 않습니다.

​

112-05 계정 선택기 액세스

테스트 단계

1. 프로필에 로그인하고 타이틀을 실행합니다.
2. 타이틀에서 활성 사용자가 타이틀 내의 계정 선택기에 액세스하여 다른 프로필을 선택할 수 있는지 확인합니다.

예상 결과
타이틀은 사용자가 활성 사용자를 변경하기 위해 타이틀 내의 계정 선택기에 액세스할 수 있도록 해야 합니다. 통과 예

1. 타이틀에서 사용자가 타이틀 내의 계정 선택기에 액세스할 수 있습니다.

실패 예

1. 타이틀에서 사용자가 타이틀 내의 계정 선택기에 액세스할 수 없습니다.

​

112-06 프로필 변경 처리

테스트 단계

1. 프로필에 로그인하고 타이틀을 실행합니다.
2. 계정 선택기에 액세스하여 다른 프로필을 선택합니다.
3. 타이틀이 적절하게 반응하고 활성 사용자의 컨텍스트를 새 프로필로 전환하는지 확인합니다.
4. 타이틀에서 계정 선택기에 액세스할 수 있는 모든 위치에 대해 1-4단계를 반복합니다.

예상 결과
타이틀은 사용자가 다른 사용자의 컨텍스트로 원활하게 변경할 수 있도록 해야 합니다. 통과 예

1. 타이틀이 활성 사용자를 변경하면 데이터가 손실될 수 있음을 사용자에게 알리고, 계정 선택기로 진행하기 전에 사용자에게 확인을 요청합니다.
2. 타이틀이 새 활성 사용자의 컨텍스트로 적절하게 업데이트됩니다.

실패 예

1. 타이틀이 새 활성 사용자의 컨텍스트로 적절하게 업데이트되지 않습니다.

​

112-07 제한 모드 중 사용자 변경

테스트 단계

1. 프로필 A에 로그인하고 타이틀을 실행합니다.
2. 타이틀 내의 여러 위치에서 XBOX 버튼을 눌러 타이틀을 제한된 상태로 만듭니다.
3. 타이틀이 제한된 상태인 동안 프로필 A에서 로그아웃하고 프로필 B에 로그인합니다.
4. 타이틀을 다시 시작합니다.
5. 타이틀이 새 활성 사용자에 맞게 적절하게 반응하는지 확인합니다.

예상 결과 타이틀이 제한 모드에서 다시 시작되면 타이틀은 이전에 참여한 모든 사용자가 여전히 콘솔에 로그인되어 있는지 확인해야 합니다. 통과 예

1. 애플리케이션이 다시 시작할 때 활성 사용자 컨텍스트를 자동으로 프로필 B로 전환합니다.
2. 게임 타이틀이 타이틀에서 프로필 A를 자동으로 제거하거나 새 사용자를 다시 설정하고 해당 새 사용자의 상태를 게임 플레이에 사용합니다.

실패 예

1. 타이틀이 활성 사용자인 프로필 A를 컨텍스트에서 제거하도록 업데이트되지 않습니다.
2. 새 프로필을 선택한 후에도 게임이 게임 플레이에 프로필 A의 상태를 계속 사용합니다.

​

112-08 일시 중단 중 사용자 변경

리테일 콘솔에서 게임은 다음 조건에서 일시 중단됩니다.

• 전원 모드가 인스턴트 온으로 설정된 상태에서 콘솔을 꺼서 연결된 대기 상태로 전환될 때.
• 게임이 10분 동안 포커스를 잃은 상태로 유지될 때. 예를 들어 설정과 같은 애플리케이션을 실행하고 10분 동안 포커스를 유지하는 경우.

이 테스트 사례에서는 2단계에서 두 가지 방법을 모두 확인해야 합니다. 테스트 단계

1. XBOX 프로필에 로그인하고 게임을 실행합니다.
2. 게임 전체의 여러 위치에서 게임을 일시 중단합니다.
3. 게임이 일시 중단된 동안 프로필 A에서 로그아웃하고 프로필 B에 로그인합니다.
4. 게임을 다시 시작하고 게임이 새 활성 사용자에 맞게 적절하게 반응하는지 확인합니다.
5. 새 활성 사용자로 게임 플레이에 들어가 사용자가 진행할 수 있는지 확인합니다.

예상 결과

1. 게임이 일시 중단에서 다시 시작되면 게임은 이전에 참여한 모든 사용자가 여전히 콘솔에 로그인되어 있는지 확인해야 합니다.

통과 예

1. 게임이 다시 시작할 때 활성 사용자 컨텍스트를 자동으로 프로필 B로 전환합니다.
2. 게임이 게임에서 프로필 A를 자동으로 제거하거나 새 사용자를 다시 설정하고 해당 새 사용자의 상태를 게임 플레이에 사용합니다.

실패 예

1. 게임이 활성 사용자인 프로필 A를 컨텍스트에서 제거하도록 업데이트되지 않습니다.
2. 새 프로필을 선택한 후에도 게임이 게임 플레이에 프로필 A의 상태를 계속 사용합니다.