> ## 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.

# Testes de sustentabilidade em jogos no PIX

> Meça o consumo de energia do seu título XBOX com o Performance Investigator for XBOX (PIX) e o Power Monitor: configuração passo a passo do devkit, captura e métricas.

O **Performance Investigator for XBOX (PIX)** é a principal ferramenta de desempenho gráfico no XBOX. Ele também inclui o **Power Monitor** para que você possa criar um perfil detalhado do consumo de energia, vendo onde ocorrem picos e vales em relação ao que está na tela.

Para obter uma visão geral das ferramentas e métricas, consulte a [Visão geral de sustentabilidade para desenvolvedores](https://docs.xbox.com/pt-BR/build/game-principles/sustainability/sustainability-developer-overview.md). Para a documentação geral do PIX, consulte [PIX for XBOX](https://docs.xbox.com/pt-BR/tools/tools-console/pix/pix.md).

## Pré-requisitos

* Um PC com o **GDK** mais recente instalado, na mesma rede que o seu console.
* O **PIX** instalado por meio do GDK.
* O **Power Monitor** selecionado no PIX.
* Um **XBOX Series X development kit**.

## Configurar o console para criação de perfil

**1. Conecte-se pelo GDK Command Prompt**

Inicie o **GDK Command Prompt** no seu PC e conecte-se ao console:

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

O Tools IP está no console em **Settings › Console info › Developer settings**.

**2. Habilite o modo de criação de perfil no XBOX Manager**

Inicie o **XBOX Manager**, navegue até **Console settings › Debug** e marque **Enable profiling mode**.

> [!WARNING]
>
> Desabilite o modo de criação de perfil após o teste de energia, antes de retomar os testes normais de XR.

**3. Inicie o PIX**

Inicie o **PIX** no PC. O aplicativo deve mudar para a exibição do console.

A exibição do console inclui:

* **Timing Capture Options**: como os dados são capturados e transferidos.
* **Graphs**: visualização em tempo real dos dados capturados.
* **Counter Control Panel**: remova/adicione os conjuntos de dados representados no gráfico no momento.
* **Counter Menu**: a lista completa de contadores que o PIX pode capturar.

## Configurar a captura

Em **Timing Capture Options**, defina:

* **Mode**: Streaming Mode
* **CPU Samples**: 4k/sec (Balanced)
* **Video Frames**: Enabled
* **Compress data for transport**: Disabled (a menos que a largura de banda seja um problema)

### Escolher contadores

Remova os gráficos existentes (selecione o **x** no canto superior direito de cada um). No Counter Menu, arraste estes para **Drag a counter here to create a new graph**:

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

## Capturar dados

**1. Inicie o título**

Inicie o jogo. O gráfico deve ser preenchido com os dados capturados.

**2. Inicie a captura**

Navegue até a área que você deseja testar. Pressione **Start Timing Capture** ou `Ctrl+T` para começar a capturar vídeo e dados.

**3. Jogue e pare**

Avance pela área. Pressione **Stop Timing Capture**. O aplicativo muda para a guia **Timeline**, que associa as métricas capturadas ao vídeo capturado.

## Ler a guia Metrics

Abra a guia **Metrics** para ver uma representação do uso de energia.

### Seletor de métricas

Escolha as métricas para o gráfico. Para a criação de perfil de energia, use:

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

### Active Metrics

Habilite/desabilite as métricas selecionadas anteriormente e altere suas cores.

> [!TIP]
>
> Verifique se o gráfico agrega em **Average**. Selecione a métrica no canto inferior esquerdo do PIX e, no painel à direita, abra a guia **Graph** e confirme se a lista suspensa de agregação está definida como **Average**.

### Trabalhar com o gráfico

Destaque uma seção do gráfico para ampliar ou alinhar a linha do tempo. Ações úteis:

* **Zoom to Selected Range**: preenche a área do gráfico com o intervalo selecionado para uma exibição granular.
* **Zoom Timeline View to Selected Range**: alinha a linha do tempo do vídeo ao intervalo selecionado para que você possa ver em que parte do jogo os dados foram capturados.
* **Export Graphed Metrics**: exporta um CSV de cada ponto (valor + carimbo de data/hora). Abra no Excel e calcule médias com `=AVERAGE(...)`.

## Configuração do console da Certificação

Para cada título testado no laboratório de Certificação, o XBOX mantém a mesma configuração para obter resultados comparáveis entre títulos. A consistência entre as variáveis é o que torna significativas as comparações entre títulos.

A página [Linhas de base da plataforma em laboratório](https://docs.xbox.com/pt-BR/build/game-principles/sustainability/lab-platform-baselines.md) relata as médias capturadas com essa configuração.

## Próximas etapas

* [Guia de sustentabilidade do devkit](https://docs.xbox.com/pt-BR/build/game-principles/sustainability/sustainability-devkit-guide.md): leia a energia diretamente no devkit sem o PIX.
* [Visão geral de sustentabilidade para desenvolvedores](https://docs.xbox.com/pt-BR/build/game-principles/sustainability/sustainability-developer-overview.md): em quais métricas confiar e onde estão os ganhos.
* [Dynamic Power States](https://docs.xbox.com/pt-BR/build/game-principles/sustainability/dynamic-power-states.md): verifique o comportamento do DPS com o PIX.


## Related topics

- [Linhas de base da plataforma em laboratório para sustentabilidade em jogos](https://docs.xbox.com/pt-BR/build/game-principles/sustainability/lab-platform-baselines.md)
- [Estudos de caso de sustentabilidade em jogos: Minecraft](https://docs.xbox.com/pt-BR/build/game-principles/sustainability/case-studies/case-studies-minecraft.md)
- [Testes de certificação de sustentabilidade em jogos](https://docs.xbox.com/pt-BR/build/game-principles/sustainability/sustainability-case-studies.md)
- [Testes de sustentabilidade em jogos com seu devkit](https://docs.xbox.com/pt-BR/build/game-principles/sustainability/sustainability-devkit-guide.md)
- [Estudo de caso de sustentabilidade em jogos: Gears of War: Reloaded](https://docs.xbox.com/pt-BR/build/game-principles/sustainability/case-studies/case-studies-gears-of-war-reloaded.md)
