Instalación por streaming: estado

Mientras una instalación está en curso y un usuario está jugando, el título debe hacer un seguimiento del contenido necesario para admitir el juego y comprobar si el contenido requerido se ha instalado. Un título puede usar las API del sistema para consultar el estado de los fragmentos (chunks) en el disco duro y el progreso del contenido que se está descargando. Si el usuario intenta entrar en una parte del juego que requiere contenido aún no instalado, el título debe informarle mostrando un cuadro de diálogo o una barra de progreso, y debe comunicar el progreso de la instalación. Además, el título siempre debe ofrecer al usuario la opción de salir de la pantalla de progreso; idealmente, para permitirle disfrutar de contenido mientras se instala. A continuación se muestra un ejemplo. Mientras juega la campaña para un jugador de un título de disparos, el usuario llega al punto en el que el contenido para la siguiente área de la campaña aún no está instalado. Una buena experiencia de usuario sería mostrar una barra de progreso con el estado de la adquisición de contenido junto con la opción de unirse a una partida multijugador. Esta opción se habilitaría incluyendo un subconjunto del contenido multijugador como parte de los datos necesarios para iniciar el título. Un título puede supervisar y verificar la instalación, y puede recibir una alerta cuando finalice una instalación. Puedes supervisar la instalación de un paquete completo o de un subconjunto de fragmentos del paquete. Para crear un monitor de instalación, usa XPackageCreateInstallationMonitor. Especifica que el monitor es para una de las siguientes opciones:

Un conjunto determinado de fragmentos, especificando selectores como parámetros
El paquete completo, especificando cero selectores

Después de crear el monitor de instalación, registra un controlador para uno de los siguientes eventos:

El evento de cambio de progreso de la instalación, mediante XPackageRegisterInstallationProgressChanged
El evento de paquete instalado, mediante XPackageRegisterPackageInstalled

El evento de paquete instalado indica cuándo ha terminado de instalarse el paquete completo. El evento de cambio de progreso te permite supervisar el progreso de la instalación. Ten en cuenta que el evento de cambio de progreso también indica cuándo se ha completado la instalación, por lo que no es necesario registrar un controlador de paquete instalado si ya has registrado un controlador de cambio de progreso. A continuación se muestra un ejemplo. Un juego ha implementado un marcador de inicio, por lo que puede ejecutarse antes de estar completamente instalado. El juego necesitará saber qué partes están instaladas y cuáles no. Para presentar al usuario los circuitos disponibles, el juego necesita saber cuándo están instalados los fragmentos asociados a un circuito de carreras con un nombre de circuito concreto.

class GameTrackMonitor 
{ 
public: 
 
    HRESULT StartMonitoring(XTaskQueueHandle queue, const char* trackName) 
    { 
        char id[PACKAGE_IDENTIFIER_MAX_LENGTH]; 
 
        XPackageChunkSelector selector; 
        selector.type = XPackageChunkSelectorType::Tag; 
        selector.tag = trackName; 
 
        RETURN_IF_FAILED(XPackageGetCurrentProcessPackageIdentifier(_countof(id), id)); 
 
        XPackageInstallationMonitorHandle monitor; 
 
        RETURN_IF_FAILED(XPackageCreateInstallationMonitor( 
            id,         // Identity to monitor. 
            1,          // Number of selectors. 
            &selector,  // Selectors. 
            1000,       // Resolution of monitor in ms. 
            queue,      // Queue where updates are performed. 
            &monitor)); 
 
        XTaskQueueRegistrationToken token; 
 
        HRESULT hr = XPackageRegisterInstallationProgressChanged( 
            monitor, 
            this, 
            [](void *context, XPackageInstallationMonitorHandle monitor) 
        { 
            GameTrackMonitor* pthis = static_cast<GameTrackMonitor*>(context); 
            XPackageInstallationProgress progress; 
 
            XPackageGetInstallationProgress(monitor, &progress); 
            pthis->DrawProgress(progress); 
            if (progress.completed) 
            { 
                pthis->TrackReady(); 
                XPackageCloseInstallationMonitorHandle(monitor); 
            } 
        }, &token); 
 
        if (FAILED(hr)) 
        { 
            XPackageCloseInstallationMonitorHandle(monitor); 
        } 
 
        return hr; 
    } 
 
private: 
 
    void DrawProgress(const XPackageInstallationProgress& progress) 
    { 
        // ... 
    } 
 
    void TrackReady() 
    { 
        // ... 
    } 
};

Documentación de referencia de la API

XPackage (contenido de la API)
- Funciones

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

Documentación de referencia de la API

​Documentación de referencia de la API

Documentación de referencia de la API