XR-074: Xbox 및 파트너 서비스에 대한 연결 끊김 *

버전 1.2, 2024년 4월 1일

타이틀은 Xbox 및 파트너 서비스 연결 오류를 안정적으로 처리해야 합니다. 타이틀은 오류가 발생한 후 Xbox 서비스에 대한 요청을 재시도하려고 할 때 Xbox에 설정된 재시도 정책을 준수해야 합니다. 타이틀은 서비스가 사용 불가능할 때 사용자에게 보내는 메시지를 적절하게 관리해야 합니다. 파트너 서비스를 사용할 수 없는 경우 게임에 Xbox 네트워크에 문제가 있다고 표시되어서는 안 됩니다. 네트워크 서비스가 느리거나 간헐적으로 사용 가능한 경우 타이틀이 충돌하거나 중단되지 않아야 합니다.

추가 정보

타이틀은 자체 네트워크 작업의 성능에 반응하거나 Windows.Xbox.Networking 네트워크 품질 API를 사용하여 현재 네트워크 상태를 파악해야 합니다. 또한 더 적은 데이터를 전송하거나, 적절한 사용자 역할을 선택하거나, 클라우드 서비스를 활용하여 안정적으로 문제를 완화시켜야 합니다.

Xbox 서비스가 아닌 다른 서비스의 문제 처리

일시적이지 않은 시간 초과 오류, 네트워크 API 오류, 누락된 서비스 구성 오류 등 문제가 있는 파트너 서비스로 인해 사용자 환경에 영향이 있는 경우, 타이틀에서 사용자에게 특정 기능이나 서비스를 사용할 수 없다는 경고를 표시해야 합니다. 타이틀은 사용자가 문제를 해결할 수 있는 안전한 상태로 매끄럽게 돌아가거나 사용자가 수동으로 재시도할 수 있는 상태로 돌아가야 합니다.

친근한 메시지의 예는 다음과 같습니다.

"죄송합니다. non-Microsoft service를 현재 사용할 수 없습니다. 나중에 다시 시도하세요. 자세한 내용은 비 Microsoft 지원 연락처 정보를 참조하세요."

Xbox 서비스의 문제 처리

Xbox 서비스 연결이 끊기면 일부 기능을 이용할 수 없게 될 수 있습니다. 이런 경우에 타이틀은 사용자와 소통하기 위해 분명하고 친근한 메시지를 사용해야 합니다.

서비스를 사용할 수 없는 경우 타이틀에서 요청을 다시 시도할 수 있지만 Xbox에서 허용하는 기준 내에서만 가능합니다. 필요한 HTTP 재시도와 차단 로직, 개별 서비스에 대한 상호 작용 지침을 포함하여 Xbox 콘솔 타이틀에 대한 서비스 복구에 대한 자세한 내용은 Xbox One 타이틀에서의 서비스 중단 복구를 참조하세요.

Xbox 연결 필요

Xbox 콘솔용 타이틀을 개발할 때 대부분의 기능에 인터넷(특히 Xbox) 연결이 필요한 타이틀은 AppX 매니페스트에 부울 플래그 RequireXboxLive를 포함할 수 있습니다. 이렇게 하면 Xbox를 사용할 수 없을 때 Xbox 콘솔에서 타이틀이 시작되지 않도록 차단되며, 연결이 끊어지면 타이틀이 일시 중단된 후 종료됩니다.

GDK를 사용한 네트워킹에 대한 자세한 내용은 네트워킹 섹션을 참조하세요.

인증 테스트 사례

074-01 Xbox 서비스에 대한 WAN 연결 끊기

테스트 단계

1. Xbox 프로필에 로그인합니다.
2. 다음 작업을 수행하는 동안 WAN 네트워크 연결을 해제합니다(이더넷 스위치/허브를 사용하는 경우 네트워크 장치에서 업링크 케이블을 분리합니다. 장치가 Wifi를 통해 연결된 경우 무선 액세스 포인트에서 업링크 케이블을 분리합니다).

• 새 저장 지점 만들기.
• 저장 지점 로드.
• 자동 저장 지점에 도달.
• 저장된 게임 목록 열거.
• 온라인 세션 검색 및 참가.
• 온라인 세션 생성 시도.
• 순위표 보기(해당하는 경우).
• 오프라인으로 플레이.

예상 결과
콘솔이 Xbox 서비스에 도달할 수 없는 경우 타이틀은 사용자에게 친숙한 오류 메시지로 응답해야 합니다.

통과 예시

1. Xbox 서비스에 대한 네트워크 연결 끊김을 나타내는 오류 메시지가 타이틀에 표시됩니다.
2. Xbox 서비스가 필요하지 않은 로컬 게임 모드를 실행하는 동안에는 오류 메시지가 타이틀에 표시되지 않습니다.
3. AppX 매니페스트에서 RequireXboxLive가 포함된 제목은 연결이 끊어지면 일시 중지된 다음 종료됩니다.

