xbox upgrade te indica si
hay una más reciente disponible. Una entrada marcada como Corregido está corregida en la versión más reciente y
se quitará en la siguiente.
Si tu problema no aparece en la lista
- Comprueba que ejecutas la versión más reciente con
xbox upgrade. - Busca en los problemas existentes.
- Si no se ha notificado, notifícalo con
xbox feedback, que abre un informe de errores con los detalles de tu entorno ya rellenados. Los problemas son públicos, así que no incluyas nada que no compartirías públicamente.
Actualización de la CLI
xbox upgrade falla con HTTP 301
Corregido
El repositorio público de la CLI se ha movido, y xbox upgrade en la v0.2.1 falla
siempre con HTTP 301: GitHub release metadata is unavailable.
Solución alternativa: descarga la versión más reciente siguiendo Instalación.
Inicio de sesión y permisos
Algunos comandos todavía no funcionan con una cuenta Microsoft personal
Cuando inicias sesión con una cuenta Microsoft personal en lugar de una cuenta profesional o educativa, los comandos de configuración de los servicios XBOX, cuentas de prueba, paquetes, playtests y audiencias no funcionan. Los comandos de configuración de los servicios XBOX y de cuentas de prueba fallan con HTTP 502, que se notifica como que el servicio no está disponible, pero volver a intentarlo no sirve de nada. Solución alternativa: únete a tu vendedor en Partner Center con una cuenta profesional o educativa e inicia sesión en la CLI con esa cuenta.xbox game, xbox xbl y comandos similares todavía no aceptan entidades de servicio
Una entidad de servicio puede iniciar sesión, pero los comandos audience, game, package, playtest, sandbox,
seller, test-account y xbl fallan con un error de autorización cuando ella los ejecuta,
porque el servicio al que llaman todavía no acepta entidades de servicio.
Solución alternativa: ejecuta esos comandos como un usuario que haya iniciado sesión. Los comandos xbox playfab funcionan con una
entidad de servicio una vez que una persona le concede acceso con
xbox playfab service-principal set. Consulta
Autenticación para automatización (entidad de servicio).
Se deniegan comandos para algunos vendedores cuando perteneces a más de uno
Si perteneces a más de un vendedor de Partner Center, los comandos de configuración de los servicios XBOX, cuentas de prueba, paquetes, playtests y audiencias pueden denegarse para todos los vendedores excepto el último que seleccionaste en Partner Center. Solución alternativa: selecciona el vendedor que quieras en Partner Center y vuelve a ejecutar el comando.xbox seller list a veces omite uno de tus vendedores
Si perteneces a más de un vendedor de Partner Center, xbox seller list
a veces omite uno de ellos sin mostrar ningún error, y la siguiente ejecución puede incluirlo. Mientras
falta, los comandos para ese vendedor, como xbox audience list, pueden
denegarse, y no se sabe que seleccionarlo en Partner Center sirva de ayuda.
Los comandos xbox game omiten --seller-id
xbox game list, xbox game get y xbox game create usan el vendedor que
seleccionaste por última vez en Partner Center, no el que pasas con --seller-id o guardas en el
contexto, por lo que game create puede crear el juego en otro vendedor. Un
id. de vendedor que no es tuyo, como uno mal escrito, no hace que fallen; devuelven tus
propios juegos.
Solución alternativa: selecciona el vendedor que quieras en Partner Center y comprueba que xbox game list
muestra sus juegos antes de crear uno. El cambio puede tardar hasta 15 minutos en llegar a la CLI.
Los comandos xbox sandbox solo muestran sandboxes globales
Cuando el vendedor que pasas con --seller-id o guardas en el contexto no es el
último que seleccionaste en Partner Center,
xbox sandbox list y xbox sandbox get solo encuentran los sandboxes CERT,
CERT.DEBUG y RETAIL, sin fallar. xbox sandbox create crea el
sandbox en el último vendedor que seleccionaste y, si es otro vendedor, sale con 4 porque
no puede volver a leer el sandbox. No vuelvas a crearlo.
Solución alternativa: selecciona el vendedor que quieras en Partner Center y vuelve a ejecutar el comando con
ese vendedor. El cambio puede tardar hasta 15 minutos en llegar a la CLI.
Pruebas con playtests y audiencias
xbox audience list puede agotar el tiempo de espera
xbox audience list puede tardar tanto que la solicitud agote el
tiempo de espera. --name no ayuda, porque filtra la lista después de leer todas las audiencias.
Configuración de los servicios XBOX
Algunos documentos XML descargados declaran una codificación incorrecta
Algunos documentos XML publicados que guardaxbox xbl config download --view published, como
mpsdtitleinfo.xml y titlename-localization.xml, declaran encoding="utf-16" pero están
codificados como UTF-8, por lo que un lector de XML que confíe en la declaración no puede cargarlos.
Solución alternativa: descodifica el archivo como UTF-8 antes de analizarlo.
PlayFab
xbox playfab api /Admin/UpdatePolicy puede sobrescribir la directiva sin confirmación
Con "OverwritePolicy": true en el cuerpo de la solicitud, esta llamada reemplaza toda la directiva de acceso
a la API del título sin las protecciones de xbox playfab api-policy set --overwrite: no
requiere --confirm y puede usar el título del contexto guardado o de XBOX_PLAYFAB_TITLE_ID.
Una directiva incorrecta puede impedir el acceso al título a todos los jugadores.
Solución alternativa: usa xbox playfab api-policy set --overwrite
en su lugar, que requiere --confirm y que el título se pase con --playfab-title-id.
playfab title-data delete y playfab player-data delete no preguntan primero
Otros comandos que eliminan algo preguntan antes de ejecutarse, o se niegan a ejecutarse sin --confirm. Estos
dos eliminan inmediatamente las claves que indicas.
--keys y --member-ids aceptan listas separadas por comas
--keys en xbox playfab title-data y xbox playfab player-data, y --member-ids en
xbox playfab group member, aceptan listas separadas por comas. Se
cambiarán a opciones repetidas, por lo que habrá que actualizar los scripts que los usan.
Hasta entonces, --keys no puede indicar una clave que contenga una coma. Para leer una, pásala con
--key, que acepta el nombre completo, pero delete solo tiene --keys.
Solución alternativa: para eliminar la clave, llama a la API que usa delete con
xbox playfab api. Para los datos de título, establece el valor de la clave en null,
con /Admin/SetTitleInternalData en su lugar para los datos de título internos:
KeysToRemove, usando la API de actualización correspondiente a la
visibilidad de los datos que se indica en Datos de jugadores:
Scripts y agentes
La mayoría de los comandos salen con 1 cuando se desconoce si un cambio se aplicó
Algunos comandos salen con3 cuando no pueden determinar si se realizó un cambio, por ejemplo, cuando la
solicitud agota el tiempo de espera después de enviarse, y sus páginas lo indican. Todos los demás comandos, incluidos
todos los comandos de PlayFab, salen con 1 para cualquier error, por lo que un script no puede distinguir este caso de un
cambio que no se realizó.
Solución alternativa: cuando falle un comando que cambia algo, comprueba el estado actual antes de
volver a ejecutarlo.