추가 정보
타이틀은 자체 네트워크 작업의 성능에 대응하거나 Windows.XBOX.Networking 네트워크 품질 API를 사용하여 현재 네트워크 상태를 확인해야 합니다. 또한 더 적은 데이터를 전송하거나, 적절한 사용자 역할을 선택하거나, 클라우드 서비스를 사용하여 기능을 정상적으로 저하시켜야 합니다.XBOX 이외 서비스 문제 처리
사용자 경험에 영향을 주는 비일시적 시간 초과, 네트워크 API 오류 또는 누락된 서비스 구성과 같은 파트너 서비스 문제가 발생한 타이틀은 사용할 수 없는 특정 기능이나 서비스를 사용자에게 알려야 합니다. 타이틀은 사용자가 문제를 해결하는 동안 안전한 상태로, 또는 사용자가 수동으로 재시도할 수 있는 상태로 정상적으로 실패해야 합니다. 사용자 친화적인 메시지의 예는 다음과 같습니다.“죄송합니다. 현재 _Microsoft 이외 서비스_를 사용할 수 없습니다. 나중에 다시 시도하세요. 자세한 내용은 _Microsoft 이외 지원 연락처 정보_로 문의하세요.”
XBOX 서비스 문제 처리
XBOX 서비스에 대한 연결이 끊어지면 일부 기능을 사용하지 못할 수 있습니다. 이러한 경우 타이틀은 명확하고 사용자 친화적인 메시지를 사용하여 이를 사용자에게 전달해야 합니다. 서비스를 사용할 수 없는 경우 타이틀은 요청을 재시도할 수 있지만 XBOX에서 허용하는 매개 변수 내에서만 가능합니다. 필수 HTTP 재시도 및 백오프 논리와 개별 서비스에 대한 사용자 상호 작용 지침을 포함하여 XBOX 콘솔 타이틀의 서비스 복원력에 대한 자세한 내용은 타이틀의 서비스 중단 복원력을 참조하세요.XBOX 연결 요구
XBOX 콘솔용으로 개발할 때, 대부분의 기능에 인터넷 연결(특히 XBOX 연결)이 필요한 타이틀은 AppX 매니페스트에 부울 플래그RequireXboxLive를 포함할 수 있습니다. 이렇게 하면 XBOX를 사용할 수 없을 때 XBOX 콘솔에서 타이틀이 시작되지 않으며, 연결이 끊어지면 타이틀이 일시 중단된 후 종료됩니다.
GDK를 사용한 네트워킹에 대한 자세한 내용은 네트워킹 섹션을 참조하세요.
인증 테스트 사례
074-01 XBOX 서비스에 대한 WAN 연결 끊김
테스트 단계- XBOX 프로필에 로그인합니다.
- 다음 작업을 수행하는 동안 WAN 네트워크 연결을 끊습니다. 이더넷 스위치/허브를 사용하는 경우 네트워크 디바이스에서 업링크 케이블을 분리합니다. 디바이스가 Wi-Fi를 통해 연결된 경우 무선 액세스 포인트 연결에서 업링크 케이블을 분리합니다.
- 새 저장 지점 만들기
- 저장 지점 로드
- 자동 저장 지점 도달
- 저장된 게임 목록 열거
- 온라인 세션 검색 및 참가
- 온라인 세션 만들기 시도
- 순위표 보기(해당하는 경우)
- 오프라인 플레이
콘솔이 XBOX 서비스에 연결할 수 없는 경우 타이틀은 사용자 친화적인 오류 메시지로 응답해야 합니다. 통과 예
- 타이틀이 XBOX 서비스에 대한 네트워크 연결 끊김을 나타내는 오류 메시지를 표시합니다.
- XBOX 서비스가 필요하지 않은 로컬 게임 모드를 플레이하는 동안에는 타이틀이 오류 메시지를 표시하지 않습니다.
- AppX 매니페스트에
RequireXboxLive가 있는 타이틀은 연결이 끊어지면 일시 중단된 후 종료됩니다.
- 사용자가 비온라인 XBOX 게임 세션을 완료할 수 없습니다.
- 타이틀이 응답하지 않거나 불안정한 상태가 됩니다.
074-02 직접 연결 끊김
테스트 단계- 타이틀을 실행하고 XBOX 프로필에 로그인합니다.
- 타이틀에서 다음 작업을 수행하는 동안 디바이스에서 네트워크 케이블을 뽑거나 WAP 또는 무선 라우터의 전원을 끕니다.
- 새 저장 지점 만들기.
- 저장 지점 로드.
- 자동 저장 지점 도달.
- 저장된 게임 목록 열거.
- 온라인 세션 검색 및 참가.
- 온라인 세션 만들기 시도.
- 순위표 보기(해당하는 경우).
- 오프라인 플레이.
디바이스가 XBOX 서비스에 대한 연결을 잃은 경우 타이틀은 사용자 친화적인 오류 메시지로 응답해야 합니다. 통과 예
- 온라인 게임 모드에서 타이틀이 사용자 친화적인 메시지를 표시합니다.
- 오프라인 게임 모드에서는 타이틀이 게임 플레이를 중단하지 않습니다.
- AppX 매니페스트에
RequireXboxLive가 있는 타이틀은 연결이 끊어지면 일시 중단된 후 종료됩니다.
- 오프라인 게임 모드 중에 오류 메시지가 표시됩니다.
- 타이틀이 응답하지 않거나 불안정한 상태가 됩니다.
- 네트워크가 오프라인이 된 후에도 사용자가 온라인 메뉴를 보거나 버퍼링된 미디어를 볼 수 있습니다.
074-03 XBOX 서비스에 대한 일시 중단 연결 끊김
리테일 콘솔에서 게임은 다음 조건에서 일시 중단됩니다.- 전원 모드가 인스턴트 온으로 설정된 상태에서 콘솔을 꺼서 연결된 대기 상태로 전환될 때.
- 게임이 10분 동안 포커스를 잃은 상태로 유지될 때. 예를 들어 설정과 같은 애플리케이션을 실행하고 10분 동안 포커스를 유지하는 경우.
- 콘솔 전원 모드를 인스턴트 온으로 설정한 상태에서 XBOX 프로필에 로그인합니다.
- 게임을 실행하고 게임 플레이로 진행합니다.
- 게임 전체의 여러 지점에서 게임을 일시 중단합니다.
- 게임을 다시 시작하고 게임이 연결 끊김을 정상적으로 처리하는지 확인합니다.
- 게임 전체에서 3-4단계를 반복합니다.
일시 중단된 후 콘솔이 XBOX 서비스에 연결할 수 없는 경우 타이틀은 성공적으로 다시 시작되고, 상황을 정상적으로 처리하며, 적절한 경우 사용자 친화적인 오류 메시지로 응답해야 합니다. 통과 예
- 온라인 XBOX 멀티플레이어 세션 중에 타이틀이 XBOX 서비스에 대한 네트워크 연결 끊김을 나타내는 오류 메시지를 표시합니다.
- XBOX 서비스가 필요하지 않은 로컬 게임 모드를 플레이하는 동안에는 타이틀이 오류 메시지를 표시하지 않습니다.
- 사용자가 비온라인 XBOX 게임 세션을 완료할 수 없습니다.
- 타이틀이 응답하지 않거나 불안정한 상태가 됩니다.
- 다시 시작한 후 타이틀이 오해의 소지가 있거나 잘못된 오류 메시지를 표시합니다.
074-04 일시 중단 중 XBOX 서비스 다시 연결
리테일 콘솔에서 게임은 다음 조건에서 일시 중단됩니다.- 전원 모드가 인스턴트 온으로 설정된 상태에서 콘솔을 꺼서 연결된 대기 상태로 전환될 때.
- 게임이 10분 동안 포커스를 잃은 상태로 유지될 때. 예를 들어 설정과 같은 애플리케이션을 실행하고 10분 동안 포커스를 유지하는 경우.
- 콘솔 전원 모드를 인스턴트 온으로 설정한 상태에서 XBOX 프로필에 로그인하고 콘솔이 홈에 있는지 확인합니다.
- XBOX에 연결되지 않았지만 로컬 네트워크 연결은 유지된 상태에서 타이틀을 실행합니다.
- 이더넷 스위치 또는 허브를 사용하는 경우 네트워크 디바이스에서 업링크 케이블을 분리합니다.
- 디바이스가 Wi-Fi를 통해 연결된 경우 무선 액세스 포인트에서 업링크 케이블을 분리합니다.
- 게임 전체의 여러 지점에서 게임을 일시 중단합니다.
- 업링크 케이블을 다시 연결하고 콘솔이 XBOX 서비스에 다시 연결될 때까지 기다립니다.
- 게임을 다시 시작하고 게임이 다시 연결을 정상적으로 처리하는지 확인합니다.
- 게임 전체에서 2-5단계를 반복합니다.
일시 중단된 후 콘솔이 XBOX 서비스에 연결할 수 없는 경우 타이틀은 성공적으로 다시 시작되고, 상황을 정상적으로 처리하며, 적절한 경우 사용자 친화적인 오류 메시지로 응답해야 합니다. 통과 예
- 사용자가 타이틀을 다시 시작하고 중단 없이 오프라인 XBOX 게임 세션을 완료할 수 있습니다.
- 타이틀이 안정적으로 유지되며 크래시되지 않습니다.
- 사용자가 비온라인 XBOX 게임 세션을 완료할 수 없습니다.
- 타이틀이 응답하지 않거나 불안정한 상태가 됩니다.
- 다시 시작한 후 타이틀이 오해의 소지가 있거나 잘못된 오류 메시지를 표시합니다.
074-07 동적 연결 끊김
필요한 도구: 파트너 서비스를 차단하도록 XMAT 구성 설치, 캡처 설정 및 스크립팅 지침은 XBOX Multiplayer Analysis Tool을 사용하여 네트워크 트래픽 검사 및 수정을 참조하세요.- XMAT를 관리자 권한으로 시작하고 테스트 대상 디바이스에 대한 Web Proxy 캡처를 추가합니다.
- XBOX 개발 콘솔에서는 Enable XBOX Proxy를 선택하고 콘솔이 다시 시작될 때까지 기다립니다.
- Windows에서는 Start Capture를 선택합니다.
- XMAT가 캡처하는 동안 타이틀을 실행하고 모든 메뉴를 탐색하고, 멀티플레이어 세션을 완료하고, 모든 게임 모드를 로드하고, 다음을 포함하여 타이틀의 모든 영역을 탐색합니다.
- 메뉴.
- 순위표.
- 서버(서버를 만들고 다른 사람의 서버에 참가).
- 친구 목록.
- 타이틀 내 스토어.
- 기간 한정 이벤트.
- Host 필터를 사용하여 일반 게임 플레이 중에 연결되는 파트너 서비스 호스트를 식별합니다. 차단하기 전에 선택한 호스트가 Microsoft, XBOX 또는 PlayFab에 속하지 않는지 확인합니다.
- Script Editor를 열고 SSL Connection Request 이벤트를 선택한 다음, 각 파트너 서비스 호스트에 대해
Params.Continue를false로 설정하는 스크립트를 만듭니다. - 스크립트를 사용하도록 설정하고 성공적으로 컴파일되는지 확인합니다. 그런 다음 테스트가 시작될 때 파트너 서비스를 계속 사용할 수 있도록 스크립트를 사용하지 않도록 설정합니다. XMAT 캡처는 계속 실행 상태로 둡니다.
- XMAT 차단 스크립트를 사용하지 않도록 설정한 상태에서 XBOX 프로필에 로그인하고 타이틀을 실행합니다.
- 파트너 호스팅 서비스를 사용하는 타이틀 기능으로 이동하여 해당 기능을 사용할 수 있는지 확인합니다.
- 타이틀을 닫지 않고 XMAT 차단 스크립트를 사용하도록 설정합니다.
- 타이틀을 계속 진행하면서 다음을 포함하여 해당하는 모든 영역을 사용해 봅니다.
- 메뉴
- 순위표
- 서버(서버를 만들고 다른 사람의 서버에 참가)
- 친구 목록
- 타이틀 내 스토어
- 기간 한정 이벤트
- 타이틀이 XBOX 네트워크에 문제가 있음을 나타내는 오류 메시지를 표시하지 않는지 확인합니다.
타이틀이 Microsoft 이외 서비스에 대한 연결 끊김을 정상적으로 처리합니다. 통과 예
- 파트너 호스팅 서비스에 대한 연결이 끊어져도 타이틀이 중단되거나 크래시되지 않습니다.
- 표시된 메시지가 Microsoft 서비스에 문제가 있음을 암시합니다.
- 설명이 부족한 오류 메시지가 표시됩니다.
- 타이틀이 크래시되거나, 불안정해지거나, 콘솔이 다시 부팅됩니다.
074-08 출시 전 가동 중지 시간
필요한 도구:- GDK/XDK의 xbstress.exe
- Windows용 XBOX Multiplayer Analysis Tool(XMAT).
- 콘솔에서 다음 명령을 사용하여 _xbstress.exe_로 Microsoft 이외 트래픽에 대한 끊어진 네트워크 채널을 만듭니다.
xbstress set channel=0 network=broken addresses=[semicolon delimited list of addresses]
- 다음 명령으로 네트워크 시뮬레이션을 시작합니다.
xbstress simulate network=channels. - Windows에서 테스트하는 경우 타이틀을 실행하기 전에 XMAT 웹 프록시 캡처를 구성하고 해당 파트너 서비스 호스트를 차단하는 스크립트를 사용하도록 설정합니다.
- XBOX 프로필에 로그인합니다.
- 타이틀을 실행합니다.
- Microsoft 이외 온라인 기능에 액세스합니다.
타이틀은 Microsoft 이외 서비스에 연결하는 데 문제가 있음을 나타내는 사용자 친화적인 오류 메시지를 제공하고 연결을 재시도할 수 있는 기회를 제공해야 합니다. 통과 예
- 파트너 호스팅 서비스에 대한 연결이 끊어져도 타이틀이 중단되거나 크래시되지 않습니다.
- 표시된 오류가 Microsoft 서비스에 문제가 있음을 암시합니다.
- 설명이 부족한 오류 메시지가 표시됩니다.
- 타이틀이 크래시되거나, 불안정해지거나, 콘솔이 다시 부팅됩니다.