실패 예시

1. 사용자가 온라인이 아닌 Xbox 게임 세션을 완료할 수 없습니다.
2. 타이틀이 응답하지 않는 상태 또는 불안정한 상태가 됩니다.

074-02 직접 연결 끊기

테스트 단계

1. Xbox 프로필에 로그인합니다.
2. 타이틀을 실행합니다.
3. 타이틀에서 다음 작업을 수행하는 동안 네트워크 케이블을 장치에서 뽑거나 WAP 또는 무선 라우터의 전원을 끕니다.

• 새 저장 지점 만들기.
• 저장 지점 로드.
• 자동 저장 지점에 도달.
• 저장된 게임 목록 열거.
• 온라인 세션 검색 및 참가.
• 온라인 세션 생성 시도.
• 순위표 보기(해당하는 경우).
• 오프라인으로 플레이.

예상 결과
장치와 Xbox 서비스의 연결이 끊기는 경우 타이틀은 사용자에게 친숙한 오류 메시지로 응답해야 합니다.

통과 예시

1. 온라인 게임 모드 중에는 사용자에게 친숙한 메시지가 타이틀에 표시됩니다.
2. 오프라인 게임 모드 중에는 타이틀의 게임 플레이가 중단되지 않습니다.
3. AppX 매니페스트에서 RequireXboxLive가 포함된 제목은 연결이 끊어지면 일시 중지된 다음 종료됩니다.

실패 예시

1. 오프라인 게임 모드 중에 오류 메시지가 표시됩니다.
2. 네트워크가 오프라인으로 전환된 후 사용자가 온라인 메뉴를 보거나 버퍼링된 미디어를 볼 수 있습니다.

074-03 Xbox 서비스에 대한 연결 끊기 일시 중단

구성:  Xbox 장치의 경우 타이틀을 설치하고 'xbapp 목록'을 사용하여 타이틀의 패키지 정식 이름(PFN)을 반환합니다.

테스트 단계

1. Xbox 프로필에 로그인하고 타이틀을 시작합니다.
2. 기본 메뉴 또는 프런트 엔드 메뉴에 있는 동안 다음을 수행합니다.

• Xbox 장치에서 테스트하는 경우 xbapp suspend [PFN]을 실행하여 타이틀을 일시 중단합니다. 또는
• PC의 Windows 10에서 테스트하는 경우 창을 최소화하여 타이틀을 일시 중단합니다. 또는
• Windows 10 Mobile에서 테스트하는 경우 장치의 Windows 단추를 눌러 타이틀을 일시 중단합니다.

3. 타이틀이 완전히 일시 중단되고 일시 중단으로 인해 모든 HTTP 요청이 중단될 때까지 30초 동안 기다립니다.
4. 타이틀을 계속합니다.
5. 지원되는 경우 다음 추가 영역에서 [2] - [4]단계를 반복합니다.

• 단일 플레이어 게임 세션 중.
• 온라인 멀티 플레이어 세션 중.
• 게임 전 멀티 플레이어 로비에 있는 중.
• 온라인 순위표를 보는 중.
• 비디오 또는 오디오 재생 중.

예상 결과
콘솔이 일시 중단된 후 Xbox 서비스에 도달할 수 없는 경우 타이틀은 성공적으로 다시 활성화되고, 상황을 안정적으로 처리한 다음, 적절한 경우 사용자에게 친숙한 오류 메시지로 응답해야 합니다.

통과 예시

1. 온라인 Xbox 멀티 플레이어 세션 중에 Xbox 서비스에 대한 네트워크 연결 끊김을 나타내는 오류 메시지가 타이틀에 표시됩니다.
2. Xbox 서비스가 필요하지 않은 로컬 게임 모드를 실행하는 동안에는 오류 메시지가 타이틀에 표시되지 않습니다.

실패 예시

1. 사용자가 온라인이 아닌 Xbox 게임 세션을 완료할 수 없습니다.
2. 타이틀이 응답하지 않는 상태 또는 불안정한 상태로 전환됩니다.
3. 다시 시작한 후 잘못 유도하거나 잘못된 오류 메시지가 표시됩니다.

074-04 일시 중단 중 Xbox 서비스 다시 연결

구성:  Xbox 장치의 경우 타이틀을 설치하고 'xbapp 목록'을 사용하여 타이틀의 패키지 정식 이름(PFN)을 반환합니다.

테스트 단계

