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

# Contexto

> Guarda valores predeterminados, como el vendedor y el título de PlayFab, para comandos posteriores, en perfiles con nombre si necesitas más de un conjunto.

`xbox context` guarda valores predeterminados para el vendedor, el título de PlayFab, el título de XBOX y el sandbox, para que
no tengas que pasarlos a cada comando. Esta página también describe de dónde obtiene un comando
estos valores cuando no los pasas. El contexto es local: estos comandos no cambian nada en
Partner Center ni en PlayFab.

## Comandos

| Comando | Descripción |
| - | - |
| `context get` | Muestra los valores guardados. |
| `context set` | Guarda un valor. |
| `context unset` | Quita valores guardados. |
| `context key list` | Enumera las claves que puedes guardar y los comandos que usan cada una. No requiere iniciar sesión. |
| `context profile list` | Enumera tus perfiles, empezando por `default`. |
| `context profile delete` | Elimina un perfil con nombre y todos los valores guardados en él. |

## Claves

Una clave es el nombre de la opción que rellena:

| Clave | Opción | Variable | Usada por |
| - | - | - | - |
| `playfab-title-id` | `--playfab-title-id` | `XBOX_PLAYFAB_TITLE_ID` | Comandos [`playfab`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab) |
| `sandbox-id` | `--sandbox-id` | `XBOX_SANDBOX_ID` | `config status` y `config publish` de [`xbl`](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl) |
| `seller-id` | `--seller-id` | `XBOX_SELLER_ID` | Comandos [`audience`](https://docs.xbox.com/es/tools/xbox-cli/commands/audience), [`game`](https://docs.xbox.com/es/tools/xbox-cli/commands/game), [`package`](https://docs.xbox.com/es/tools/xbox-cli/commands/package), [`playtest`](https://docs.xbox.com/es/tools/xbox-cli/commands/playtest), [`sandbox`](https://docs.xbox.com/es/tools/xbox-cli/commands/sandbox), [`test-account`](https://docs.xbox.com/es/tools/xbox-cli/commands/test-account) y [`xbl`](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl) |
| `title-id` | `--title-id` | `XBOX_TITLE_ID` | `config list`, `config status`, `config publish` de [`xbl`](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl#title-targeting), y `config download` y `config save` con ámbito de sandbox |

Ninguna otra opción acepta un valor guardado ni una variable.

`title-id` es un identificador de título de XBOX en hexadecimal, como `1234ABCD`, no un identificador de título de PlayFab. Los
comandos `xbl` lo usan para encontrar el identificador de configuración de servicio (SCID) del título, y lo ignoran
cuando pasas `--scid`. Consulta [Selección del título](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl.md#title-targeting).

## Cómo usan los comandos los valores guardados

Cuando un comando acepta una de estas opciones, usa el primer valor que encuentra:

1. La opción en la línea de comandos, como `--seller-id`.
2. La variable `XBOX_` de la opción, como `XBOX_SELLER_ID`. Una variable en blanco se considera no establecida.
3. El valor guardado con `context set` en el [perfil](#profiles) seleccionado.

```bash theme={null}
xbox context set playfab-title-id ABC123
xbox playfab title-data get                                # uses ABC123
XBOX_PLAYFAB_TITLE_ID=DEF456 xbox playfab title-data get   # uses DEF456
xbox --playfab-title-id GHI789 playfab title-data get      # uses GHI789
```

Un valor procedente de una variable o del contexto guardado se comprueba igual que uno escrito, y un error indica de dónde
procede, como `XBOX_SELLER_ID: --seller-id must be a positive numeric value.` Si nada
proporciona un valor que un comando necesita, el comando indica cómo establecerlo. Los comandos en los que el vendedor es
opcional, `xbl` y `test-account`, usan tu único vendedor autorizado.

Un comando que cambia algo escribe en stderr cada valor que rellenó, y su procedencia,
incluso con `--confirm`. Con `--verbose`, lo hacen todos los comandos:

```text theme={null}
Using --playfab-title-id ABC123 from saved context.
```

[Problemas conocidos](https://docs.xbox.com/es/tools/xbox-cli/known-issues.md) describe dos problemas que hacen que los comandos `game` y `sandbox`
usen un vendedor distinto del elegido de esta forma.

## Perfiles

Un perfil es un conjunto con nombre de valores guardados, como uno para un título de prueba y otro para producción.
Los comandos usan el perfil que indica `--profile`; si no, el que indica `XBOX_PROFILE`; y si no, `default`.

```bash theme={null}
xbox --profile test context set playfab-title-id TEST1   # creates "test"
xbox --profile test playfab title-data get               # uses TEST1
xbox playfab title-data get                              # uses the default profile
```

Para usar un perfil en todos los comandos de un shell, establece `XBOX_PROFILE`:

```bash theme={null}
export XBOX_PROFILE=test
```

Para enumerar tus perfiles:

```bash theme={null}
xbox context profile list
```

Para eliminar un perfil y todos los valores guardados en él:

```bash theme={null}
xbox context profile delete test
```

* Al guardar el primer valor en un perfil, este se crea. Los nombres constan de letras, dígitos y guiones, hasta
  64 caracteres, y no distinguen mayúsculas de minúsculas.

* Un perfil que no existe, como uno mal escrito, produce un error en lugar de recurrir a
  `default`.

* Un perfil no toma valores prestados de `default`.

* Las variables `XBOX_` siguen prevaleciendo sobre un perfil. Cuando una prevalece sobre el perfil que indica `--profile`,
  el comando lo dice, aunque no cambie nada:

  ```text theme={null}
  Using --playfab-title-id PROD1 from XBOX_PLAYFAB_TITLE_ID, not profile test.
  ```

* La CLI no recuerda un perfil entre comandos, por lo que elegir uno nunca cambia lo que
  usa otro terminal u otro agente.

## Dónde se guardan los valores

Los valores guardados están en `context.json`, en el directorio de estado de la CLI:

| SO | Directorio |
| - | - |
| Windows | `%LOCALAPPDATA%\XboxDevCLI` |
| macOS | `~/Library/Application Support/XboxDevCLI` |
| Linux | `$XDG_DATA_HOME/XboxDevCLI`, de forma predeterminada `~/.local/share/XboxDevCLI` |

Cada valor pertenece a la cuenta que lo guardó, por lo que otra cuenta no lo recoge.
`auth logout` conserva los valores guardados, y volver a iniciar sesión con la misma cuenta los restaura.

## Argumentos y opciones

| Argumento u opción | Comandos | Descripción |
| - | - | - |
| `<key> <value>` | `set` | La clave que se va a guardar y su valor. El valor debe ser válido para la opción de la clave: `seller-id` es un número positivo (consulta [`xbox seller list`](https://docs.xbox.com/es/tools/xbox-cli/commands/seller)), y `playfab-title-id` consta de letras y dígitos. |
| `<key>...` | `unset` | Claves que se van a quitar. Quitar una clave que no está guardada se completa correctamente. |
| `<name>` | `profile delete` | El perfil que se va a eliminar. `default` no se puede eliminar. |
| `--profile <name>` | Todos | Usa este perfil en lugar del de `XBOX_PROFILE` o de `default`. Es una [opción global](https://docs.xbox.com/es/tools/xbox-cli/commands.md). |
| `--all` | `unset` | Quita todos los valores guardados en el perfil seleccionado. No se puede combinar con nombres de clave. |
| `--base-url <url>` | `get`, `set`, `unset` | Invalida la opción de configuración `XboxPartner:BaseUrl`. Los valores de vendedor guardados pertenecen al punto de conexión para el que se guardaron. |
| `--output <format>` | Todos | `json` (predeterminado), `json-compact` o `table`. |

## Comportamiento

`get` devuelve la `account` con la sesión iniciada, el `profile` y una matriz `values` de `key` y `value`,
con `null` para una clave que no está guardada. Muestra lo que está guardado, no lo que usaría un comando; ejecuta
el comando con `--verbose` para verlo. Sin una sesión iniciada, `get` no muestra valores e indica cómo iniciar
sesión.

`set`, `unset` y los comandos `profile` necesitan una cuenta con la sesión iniciada. `set` no comprueba el
valor con el servicio, por lo que un vendedor que no puedes usar produce un error en el primer comando que lo envía.

Una entidad de servicio no tiene contexto guardado. En un modo de entidad de servicio, los comandos que inician sesión
rechazan `--profile` y `XBOX_PROFILE`, y todos los comandos `context` excepto `key list` producen un error. En su lugar, pasa
cada valor con su opción o su variable `XBOX_`. Consulta
[Autenticación de automatización (entidad de servicio)](https://docs.xbox.com/es/tools/xbox-cli/authentication.md#automation-service-principal-authentication).

## Valores que no proceden de la línea de comandos

Todos los terminales y agentes que ejecuta tu usuario del SO comparten el contexto guardado, y las variables de entorno
no aparecen en la línea de comandos. Por eso, además de indicar cada valor que rellenó:

* Una operación cuyo destino es el propio valor del contexto debe tenerlo en la línea de comandos.
  `/Admin/DeleteTitle` elimina el título, y `playfab api-policy set --overwrite` reemplaza toda su
  directiva de acceso a la API, por lo que ambos rechazan un título procedente del contexto guardado o de una variable, e imprimen
  el comando que se debe ejecutar en su lugar:

  ```text theme={null}
  $ xbox playfab api /Admin/DeleteTitle --confirm
  Using --playfab-title-id ABC123 from saved context.
  '/Admin/DeleteTitle' acts on playfab-title-id ABC123, which comes from saved context.
  The target of a destructive operation must be named on the command line. To proceed, run:
    xbox --playfab-title-id ABC123 playfab api /Admin/DeleteTitle --confirm
  ```

  El comando impreso omite un valor insertado de `--body` o `--statements`, porque el cuerpo de una solicitud
  puede contener secretos. Vuelve a colocar el valor en lugar de `<body>` o `<statements>`.

* Si otra cuenta inicia sesión mientras se ejecuta un comando que usa valores guardados, por ejemplo mientras
  espera la confirmación, el comando se detiene antes de enviar nada. Vuelve a ejecutarlo.

Consulta [Seguridad y operaciones destructivas](https://docs.xbox.com/es/tools/xbox-cli/safety.md) para conocer las reglas de confirmación.

## Salida de tabla

Todos los comandos de contexto aceptan `--output table`:

| Comando | Columnas |
| - | - |
| `context get`, `set`, `unset` | `KEY`, `VALUE` |
| `context key list` | `KEY`, `USED BY` |
| `context profile list`, `profile delete` | `NAME` |

## Ejemplos

Enumera las claves que puedes guardar:

```bash theme={null}
xbox context key list --output table
```

Guarda un vendedor y un título de PlayFab, y comprueba lo que está guardado:

```bash theme={null}
xbox context set seller-id 1234567
xbox context set playfab-title-id ABC123
xbox context get --output table
```

Ejecuta comandos que usan los valores guardados y comprueba de dónde procede el título:

```bash theme={null}
xbox game list
xbox --verbose playfab title-data get
```

Quita un valor guardado:

```bash theme={null}
xbox context unset playfab-title-id
```

Quita todos los valores guardados en el perfil seleccionado:

```bash theme={null}
xbox context unset --all
```

Consulta [Configuración](https://docs.xbox.com/es/tools/xbox-cli/configuration.md) para conocer las opciones de configuración, que el contexto no cambia.


## Related topics

- [Juego de creación de objetos: contexto](https://docs.xbox.com/es/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/game-context.md)
- [Modelos de contexto de CloudScript de PlayFab con Azure Functions](https://docs.xbox.com/es/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/CloudScript-af-context.md)
- [Guía de operaciones asincrónicas del SDK de C++ de Lobby y Matchmaking](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-async.md)
- [Manipulación de audio en tiempo real](https://docs.xbox.com/es/services/xbox-services/multiplayer/chat/game-chat2/real-time-audio-manipulation.md)
- [Directriz de accesibilidad de XBOX 114](https://docs.xbox.com/es/build/game-principles/accessibility/xag-deep-dives/xag-114-ui-context.md)
