​

XR-074: XBOX 및 파트너 서비스에 대한 연결 손실 *

버전 2.0, 2025/11/1 타이틀은 XBOX 및 파트너 서비스 연결 오류를 원활하게 처리해야 합니다. 타이틀은 오류 발생 후 XBOX 서비스로의 요청을 재시도할 때 XBOX에서 설정한 재시도 정책을 준수해야 합니다. 타이틀은 서비스가 사용 불가능한 경우 사용자에게 적절히 메시지를 전달해야 합니다. 파트너 서비스가 사용 불가능한 경우, 게임은 XBOX 네트워크에 문제가 있는 것처럼 표시해서는 안 됩니다. 타이틀은 네트워크 서비스가 느려지거나 간헐적으로 사용 가능한 경우에도 크래시가 발생하거나 멈추어서는 안 됩니다.

​

추가 정보

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

​

비 XBOX 서비스 관련 문제 처리

일시적이지 않은 시간 초과, 네트워크 API 오류, 사용자 경험에 영향을 주는 서비스 구성 누락 등 파트너 서비스에 문제가 발생하는 타이틀은 사용 불가능한 특정 기능 또는 서비스에 대해 사용자에게 알려야 합니다. 타이틀은 사용자가 문제를 해결하는 동안 안전한 상태로, 또는 사용자가 수동으로 재시도할 수 있는 상태로 원활하게 실패해야 합니다. 사용자 친화적인 메시지의 예는 다음과 같습니다.

“죄송합니다. Microsoft 이외의 서비스 를 현재 사용할 수 없습니다. 나중에 다시 시도해 주세요. 자세한 내용은 Microsoft 이외의 지원 연락처 에 문의하세요.”

​

XBOX 서비스 관련 문제 처리

XBOX 서비스에 대한 연결이 손실되면 일부 기능이 사용 불가능해질 수 있습니다. 이러한 경우, 타이틀은 명확하고 사용자 친화적인 메시지를 사용하여 사용자에게 이를 전달해야 합니다. 서비스가 사용 불가능한 경우, 타이틀은 요청을 재시도할 수 있지만 XBOX에서 허용하는 매개변수 내에서만 재시도할 수 있습니다. XBOX 콘솔 타이틀의 서비스 복원력, 필수 HTTP 재시도 및 백오프 로직, 개별 서비스에 대한 사용자 상호작용 안내 등 자세한 정보는 GDK의 Service Interruption Resiliency for Titles 문서를 참조하세요.

​

XBOX 연결 요구

XBOX 콘솔용으로 개발할 때, 대부분의 기능에 인터넷 또는 특히 XBOX 연결이 필요한 타이틀은 AppX 매니페스트에 부울 플래그 RequireXboxLive를 포함할 수 있습니다. 이렇게 하면 XBOX가 사용 불가능한 경우 XBOX 콘솔에서 타이틀이 실행되는 것을 차단하고, 연결이 손실되면 타이틀을 일시 중단시킨 후 종료합니다. GDK를 사용하는 네트워킹에 대한 자세한 정보는 GDK 문서의 Networking 섹션을 참조하세요.

​

인증 테스트 케이스

​

074-01 XBOX 서비스에 대한 WAN 연결 해제

테스트 단계

1. XBOX 프로필에 로그인합니다.
2. 다음 작업을 수행하는 동안 WAN 네트워크 연결을 끊습니다. 이더넷 스위치/허브를 사용하는 경우, 네트워크 장치에서 업링크 케이블을 분리합니다. 장치가 Wi-Fi를 통해 연결된 경우, 무선 액세스 포인트 연결에서 업링크 케이블을 분리합니다:
   • 새 저장 지점 생성
   • 저장 지점 로드
   • 자동 저장 지점 도달
   • 저장된 게임 목록 열거
   • 온라인 세션 검색 및 참여
   • 온라인 세션 생성 시도
   • 리더보드 보기(해당하는 경우)
   • 오프라인 플레이

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

