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

# Jogos

> Liste os jogos de um vendedor no Partner Center, consulte um jogo, crie um jogo e verifique o trabalho de criação dele.

Os comandos `game` listam os jogos de um vendedor no Partner Center, consultam um jogo pela ID da Store, pela ID de título do XBOX
ou pelo nome, criam um jogo e verificam o trabalho de criação dele.

Cada comando atua em um vendedor, de `--seller-id` ou do vendedor salvo; consulte
[Contexto](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/context.md). Se você pertencer a vários vendedores, consulte
[este problema conhecido](https://docs.xbox.com/pt-BR/tools/xbox-cli/known-issues.md#xbox-game-commands-ignore---seller-id): esses comandos podem
usar outro vendedor.

## Comandos

| Comando | Descrição |
| - | - |
| `game list` | Lista todos os jogos do vendedor. |
| `game get` | Obtém jogos pela ID da Store, pela ID de título do XBOX ou por uma palavra-chave do nome. |
| `game create` | Cria um jogo e aguarda o trabalho de criação dele. |
| `game job get` | Lê o estado atual de um trabalho de criação de jogo. |

## Argumentos

| Argumento | Comando | Descrição |
| - | - | - |
| `[title-id]` | `get` | Uma ID de título do XBOX: de um a oito dígitos hexadecimais, com um prefixo `0x` opcional, como `1234ABCD`. `42` significa `0x00000042`. |
| `<job-id>` | `job get` | A ID do trabalho de criação que `game create` imprime. |

## Opções

| Opção | Comandos | Descrição |
| - | - | - |
| `--seller-id <id>` | todos | ID do vendedor no Partner Center. |
| `--base-url <url>` | todos | URL base das solicitações, que substitui a chave de configuração `XboxPartner:BaseUrl`. |
| `--store-id <id>` | `get` | ID do jogo na Microsoft Store, como `9N0000000000`. Pode ser combinada com `title-id` para restringir o resultado. |
| `--keyword <text>` | `get` | Encontra jogos cujo nome contém este texto, sem diferenciar maiúsculas de minúsculas. Não pode ser combinada com `title-id` nem com `--store-id`. |
| `-d`, `--details` | `list`, `get` | Mostra um bloco de texto por jogo. Não pode ser combinada com `--output`. |
| `--name <name>` | `create` | Obrigatória. O nome do jogo. |
| `--supported-device <device>` | `create` | Obrigatória. `xbox` ou `desktop`; repita a opção para ambos. |
| `--sandbox-id <id>` | `create` | A sandbox de desenvolvimento do jogo. Deve ser uma sandbox Shared existente; [`sandbox get`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/sandbox) mostra o tipo de uma sandbox. |
| `--confirm`, `--yes`, `-y` | `create` | Cria o jogo sem a solicitação de confirmação. |
| `--output <format>` | todos | `json` (padrão) ou `json-compact`; `table` somente em `list` e `get`. |

`game get` precisa de pelo menos um entre `title-id`, `--store-id` ou `--keyword`. O valor posicional é
sempre uma ID de título do XBOX; quando ele parece uma ID da Store, o erro sugere o mesmo comando com
`--store-id`:

```text theme={null}
title-id must be one to eight hexadecimal digits, with an optional 0x prefix. 9N0000000000 looks like a Store ID. Did you mean:
  xbox game get --store-id 9N0000000000 --seller-id 1234567
```

## Listagem e consulta

```bash theme={null}
xbox game list --output table
xbox game get --store-id 9N0000000000
xbox game get 1234ABCD --details
xbox game get --keyword "nod arena" --output table
```

`game list` retorna o catálogo inteiro do vendedor, e `game get` com `--keyword` pesquisa todo
ele. A leitura de um catálogo grande pode levar alguns minutos, e o comando mostra seu
[progresso](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands.md#progress) em stderr. Não há opção de paginação; pagine a saída com
`less` ou `more`. Se uma solicitação falhar, o comando não imprime resultados parciais e grava a
ID de correlação em stderr. Cada solicitação atinge o tempo limite após dois minutos; para alterá-lo, defina
`XboxPartner:TimeoutSeconds` (consulte [Configuração](https://docs.xbox.com/pt-BR/tools/xbox-cli/configuration.md)).

## Saída

A saída JSON é uma matriz `games`. Cada jogo tem estes campos:

| Campo | Descrição |
| - | - |
| `productId` | A ID do produto no Partner Center. |
| `storeId` | A ID da Microsoft Store. |
| `xboxTitleId` | A ID de título do XBOX: oito dígitos hexadecimais em maiúsculas, sem `0x`, como `"1234ABCD"`. `null` quando o jogo não tem uma ID de título válida. |
| `SCID` | O identificador de configuração de serviço (SCID), como `"00000000-0000-0000-0000-00001234ABCD"`. A chave está em maiúsculas. `null` quando `xboxTitleId` é `null`. |
| `name` | O nome do jogo. |
| `primaryDevelopmentSandbox` | A sandbox de desenvolvimento do jogo ou `null`. |
| `deviceFamilies` | Os dispositivos compatíveis, como `["xbox", "desktop"]`. `null` ou `[]` quando nenhum está listado. |
| `packageIdentityName`, `packageIdentityPublisher`, `packageFamilyName` | A identidade do pacote do jogo. |
| `msaAppId` | A ID de aplicativo da conta Microsoft (MSA). |

`game create` e `game job get` gravam o trabalho de criação. O campo `game` dele, com os mesmos campos,
aparece assim que o jogo existe.

### Saída em tabela

`list` e `get` aceitam `--output table`, com uma linha por ID de título do XBOX e estas colunas:
`TITLE ID`, `STORE IDS`, `PRODUCT NAME`, `MSA APP ID` e `PACKAGE FAMILY NAME`. As IDs da Store
e os outros valores de um título compartilham a linha dele, e os valores longos são truncados. `create` e `job get`
recusam `--output table`.

### Exibição de detalhes

`--details` imprime um bloco por ID de título, com todos os jogos abaixo dela e todos os seus identificadores,
incluindo o SCID e a sandbox de desenvolvimento, sem truncar. Os valores ausentes aparecem como `-`. Com
`--details` ou `--output table`, a contagem de resultados e a duração vão para stderr.

## Criar um jogo

```bash theme={null}
xbox game create --name "Nod Arena" \
  --supported-device xbox --supported-device desktop \
  --sandbox-id TESTSB.42 --seller-id 1234567 --confirm
```

`game create` pergunta antes de criar o jogo; sem um terminal, ele precisa de `--confirm`. A CLI
não pode excluir um jogo. Se você pertencer a vários vendedores, verifique
[o problema conhecido](https://docs.xbox.com/pt-BR/tools/xbox-cli/known-issues.md#xbox-game-commands-ignore---seller-id) primeiro: o jogo pode ser
criado em outro vendedor.

O comando envia a solicitação uma única vez, aguarda até dois minutos pelo trabalho de criação e grava o
trabalho em stdout. A ID do trabalho, a ID de correlação e os comandos para verificar o trabalho vão para stderr. Se a
espera terminar primeiro, o trabalho continuará em execução: verifique-o com `game job get` e não crie o jogo
novamente.

Se a solicitação falhar, stderr informará se um jogo pode ter sido criado:

* **Nenhum jogo foi criado** quando a solicitação não foi enviada ou quando o serviço a recusou, por exemplo, com um
  `400` para uma sandbox que o jogo não pode usar. Corrija o problema e execute o comando novamente.
* **O resultado é desconhecido** após um erro do servidor, um tempo limite ou uma conexão perdida. Verifique
  `game list` com o comando impresso em stderr antes de tentar novamente.

## Verificar um trabalho de criação

```bash theme={null}
xbox game job get 11111111-2222-3333-4444-555555555555 --output json-compact
```

`job get` apenas lê; portanto, você pode executá-lo quantas vezes quiser. Um trabalho bem-sucedido ainda pode
relatar problemas no campo `errors`.

## Códigos de saída

| Código de saída | Significado |
| - | - |
| `0` | O trabalho foi bem-sucedido ou ainda está em execução. `create` também sai com `0` quando a espera termina; portanto, `0` não garante que o jogo exista. |
| `1` | O comando falhou. Para `create`, stderr informa se um jogo pode ter sido criado. |
| `2` | O trabalho terminou sem criar o jogo. Consulte o campo `errors` dele. |
| `130` | Você pressionou Ctrl+C enquanto o comando lia ou enquanto `create` aguardava uma resposta à solicitação. Para `create`, stderr informa que o resultado é desconhecido. |

Não decida se deve executar `create` novamente com base no código de saída. Se stderr informar que nenhum jogo foi
criado, corrija o erro e execute-o novamente; caso contrário, verifique com o comando `game job get` ou `game list`
que ele imprimiu.

## Exemplo completo

Salve um vendedor uma vez e, em seguida, crie um jogo, que o usará:

```bash theme={null}
xbox context set seller-id 1234567

xbox game create --name "Nod Arena" \
  --supported-device xbox --supported-device desktop \
  --sandbox-id TESTSB.42 --confirm
```

Se a espera terminar antes do trabalho, verifique o trabalho em vez de criar o jogo novamente. Use a ID do
trabalho que `game create` imprimiu em stderr:

```bash theme={null}
xbox game job get 11111111-2222-3333-4444-555555555555 --output json-compact
```

Depois que o trabalho for bem-sucedido, encontre o jogo:

```bash theme={null}
xbox game get --keyword "Nod Arena" --output table
```


## Related topics

- [Jogo salvo](https://docs.xbox.com/pt-BR/build/core-features/common/game-save/index.md)
- [Configuração do jogo](https://docs.xbox.com/pt-BR/publishing/game-publishing/concepts/game-setup-overview.md)
- [Certificar um jogo](https://docs.xbox.com/pt-BR/publishing/game-publishing/tutorial-xbox-managed/how-to-certify-a-game.md)
- [Jogos entre gerações](https://docs.xbox.com/pt-BR/build/console-features/cross-gen/cross-gen-overview.md)
- [Reparentalização de jogos](https://docs.xbox.com/pt-BR/publishing/game-publishing/concepts/reparenting.md)