1. Xbox 프로필에 로그인하고 콘솔이 홈으로 설정되어 있는지 확인합니다.
2. Xbox에 연결되지 않았지만 로컬 네트워크 연결은 유지한 상태에서(이더넷 스위치/허브를 사용하는 경우 네트워크 장치에서 업링크 케이블 분리, 장치가 Wifi를 통해 연결된 경우 무선 액세스 포인트에서 업링크 케이블 분리) 타이틀을 실행합니다.
3. 기본 메뉴 또는 프런트 엔드 메뉴에 있는 동안 다음을 수행합니다.

• Xbox 장치에서 테스트하는 경우 xbapp suspend [PFN]을 실행하여 타이틀을 일시 중단합니다. 또는
• PC의 Windows 10에서 테스트하는 경우 창을 최소화하여 타이틀을 일시 중단합니다. 또는
• Windows 10 Mobile에서 테스트하는 경우 장치의 Windows 단추를 눌러 타이틀을 일시 중단합니다.

4. 타이틀이 완전히 일시 중단되고 일시 중단으로 인해 모든 HTTP 요청이 중단될 때까지 30초 이상 기다립니다.
5. 업링크 케이블을 다시 연결하고 콘솔이 Xbox에 다시 연결될 때까지 기다립니다.
6. 타이틀을 계속합니다.
7. 지원되는 경우 다음 추가 영역에서 [2] – [6]단계를 반복합니다.

• 단일 플레이어 게임 세션 중.
• 저장/로드 메뉴 내에서 게임을 저장/로드하기 전.

예상 결과
콘솔이 일시 중단된 후 Xbox 서비스에 도달할 수 없는 경우 타이틀은 성공적으로 다시 활성화되고, 상황을 안정적으로 처리한 다음, 적절한 경우 사용자에게 친숙한 오류 메시지로 응답해야 합니다.

통과 예시

1. 사용자가 타이틀을 계속하여 오프라인 Xbox 게임 세션을 중단 없이 완료할 수 있습니다.
2. 타이틀이 안정적인 상태를 유지하고 충돌하지 않습니다.

실패 예시

1. 사용자가 온라인이 아닌 Xbox 게임 세션을 완료할 수 없습니다.
2. 타이틀이 응답하지 않는 상태 또는 불안정한 상태로 전환됩니다.
3. 다시 시작한 후 잘못 유도하거나 잘못된 오류 메시지가 표시됩니다.

074-05 일정하게 낮은 대역폭

필요한 도구: GDK/XDK의 xbstress.exe

구성: 네트워크 시뮬레이션은 명령줄 스트레스 도구인 xbstress.exe로 제어됩니다. 이 도구는 네트워크 시뮬레이션을 비롯하여 다양한 본체 스트레스 요소를 구성합니다. 네트워크 관리 목적에 따라 xbstress.exe는 Xbox 장치에서 패킷을 삭제하고 지연 시간을 삽입하고 처리량을 제한하는 특수 드라이버를 제어합니다. xbstress.exe에는 최소, 평균 및 우수로 중요한 네트워크 관리 시나리오를 쉽게 시뮬레이션할 수 있게 해주는 세 가지 미리 구성된 시뮬레이션 프로필이 포함되어 있습니다. 최소 프로필이 이 XR에 매핑됩니다.

테스트 단계

1. XBStress의 최소 프로필을 사용하여 연결을 Xbox 장치의 최소 작동 요건으로 제한합니다.
2. 다음과 같은 타이틀 관련 온라인 작업을 수행합니다.

• 모든 메뉴를 탐색합니다.
• 온라인 게임 세션을 플레이합니다.

예상 결과
사용자 인터넷 연결이 192Kbps 아래로 떨어질 때 타이틀이 작동 중단되거나 사용자 데이터 손실이 발생하지 않아야 합니다.

통과 예시

1. 낮은 대역폭 때문에 온라인 플레이에 영향을 줄 수 있음을 나타내는 사용자에게 친숙한 메시지가 표시됩니다.
2. 타이틀이 작동 중단되지 않고 사용자 데이터 손실이 발생하지 않습니다.

실패 예시

1. 타이틀이 작동 중단되고 사용자 데이터 손실이 발생합니다.

074-06 불규칙하게 낮은 대역폭

필요한 도구: GDK/XDK의 xbstress.exe

구성: 네트워크 시뮬레이션은 명령줄 스트레스 도구인 xbstress.exe로 제어됩니다. 이 도구는 네트워크 시뮬레이션을 비롯하여 다양한 본체 스트레스 요소를 구성합니다. 네트워크 관리 목적에 따라 xbstress.exe는 Xbox 장치에서 패킷을 삭제하고 지연 시간을 삽입하고 처리량을 제한하는 특수 드라이버를 제어합니다. xbstress.exe에는 최소, 평균 및 우수로 중요한 네트워크 관리 시나리오를 쉽게 시뮬레이션할 수 있게 해주는 세 가지 미리 구성된 시뮬레이션 프로필이 포함되어 있습니다. 최소 프로필이 이 XR에 매핑됩니다.