1. 타이틀이 XBOX 서비스에 대한 네트워크 연결 손실을 나타내는 오류 메시지를 표시합니다.
2. XBOX 서비스가 필요하지 않은 로컬 게임 모드를 플레이하는 동안 타이틀이 오류 메시지를 표시하지 않습니다.
3. AppX 매니페스트에 RequireXboxLive가 포함된 타이틀이 연결 손실 시 일시 중단된 후 종료됩니다.

실패 예시

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

​

074-02 직접 연결 해제

테스트 단계

1. 타이틀을 실행하고 XBOX 프로필에 로그인합니다.
2. 타이틀에서 다음 작업을 수행하는 동안 장치에서 네트워크 케이블을 뽑거나 WAP 또는 무선 라우터의 전원을 끕니다:
   • 새 저장 지점 생성.
   • 저장 지점 로드.
   • 자동 저장 지점 도달.
   • 저장된 게임 목록 열거.
   • 온라인 세션 검색 및 참여.
   • 온라인 세션 생성 시도.
   • 리더보드 보기(해당하는 경우).
   • 오프라인 플레이.

예상 결과 장치가 XBOX 서비스에 대한 연결을 잃는 경우, 타이틀은 사용자 친화적인 오류 메시지로 응답해야 합니다. 통과 예시

1. 타이틀이 온라인 게임 모드에서 사용자 친화적인 메시지를 표시합니다.
2. 타이틀이 오프라인 게임 모드 동안 게임플레이를 중단하지 않습니다.
3. AppX 매니페스트에 RequireXboxLive가 포함된 타이틀이 연결 손실 시 일시 중단된 후 종료됩니다.

실패 예시

1. 오프라인 게임 모드 동안 오류 메시지가 표시됩니다.
2. 타이틀이 응답하지 않거나 불안정한 상태가 됩니다.
3. 네트워크가 오프라인 상태가 된 후에도 사용자가 온라인 메뉴를 보거나 버퍼링된 미디어를 볼 수 있습니다.

​

074-03 XBOX 서비스에 대한 일시 중단 연결 해제

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

• 전원 모드가 Instant-on으로 설정된 상태에서 콘솔이 꺼져 Connected Standby에 들어갈 때.
• 게임이 10분 동안 포커스에서 벗어난 상태를 유지할 때. 예를 들어, 설정과 같은 애플리케이션을 실행하고 10분 동안 포커스를 유지하는 경우입니다.

이 테스트 케이스의 목적상, 3단계에서 두 가지 방법 모두를 확인해야 합니다. 테스트 단계

1. 콘솔 전원 모드를 Instant-on으로 설정한 상태에서 XBOX 프로필에 로그인합니다.
2. 게임을 실행하고 게임플레이로 진행합니다.
3. 게임 진행 중 다양한 지점에서 게임을 일시 중단합니다.
4. 게임을 재개하고 게임이 연결 해제를 원활하게 처리하는지 확인합니다.
5. 게임 전반에 걸쳐 3–4단계를 반복합니다.

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

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

실패 예시

1. 사용자가 온라인이 아닌 XBOX 게임 세션을 완료할 수 없습니다.
2. 타이틀이 응답하지 않거나 불안정한 상태가 됩니다.
3. 재개 후 타이틀이 오해의 소지가 있거나 잘못된 오류 메시지를 표시합니다.

​

074-04 일시 중단 중 XBOX 서비스 재연결

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

• 전원 모드가 Instant-on으로 설정된 상태에서 콘솔이 꺼져 Connected Standby에 들어갈 때.
• 게임이 10분 동안 포커스에서 벗어난 상태를 유지할 때. 예를 들어, 설정과 같은 애플리케이션을 실행하고 10분 동안 포커스를 유지하는 경우입니다.

이 테스트 케이스의 목적상, 3단계에서 두 가지 방법 모두를 확인해야 합니다. 테스트 단계

