​

XR-132：服务访问限制 *

版本 1.2，2025 年 11 月 1 日 在调用 XBOX network 服务时超出基于游戏和用户的限制、或不遵守 XBOX network 服务重试策略的游戏可能会被限流，进而可能导致服务中断或降级。未能遵守指定的限制可能会阻止游戏发布；已发布游戏在生产环境中的问题可能会导致 XBOX network 服务被暂停，甚至可能被下架。

​

认证测试用例

​

132-01 服务访问限制

​

所需工具

• 主机版 Fiddler 或 PC 版 Fiddler
• 来自 GDK 开发工具下载包的 XBOX services Trace Analyzer。它用于查看游戏发出的服务调用，并发现调用模式中的任何违规。

​

测试步骤

使用 Fiddler Classic：

1. 在启动游戏之前，启动 Fiddler Classic，并确保其配置为从主机或 Windows 10 PC（相关游戏运行的位置）捕获网络流量。
2. 在 Fiddler Classic 运行并捕获网络流量的状态下，启动游戏并遍历所有区域，包括但不限于：
   • 创建游戏存档，重启主机并加载存档
   • 快速连续更改丰富状态（rich presence）（如可能）
   • 解锁并查看成就
   • 向所有排行榜发布内容，并使用所有筛选器查看所有排行榜
   • 查看游戏内好友列表（包括一位屏蔽显示状态的好友），并快速在页面之间切换
   • 获得并查看 Hero Stat
   • 匹配加入所有在线模式，包括无法找到可用会话的情况（如可能），并产生语音流量
   • 创建、保存并分享游戏片段
   • 访问游戏内商店（如适用）
3. 测试结束后，将 Fiddler 捕获保存到本地目录。
4. 在 GDK/XDK 命令提示符中运行 XblTraceAnalyzer -data filepath -outputdir filepath。
5. 打开第 4 步的输出目录，并打开 ‘index’ 文件（如果提示，选择”允许被阻止的内容”）。

使用 xbtrace.exe 请注意，xbtrace.exe 只有在游戏启动后才能开始工作，但应尽快启动以捕获游戏在启动期间发出的任何 XBOX 服务调用。因此，捕获游戏流量的首选方法是 Fiddler Classic，因为它可以在启动游戏之前先运行。

1. 在游戏运行的状态下，运行 xbtrace start xboxliveservices，并遍历游戏的所有区域，包括但不限于：
   • 创建游戏存档，重启主机并加载存档
   • 快速连续更改丰富状态（如可能）
   • 解锁并查看成就
   • 向所有排行榜发布内容，并使用所有筛选器查看所有排行榜
   • 查看游戏内好友列表（包括一位屏蔽显示状态的好友），并快速在页面之间切换
   • 获得并查看 Hero Stat
   • 匹配加入所有在线模式，包括无法找到可用会话的情况（如可能），并产生语音流量
   • 创建、保存并分享游戏片段
   • 访问游戏内商店（如适用）
2. 测试结束后，运行 xbtrace stop 两次。
3. 浏览主机文件，在 SystemScratch > xbtrace 中会找到 csv 文件。检查时间戳以确认其记录了你停止录制的时间。将其复制到本地。
4. 在 XDK 命令提示符中运行 Xbltraceanalyzer -data filepath -outputdir filepath。
5. 打开第 4 步的输出目录，并打开 ‘index’ 文件（如果提示，选择”允许被阻止的内容”）。

​

预期结果

游戏必须确保其对 XBOX 端点的服务调用低于指定的突发和持续限制，且其 XBOX services Trace Analyzer 报告中不能出现红色结果。 XBOX services Trace Analyzer 工具会生成一个 report.txt 文件，指明发现违规的规则以及这些违规的详细信息。 通过示例

1. 游戏在调用 XBOX 服务时未超过持续限制。
2. XBOX services Trace Analyzer 报告仅包含黄色和/或绿色结果。

不通过示例

1. 游戏超过持续限制（限流生效点）10 倍。例如，如果细粒度限流生效的持续限制设为 300 秒内 300 次调用，则达到或超过 300 秒内 3000 次调用的游戏将不通过。
2. XBOX services Trace Analyzer 报告包含一个或多个红色结果。

​

132-02 游戏事件限制

​

测试步骤

1. 安装游戏，并在游戏运行的状态下遍历游戏的所有区域，包括但不限于：
   • 创建游戏存档，重启主机并加载存档
   • 快速连续更改丰富状态（如可能）
   • 解锁并查看成就
   • 向所有排行榜发布内容，并使用所有筛选器查看所有排行榜
   • 查看游戏内好友列表（包括一位屏蔽显示状态的好友），并快速在页面之间切换
   • 获得并查看 Hero Stat
   • 匹配加入所有在线模式，包括无法找到可用会话的情况（如可能），并产生语音流量
   • 创建、保存并分享游戏片段
   • 访问游戏内商店（如适用）
2. 在测试期间，观察游戏是否会出现”游戏事件限制”（Game Event Limitations）系统提示。

​

预期结果

游戏不得触发”游戏事件限制”系统提示。 通过示例

1. 游戏未触发”游戏事件限制”系统提示。

不通过示例

1. 游戏触发了”游戏事件限制”系统提示。