테스트 단계

1. XBstress에서 모든 네트워크 제한을 사용 중지합니다.
2. 다음과 같은 타이틀 관련 온라인 작업을 수행합니다.

• 모든 메뉴를 탐색합니다.
• 온라인 게임 세션을 플레이합니다.

3. [2] 단계를 수행하는 동안 xbstress의 최소 프로필을 사용 설정합니다.

예상 결과
사용자 인터넷 연결이 192Kbps 아래로 떨어질 때 타이틀이 작동 중단되거나 사용자 데이터 손실이 발생하지 않아야 합니다.

통과 예시

1. 낮은 대역폭 때문에 온라인 플레이에 영향을 줄 수 있음을 나타내는 사용자에게 친숙한 메시지가 표시됩니다.
2. 타이틀이 작동 중단되지 않고 사용자 데이터 손실이 발생하지 않습니다.

실패 예시

1. 타이틀이 작동 중단되고 사용자 데이터 손실이 발생합니다.

074-07 동적 연결 끊김

필요한 도구:

• GDK/XDK의 xbstress.exe
• Windows 10의 경우 Fiddler

구성:
Xbox 장치의 경우 네트워크 시뮬레이션은 명령줄 스트레스 도구인 xbstress.exe로 제어됩니다. 사용자는 xbstress.exe를 사용하여 도메인 이름 및 IP 목록을 차단할 수 있으며 이 테스트는 타사 트래픽을 차단하기 위해 제공된 주소 목록으로 수행됩니다.

테스트 단계

1. Xbox 프로필에 로그인합니다.
2. 타이틀을 시작합니다.
3. 타사 온라인 기능에 액세스합니다.
4. Xbox 장치에서 테스트하는 경우 다음 명령을 사용하여 타사 트래픽에 대해 xbstress로 연결 해제된 네트워크 채널을 생성합니다.

xbstress set channel=0 network=broken addresses=[semicolon delimited list of addresses]

5. xbstress simulate network=channels 명령을 사용하여 네트워크 시뮬레이션을 시작합니다.
6. Windows 10에서 테스트하는 경우 fiddler를 사용하여 가동 중지 시간을 에뮬레이션합니다.

예상 결과
타이틀이 타사 서비스에 대한 연결 끊기를 안정적으로 처리합니다.

통과 예시

1. 파트너 호스팅 서비스에 대한 연결이 끊어질 때 타이틀이 중단되거나 충돌하지 않습니다.

실패 예시

1. 표시되는 오류가 Microsoft 서비스에 문제가 있음을 암시합니다.
2. 설명이 없는 오류 메시지가 표시됩니다.
3. 타이틀이 충돌하거나 불안정해지거나 콘솔이 다시 부팅됩니다.

074-08 시작 전 가동 중지 시간

필요한 도구:

• GDK/XDK의 xbstress.exe
• Windows 10의 경우 Fiddler

구성:
Xbox One의 경우 네트워크 시뮬레이션은 명령줄 스트레스 도구인 xbstress.exe로 제어됩니다. 사용자는 xbstress.exe를 사용하여 도메인 이름 및 IP 목록을 차단할 수 있으며 이 테스트는 타사 트래픽을 차단하기 위해 제공된 주소 목록으로 수행됩니다.

테스트 단계

1. Xbox 장치에서 테스트하는 경우 다음 명령을 사용하여 타사 트래픽에 대해 xbstress로 연결 해제된 네트워크 채널을 생성합니다.

xbstress set channel=0 network=broken addresses=[semicolon delimited list of addresses]

2. xbstress simulate network=channels 명령을 사용하여 네트워크 시뮬레이션을 시작합니다.
3. Windows 10에서 테스트하는 경우 fiddler를 사용하여 가동 중지 시간을 에뮬레이션합니다.
4. Xbox 프로필에 로그인합니다.
5. 타이틀을 시작합니다.
6. 타사 온라인 기능에 액세스합니다.

예상 결과
타이틀이 타사 서비스에 도달하는 데 문제가 있음을 나타내는 사용자에게 친숙한 오류 메시지를 제공해야 하며 연결을 재시도할 수 있는 기회를 허용해야 합니다.

통과 예시

1. 파트너 호스팅 서비스에 대한 연결이 끊어질 때 타이틀이 중단되거나 충돌하지 않습니다.

실패 예시

1. 표시되는 오류가 Microsoft 서비스에 문제가 있음을 암시합니다.
2. 설명이 없는 오류 메시지가 표시됩니다.
3. 타이틀이 충돌하거나 불안정해지거나 콘솔이 다시 부팅됩니다.