XR-132: 서비스 액세스 제한 *
버전 1.2, 2025/11/01 XBOX 네트워크 서비스를 호출할 때 타이틀 및 사용자 기반 제한을 초과하거나 XBOX 네트워크 서비스 재시도 정책을 준수하지 않는 타이틀은 속도 제한이 적용될 수 있으며, 이로 인해 서비스 중단 또는 지원 중단이 발생할 수 있습니다. 지정된 제한을 준수하지 않으면 타이틀 출시가 차단될 수 있으며, 출시된 타이틀의 프로덕션 문제로 인해 XBOX 네트워크 서비스가 정지되거나 타이틀이 제거될 수 있습니다.XR-132는 멀티플레이어 게임에 초점을 맞추고 있지만, 싱글 플레이어 게임이 XBOX 네트워크 서비스에 액세스하는 경우에도 적용될 수 있습니다. 예를 들어, 싱글 플레이어 게임이 클라우드 저장, 업적 또는 기타 XBOX 네트워크 기능을 사용하는 경우 XR-132 지침을 준수해야 합니다.
인증 테스트 케이스
132-01 서비스 액세스 제한
필요한 도구
- 콘솔의 Fiddler 또는 PC의 Fiddler
- GDK 개발 도구 다운로드 패키지의 XBOX services Trace Analyzer. 타이틀이 만든 서비스 호출을 검토하고 호출 패턴에서 위반 사항을 찾는 데 사용됩니다.
테스트 단계
Fiddler Classic 사용:- 타이틀 실행 전에 Fiddler Classic을 시작하고 콘솔 또는 Windows 10 PC(문제의 타이틀이 실행되는 곳)에서 네트워크 트래픽을 캡처하도록 구성되었는지 확인합니다.
- Fiddler Classic이 실행되고 네트워크 트래픽을 캡처하는 상태에서 타이틀을 실행하고 다음을 포함하되 이에 국한되지 않는 모든 영역을 진행합니다.
- 게임 저장을 생성하고 콘솔을 재부팅한 후 게임 저장 로드
- 리치 프레즌스 상태를 빠르게 연속으로 변경(가능한 경우)
- 업적 잠금 해제 및 보기
- 모든 리더보드에 게시하고 모든 필터를 사용하여 모든 리더보드 보기
- 게임 내 친구 목록 보기(프레즌스가 차단된 친구 포함) 및 페이지 간 빠른 이동
- 히어로 스탯 획득 및 보기
- 사용 가능한 세션을 찾을 수 없는 경우(가능한 경우)를 포함하여 모든 온라인 모드에 매치메이킹하고 음성 트래픽 생성
- 게임 클립 생성, 저장 및 공유
- 게임 내 스토어 액세스(해당하는 경우)
- 테스트가 완료되면 Fiddler 캡처를 로컬 디렉터리에 저장합니다.
- GDK/XDK 명령 프롬프트에서
XblTraceAnalyzer -data filepath -outputdir filepath를 실행합니다. - 4단계의 출력 디렉터리를 열고 ‘index’ 파일을 엽니다(프롬프트가 표시되면 ‘차단된 콘텐츠 허용’ 선택).
xbtrace.exe 사용
xbtrace.exe는 타이틀이 실행될 때까지 시작할 수 없지만, 시작 중에 타이틀이 만드는 모든 XBOX 서비스 호출을 캡처하기 위해 가능한 한 빨리 시작해야 합니다. 이로 인해 타이틀 트래픽을 캡처하는 기본 방법은 타이틀 실행 전에 시작할 수 있는 Fiddler Classic입니다.
- 타이틀이 실행 중인 상태에서
xbtrace start xboxliveservices를 실행하고 다음을 포함하되 이에 국한되지 않는 타이틀의 모든 영역을 진행합니다.- 게임 저장을 생성하고 콘솔을 재부팅한 후 게임 저장 로드
- 리치 프레즌스 상태를 빠르게 연속으로 변경(가능한 경우)
- 업적 잠금 해제 및 보기
- 모든 리더보드에 게시하고 모든 필터를 사용하여 모든 리더보드 보기
- 게임 내 친구 목록 보기(프레즌스가 차단된 친구 포함) 및 페이지 간 빠른 이동
- 히어로 스탯 획득 및 보기
- 사용 가능한 세션을 찾을 수 없는 경우(가능한 경우)를 포함하여 모든 온라인 모드에 매치메이킹하고 음성 트래픽 생성
- 게임 클립 생성, 저장 및 공유
- 게임 내 스토어 액세스(해당하는 경우)
- 테스트가 완료되면
xbtrace stop을 두 번 실행합니다. - 콘솔의 파일을 탐색하고
SystemScratch > xbtrace에서 csv를 찾습니다. 타임스탬프를 확인하여 기록을 중지한 시간을 등록하는지 확인합니다. 로컬에 복사합니다. - XDK 명령 프롬프트에서
Xbltraceanalyzer -data filepath -outputdir filepath를 실행합니다. - 4단계의 출력 디렉터리를 열고 ‘index’ 파일을 엽니다(프롬프트가 표시되면 ‘차단된 콘텐츠 허용’ 선택).
예상 결과
타이틀은 XBOX 엔드포인트에 대한 서비스 호출이 지정된 버스트 및 지속 제한 아래로 유지되도록 하고, XBOX services Trace Analyzer 보고서에 빨간색 결과가 나오지 않도록 해야 합니다. XBOX services Trace Analyzer 도구는 위반 사항이 발견된 규칙과 해당 위반 사항의 세부 정보를 나타내는report.txt 파일을 생성합니다.
통과 예시
- XBOX 서비스를 호출할 때 타이틀이 지속 제한을 초과하지 않습니다.
- XBOX services Trace Analyzer 보고서에 노란색 및/또는 녹색 결과만 포함됩니다.
- 타이틀이 지속 제한(속도 제한이 적용되는 제한)을 10배 초과합니다. 예를 들어, 세밀한 속도 제한이 적용되는 지속 제한이 300초 동안 300 호출로 설정된 경우, 300초 동안 3000 호출 이상인 타이틀은 실패합니다.
- XBOX services Trace Analyzer 보고서에 하나 이상의 빨간색 결과가 포함됩니다.
132-02 게임 이벤트 제한
테스트 단계
- 타이틀을 설치하고 타이틀이 실행 중인 상태에서 다음을 포함하되 이에 국한되지 않는 모든 영역으로 이동합니다.
- 게임 저장을 생성하고 콘솔을 재부팅한 후 게임 저장 로드
- 리치 프레즌스 상태를 빠르게 연속으로 변경(가능한 경우)
- 업적 잠금 해제 및 보기
- 모든 리더보드에 게시하고 모든 필터를 사용하여 모든 리더보드 보기
- 게임 내 친구 목록 보기(프레즌스가 차단된 친구 포함) 및 페이지 간 빠른 이동
- 히어로 스탯 획득 및 보기
- 사용 가능한 세션을 찾을 수 없는 경우(가능한 경우)를 포함하여 모든 온라인 모드에 매치메이킹하고 음성 트래픽 생성
- 게임 클립 생성, 저장 및 공유
- 게임 내 스토어 액세스(해당하는 경우)
- 테스트 중에 타이틀을 관찰하여 게임 이벤트 제한 시스템 토스트가 나타나는지 확인합니다.
예상 결과
게임은 게임 이벤트 제한 시스템 토스트를 트리거해서는 안 됩니다. 통과 예시- 타이틀이 게임 이벤트 제한 시스템 토스트를 트리거하지 않습니다.
- 타이틀이 게임 이벤트 제한 시스템 토스트를 트리거합니다.