1. 콘솔 전원 모드를 Instant-on으로 설정하고 콘솔이 Home으로 설정된 상태에서 XBOX 프로필에 로그인합니다.
2. XBOX에 대한 연결 없이 로컬 네트워크 연결만 유지한 상태에서 타이틀을 실행합니다.
   • 이더넷 스위치/허브를 사용하는 경우, 네트워크 장치에서 업링크 케이블을 분리합니다.
   • 장치가 Wi-Fi를 통해 연결된 경우, 무선 액세스 포인트에서 업링크 케이블을 분리합니다.
3. 게임 진행 중 다양한 지점에서 게임을 일시 중단합니다.
4. 업링크 케이블을 다시 연결하고 콘솔이 XBOX 서비스에 재연결될 때까지 기다립니다.
5. 게임을 재개하고 게임이 재연결을 원활하게 처리하는지 확인합니다.
6. 게임 전반에 걸쳐 2–5단계를 반복합니다.

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

1. 사용자가 타이틀을 재개하고 중단 없이 오프라인 XBOX 게임 세션을 완료할 수 있습니다.
2. 타이틀이 안정적으로 유지되며 크래시가 발생하지 않습니다.

실패 예시

1. 사용자가 온라인이 아닌 XBOX 게임 세션을 완료할 수 없습니다.
2. 타이틀이 응답하지 않거나 불안정한 상태가 됩니다.
3. 재개 후 타이틀이 오해의 소지가 있거나 잘못된 오류 메시지를 표시합니다.

​

074-05 지속적인 저 대역폭

필요한 도구

• GDK/XDK의 xbstress.exe.

구성 네트워크 시뮬레이션은 명령줄 스트레스 도구인 xbstress.exe로 제어됩니다. 이 도구는 네트워크 시뮬레이션을 포함한 다양한 콘솔 스트레스 요소를 구성합니다. 네트워킹 목적으로 xbstress.exe는 XBOX 장치의 특수 드라이버를 제어하며, 이 드라이버는 패킷을 폐기하고, 지연을 삽입하며, 처리량을 제한합니다. xbstress.exe에는 중요한 네트워킹 시나리오를 쉽게 시뮬레이션할 수 있는 세 가지 사전 구성된 시뮬레이션 프로필이 있습니다: minimum, average, excellent. minimum 프로필이 이 XR에 해당합니다. 테스트 단계

1. minimum 프로필을 사용하여 XBOX 장치의 최소 작동 요구 사항에 맞게 연결을 스로틀링합니다.
2. 다음을 포함하되 이에 국한되지 않는 타이틀 관련 온라인 작업을 수행합니다.
   • 모든 메뉴 탐색.
   • 온라인 게임 세션 플레이.

예상 결과 사용자의 인터넷 연결이 192 Kbps 아래로 떨어질 때 타이틀은 크래시가 발생하거나 사용자 데이터 손실을 유발해서는 안 됩니다. 통과 예시

1. 저 대역폭으로 인해 온라인 플레이에 영향을 미칠 수 있음을 나타내는 사용자 친화적인 메시지가 표시됩니다.
2. 타이틀이 크래시되지 않으며 사용자 데이터 손실을 유발하지 않습니다.

실패 예시

1. 타이틀이 크래시되거나 사용자 데이터 손실을 유발합니다.

​

074-06 가변적 저 대역폭

필요한 도구

• GDK/XDK의 xbstress.exe.

구성 네트워크 시뮬레이션은 명령줄 스트레스 도구인 xbstress.exe로 제어됩니다. 이 도구는 네트워크 시뮬레이션을 포함한 다양한 콘솔 스트레스 요소를 구성합니다. 네트워킹 목적으로 xbstress.exe는 XBOX 장치의 특수 드라이버를 제어하며, 이 드라이버는 패킷을 폐기하고, 지연을 삽입하며, 처리량을 제한합니다. xbstress.exe에는 중요한 네트워킹 시나리오를 쉽게 시뮬레이션할 수 있는 세 가지 사전 구성된 시뮬레이션 프로필이 있습니다: minimum, average, excellent. minimum 프로필이 이 XR에 해당합니다. 테스트 단계

