> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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**,让你可以详细分析功耗 —— 观察峰值和低谷相对于屏幕内容出现的位置。

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

## 前置条件

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

## 配置主机以进行分析

<Steps>
  <Step title="通过 GDK Command Prompt 连接">
    在 PC 上启动 **GDK Command Prompt** 并连接到主机:

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

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

  <Step title="在 XBOX Manager 中启用分析模式">
    启动 **XBOX Manager**,进入 **Console settings › Debug**,并勾选 **Enable profiling mode**。

    <Warning>
      功耗测试完成后、恢复正常 XR 测试前,请关闭分析模式。
    </Warning>
  </Step>

  <Step title="启动 PIX">
    在 PC 上启动 **PIX**。应用应切换到主机视图。

    主机视图包含:

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

## 配置采集

在 **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**

## 采集数据

<Steps>
  <Step title="启动作品">
    启动游戏。图表应开始填充采集到的数据。
  </Step>

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

  <Step title="通关并停止">
    在该区域中推进玩法。按 **Stop Timing Capture**。应用会切换到 **Timeline** 标签页,将采集的指标与视频一一对应。
  </Step>
</Steps>

## 阅读 Metrics 标签页

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

### 指标选择器

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

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

### Active Metrics

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

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

### 使用图表

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

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

## 认证团队的主机配置

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

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

## 下一步

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


## Related topics

- [可持续性开发者概览](/zh-CN/build/game-principles/sustainability/sustainability-developer-overview.md)
- [动态电源状态(DPS)](/zh-CN/build/game-principles/sustainability/dynamic-power-states.md)
- [实验室平台基线](/zh-CN/build/game-principles/sustainability/lab-platform-baselines.md)
- [在 Partner Center 中查看可持续性数据](/zh-CN/build/game-principles/sustainability/partner-center-sustainability-data.md)
- [认证可持续性功耗报告](/zh-CN/build/game-principles/sustainability/sustainability-case-studies.md)