Introducción
Las Game Saves permiten a los usuarios moverse sin problemas entre dispositivos, ya que mantienen su progreso disponible cada vez que inician sesión. El sistema guarda los datos localmente y, a continuación, los sincroniza con la nube cuando el dispositivo se conecta a Internet. Una vez completada la sincronización, los usuarios pueden acceder a sus datos guardados en cualquier dispositivo compatible.XBOX Play Anywhere y Game Saves
XBOX Play Anywhere usa Game Saves para permitir que los usuarios compartan la progresión del juego sin problemas entre dispositivos Windows, consolas XBOX, PC y dispositivos portátiles. XBOX Play Anywhere se basa en una sincronización coherente de los datos de guardado. Los usuarios pueden retomar la partida donde la dejaron en cualquier dispositivo compatible. Para obtener más información, consulte XBOX Play Anywhere.Ciclo de vida de desarrollo de Game Saves
El artículo sobre el ciclo de vida de desarrollo de Game Saves le ofrece una ruta estructurada para compilar, validar y mantener sistemas de guardado conectados a la nube confiables. Le guía a través de cómo introducir Game Saves en un título nuevo y continúa con la depuración, las pruebas, la certificación y el soporte técnico posterior a la publicación. Cada etapa destaca los requisitos, las herramientas y los procedimientos recomendados que necesita para garantizar que el título guarde los datos de forma coherente, los sincronice de forma segura y ofrezca una experiencia de usuario fluida en todos los dispositivos. Este ciclo de vida ayuda a que la implementación de Game Saves se comporte de forma predecible desde el primer prototipo hasta la publicación y más allá. El artículo del ciclo de vida describe el flujo de un extremo a otro cuando planifica, implementa, valida, publica y mantiene Game Saves. Este ciclo de vida se describe como sigue.- Introducción a Game Saves: incorporación inicial con los conceptos, las API, los modelos de almacenamiento y los requisitos de plataforma de Game Saves.
- Configuración de un título nuevo: integre Game Saves al principio del desarrollo. Por ejemplo:
- Agregue la inicialización dependiente del inicio de sesión del usuario.
- Configure identificadores como el identificador de configuración de servicio (SCID) y el App ID de cuenta Microsoft (MSA) (MSAAppID).
- Establezca el diseño de almacenamiento y la estructura de contenedores.
- Depuración de problemas durante el desarrollo: solucione problemas iniciales de la implementación. Podría encontrar los siguientes problemas:
- Problemas de configuración del SCID
- Problemas de duración de los identificadores
- Problemas de cuota o memoria
- Interpretación de errores NTSTATUS
- Planificación de pruebas: defina planes de prueba estructurados. Por ejemplo, pruebe las siguientes áreas:
- Corrección de lectura y escritura de datos
- Comportamiento sin conexión
- Lógica de sincronización
- Flujos de los cuadros de diálogo del sistema
- Escenarios con varios dispositivos
- Escenarios de prueba: realice pruebas funcionales y de esfuerzo detalladas. Por ejemplo, pruebe cómo se comporta el título en las siguientes situaciones.
- Cambios de conectividad
- Estados de conflicto
- Cambio de usuario
- Control de daños en los datos
- Casos límite de límites de almacenamiento
- Preparación del título para su publicación: finalice la configuración de Game Saves antes de publicar. Este trabajo suele incluir las siguientes tareas:
- Validar la configuración de Microsoft Partner Center
- Confirmar que el título usa las cuotas correctas
- Asegurarse de que los cuadros de diálogo del sistema funcionan según lo esperado
- Verificar que el título usa patrones de escritura segura
- Requisitos de certificación: cumpla los requisitos de certificación de XBOX. Esto incluye, por ejemplo:
- Comportamiento de sincronización adecuado.
- Administración de los cambios de conectividad.
- Cumplimiento de las reglas sobre datos de usuario e información de identificación personal (PII).
- Administración de problemas después de la publicación: supervise y resuelva los problemas del sitio activo. Podría encontrar situaciones como:
- Errores de sincronización.
- Informes de pérdida de datos de usuario.
- Problemas de límites de almacenamiento.
- Escenarios de migración: los escenarios incluyen los siguientes elementos:
- Actualización del diseño de almacenamiento
- Cambio entre API de Game Saves
- Transición entre versiones del título
Conjunto de documentación de Game Saves
Este conjunto de documentación le ayuda a entender e implementar el ecosistema completo de Game Saves. Este conjunto explica cómo funcionan las API, cómo los modelos de usuario y la administración de la vida útil del proceso (PLM) dan forma al flujo de los datos de guardado, y cómo los sistemas de almacenamiento, las cuotas y el comportamiento sin conexión afectan al diseño. También proporciona orientación para las pruebas y la depuración, describe los cuadros de diálogo del sistema que los usuarios pueden encontrar y detalla los requisitos de certificación que debe cumplir antes de publicar.Guía para desarrolladores de Game Saves
Este artículo proporciona una visión general del ecosistema de Game Saves y las consideraciones clave para desarrolladores, como las API disponibles, los modelos de usuario, PLM, la orientación sobre seguridad y PII, los requisitos de certificación y los detalles sobre los límites de almacenamiento.- Información general
- Títulos nuevos
- API de Game Saves
- Modelos de usuario
- Seguridad
- Requisitos de certificación
Descripción del flujo de sincronización de Game Saves
Este artículo explica la atomicidad en el nivel de contenedor o carpeta y un flujo de sincronización de seis pasos, además del comportamiento del modo sin conexión y el uso del proveedor solo de máquina.- Inicio del título
- Comprobación de conexión
- Comprobación de propiedad de los datos
- Sincronización de datos con la nube
- Bucle de juego
- Fin de la sesión
- Pérdida de conexión y escenarios de bloqueo
- Pérdida de energía
Sistemas de almacenamiento de Game Saves
Este artículo describe los distintos contextos de almacenamiento. Cubre el almacenamiento del título (nube), el almacenamiento de guardado local y el almacenamiento del proveedor de máquina, junto con las cuotas por título y los detalles del almacenamiento local específicos de la consola.- Sistemas de almacenamiento de Game Saves
- Límites y cuotas
- Almacenamiento local específico de la consola
Cuadros de diálogo del sistema de Game Saves
Este artículo describe los cuadros de diálogo del sistema que los usuarios pueden encontrar cuando realizan operaciones de Game Saves.Tutoriales y ejemplos de Game Saves
Este artículo describe cómo configurar Partner Center y cómo usar patrones de escritura segura, como escribir en un archivo temporal y reemplazarlo de forma atómica. También describe cómo administrar los escenarios sin conexión y fuera de la red, y cómo usar los flujos de los cuadros de diálogo del sistema. Además, explica cómo administrar los datos de Game Saves en los dispositivos en uso, probar el comportamiento de sincronización en la nube y migrar entre títulos o API.- Configuraciones de Partner Center
- Escenarios de desarrollo
- Escenarios de prueba
- Escenarios de migración
- Ejemplos de código
Depuración de Game Saves
Este artículo explica los errores comunes de Game Save y los pasos para solucionarlos, incluidos los problemas de SCID, los procedimientos recomendados sobre la duración de los identificadores, las limitaciones de cuota y memoria, y cómo interpretar los códigosNTSTATUS de Win32.
Herramientas de Game Saves
El artículo explica cómo usar Fiddler para inspeccionar el tráfico de red de Game Saves. También muestra cómo usar las herramientas de línea de comandosxbstorage y gamesaveutil para exportar o importar datos de guardado locales en la consola y en PC.
Información general de la API XGameSaveFiles
Este artículo describe el flujo de inicialización deXGameSaveFilesGetFolderWithUIAsync, la semántica recomendada de sincronización automática en la nube de Win32, la orientación sobre cuotas y depuración, los procedimientos recomendados de rendimiento y preguntas frecuentes.