> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 PIX 中进行游戏可持续性测试

> 使用 Performance Investigator for XBOX(PIX)和 Power Monitor 测量 XBOX 作品的功耗 —— 分步的开发工具包配置、捕获与指标。

**Performance Investigator for XBOX(PIX)** 是 XBOX 上首选的图形性能分析工具。它还随附 **Power Monitor**,让你可以详细分析功耗 —— 观察峰值和低谷相对于屏幕内容出现的位置。

关于工具和指标的概述,参见 [可持续性开发者概览](https://docs.xbox.com/zh-CN/build/game-principles/sustainability/sustainability-developer-overview.md)。PIX 通用文档参见 [PIX for XBOX](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix.md)。

## 前置条件

* 一台安装了最新 **GDK** 的 PC,且与主机在同一网络。
* 通过 GDK 安装的 **PIX**。
* 在 PIX 中选择 **Power Monitor**。
* 一台 **XBOX Series X 开发工具包**。

## 配置主机以进行分析

**1. 通过 GDK Command Prompt 连接**

在 PC 上启动 **GDK Command Prompt** 并连接到主机:

```sh theme={null}
xbconnect <tools-ip>
```

Tools IP 可在主机上通过 **Settings › Console info › Developer settings** 查看。

**2. 在 XBOX Manager 中启用分析模式**

启动 **XBOX Manager**,进入 **Console settings › Debug**,并勾选 **Enable profiling mode**。

> [!WARNING]
>
> 功耗测试完成后、恢复正常 XR 测试前,请关闭分析模式。

**3. 启动 PIX**

在 PC 上启动 **PIX**。应用应切换到主机视图。

主机视图包含:

* **Timing Capture Options** —— 数据的采集与传输方式。
* **Graphs** —— 采集数据的实时可视化。
* **Counter Control Panel** —— 移除/添加当前图表所展示的数据集。
* **Counter Menu** —— PIX 可采集的全部计数器列表。

## 配置采集

在 **Timing Capture Options** 中设置:

* **Mode**:Streaming Mode
* **CPU Samples**:4k/sec (Balanced)
* **Video Frames**:Enabled
* **Compress data for transport**:Disabled(除非带宽受限)

### 选择计数器

移除现有图表(点击每个图表右上角的 **x**)。从 Counter Menu 将以下项拖到 **Drag a counter here to create a new graph**:

* **GPU% Busy**
* **Power Load**

## 采集数据

**1. 启动作品**

启动游戏。图表应开始填充采集到的数据。

**2. 开始采集**

导航到想要测试的区域。按 **Start Timing Capture** 或 `Ctrl+T` 开始采集视频和数据。

**3. 通关并停止**

在该区域中推进玩法。按 **Stop Timing Capture**。应用会切换到 **Timeline** 标签页,将采集的指标与视频一一对应。

## 阅读 Metrics 标签页

打开 **Metrics** 标签页可以看到功耗的可视化。

### 指标选择器

选择要绘制的指标。对于功耗分析,选择:

* **Power Monitor › Load**
* **GPU › GPU% Busy**

### Active Metrics

启用/禁用先前选择的指标,并更改其颜色。

> [!TIP]
>
> 确保图表按 **Average** 聚合。在 PIX 左下角选中指标,然后在右侧面板打开 **Graph** 标签页,确认聚合下拉菜单设为 **Average**。

### 使用图表

高亮图表的某一段可以缩放或对齐时间轴。常用操作:

* **Zoom to Selected Range** —— 用所选范围填满图表区域,以获得更细致的视图。
* **Zoom Timeline View to Selected Range** —— 将视频时间轴与所选范围对齐,便于查看数据对应游戏中的位置。
* **Export Graphed Metrics** —— 将每个数据点(值 + 时间戳)导出为 CSV。可在 Excel 中打开并使用 `=AVERAGE(...)` 计算平均值。

## 认证团队的主机配置

对于认证实验室测试的每款作品,XBOX 都会保持相同的配置以获得可比结果。各变量的一致性是跨作品对比得以有意义的前提。

[实验室平台基线](https://docs.xbox.com/zh-CN/build/game-principles/sustainability/lab-platform-baselines.md) 页面报告的平均值即为该配置下的采集结果。

## 下一步

* [可持续性开发工具包指南](https://docs.xbox.com/zh-CN/build/game-principles/sustainability/sustainability-devkit-guide.md) —— 无需 PIX 即可直接在开发工具包上读取功耗。
* [可持续性开发者概览](https://docs.xbox.com/zh-CN/build/game-principles/sustainability/sustainability-developer-overview.md) —— 应该信任哪些指标,以及节能空间藏在哪里。
* [动态电源状态](https://docs.xbox.com/zh-CN/build/game-principles/sustainability/dynamic-power-states.md) —— 使用 PIX 验证 DPS 行为。


## Related topics

- [使用开发工具包进行游戏可持续性测试](https://docs.xbox.com/zh-CN/build/game-principles/sustainability/sustainability-devkit-guide.md)
- [游戏可持续性：实验室平台基线](https://docs.xbox.com/zh-CN/build/game-principles/sustainability/lab-platform-baselines.md)
- [游戏可持续性认证测试](https://docs.xbox.com/zh-CN/build/game-principles/sustainability/sustainability-case-studies.md)
- [游戏可持续性：Halo Infinite 案例研究](https://docs.xbox.com/zh-CN/build/game-principles/sustainability/case-studies/case-studies-halo.md)
- [游戏可持续性：Minecraft 案例研究](https://docs.xbox.com/zh-CN/build/game-principles/sustainability/case-studies/case-studies-minecraft.md)