1. xbstress.exe에서 모든 네트워크 제한을 비활성화합니다.
2. 다음을 포함하되 이에 국한되지 않는 타이틀 관련 온라인 작업을 수행합니다.
   • 모든 메뉴 탐색.
   • 온라인 게임 세션 플레이.
3. 2단계를 수행하는 동안 xbstress minimum 프로필을 활성화합니다.

예상 결과 사용자의 인터넷 연결이 192 Kbps 아래로 떨어질 때 타이틀은 크래시가 발생하거나 사용자 데이터 손실을 유발해서는 안 됩니다. 통과 예시

1. 저 대역폭으로 인해 온라인 플레이에 영향을 미칠 수 있음을 나타내는 사용자 친화적인 메시지가 표시됩니다.
2. 타이틀이 크래시되지 않으며 사용자 데이터 손실을 유발하지 않습니다.

실패 예시

1. 타이틀이 크래시되거나 사용자 데이터 손실을 유발합니다.

​

074-07 동적 연결 손실

필요한 도구

• Content Blocking 애드온이 포함된 Fiddler Classic.

Content Blocking 애드온을 사용하여 파트너 서비스를 차단하도록 Fiddler Classic 구성

• 콘솔에서 웹 서비스 호출을 디버깅하도록 Fiddler를 설정합니다.
• PC에서 웹 서비스 호출을 디버깅하도록 Fiddler를 설정합니다.
• Fiddler용 Content Blocking 애드온을 설치합니다.
• Fiddler에서 ContentBlock 메뉴를 선택하고 “Enabled”를 선택합니다.

테스트 단계

1. XBOX 프로필에 로그인하고 타이틀을 실행합니다.
2. 멀티플레이어 세션을 완료하고, 모든 게임 모드로 로드하며, 다음을 포함하되 이에 국한되지 않는 타이틀의 모든 영역을 탐색합니다.
   • 메뉴
   • 리더보드
   • 서버(하나 만들고 다른 사람의 것에 참여)
   • 친구 목록
   • 타이틀 내 스토어
   • 한정 기간 이벤트
3. 타이틀이 XBOX 네트워크에 문제가 있음을 나타내는 오류 메시지를 표시하지 않는지 확인합니다.

예상 결과 타이틀이 Microsoft 이외의 서비스에 대한 연결 해제를 원활하게 처리합니다. 통과 예시

1. 파트너가 호스팅하는 서비스에 대한 연결 손실 시 타이틀이 멈추거나 크래시되지 않습니다.

실패 예시

1. 표시된 메시지가 Microsoft 서비스의 문제를 암시합니다.
2. 설명이 없는 오류 메시지가 표시됩니다.
3. 타이틀이 크래시되거나 불안정해지거나 콘솔 재부팅을 유발합니다.

​

074-08 실행 전 다운타임

필요한 도구

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

테스트 단계

1. 콘솔에서 다음 명령을 사용하여 Microsoft 이외의 트래픽에 대해 xbstress.exe로 손상된 네트워크 채널을 생성합니다: 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. Microsoft 이외의 온라인 기능에 액세스합니다.

예상 결과 타이틀은 Microsoft 이외의 서비스에 도달하는 데 문제가 있음을 나타내는 사용자 친화적인 오류 메시지를 제공하고 연결을 재시도할 기회를 허용해야 합니다. 통과 예시

1. 파트너가 호스팅하는 서비스에 대한 연결 손실 시 타이틀이 멈추거나 크래시되지 않습니다.

실패 예시

1. 표시된 오류가 Microsoft 서비스의 문제를 암시합니다.
2. 설명이 없는 오류 메시지가 표시됩니다.
3. 타이틀이 크래시되거나 불안정해지거나 콘솔 재부팅을 유발합니다.