Installation en streaming : état

Pendant qu’une installation est en cours et qu’un utilisateur joue, le titre doit suivre le contenu nécessaire au jeu et vérifier si le contenu requis a été installé. Un titre peut utiliser des API système pour interroger l’état des blocs sur le disque dur et la progression du contenu en cours de téléchargement. Si l’utilisateur tente d’accéder à une partie du jeu qui requiert du contenu qui n’est pas encore installé, le titre doit l’en informer en affichant une boîte de dialogue ou une barre de progression, et il doit communiquer la progression de l’installation. De plus, le titre doit toujours offrir à l’utilisateur la possibilité de quitter l’écran de progression, idéalement pour lui permettre de profiter du contenu pendant son installation. Voici un exemple. En jouant à la campagne solo d’un jeu de tir, l’utilisateur arrive au point où le contenu nécessaire à la prochaine zone de la campagne n’est pas encore installé. Une bonne expérience utilisateur consisterait à afficher une barre de progression indiquant l’état de l’acquisition du contenu, accompagnée d’une option permettant de rejoindre une partie multijoueur. Cette option serait rendue possible en incluant un sous-ensemble du contenu multijoueur dans les données requises pour lancer le titre. Un titre peut surveiller et vérifier l’installation, et il peut recevoir une alerte à la fin d’une installation. Vous pouvez surveiller l’installation d’un paquet entier ou d’un sous-ensemble de blocs du paquet. Pour créer un moniteur d’installation, utilisez XPackageCreateInstallationMonitor. Indiquez que le moniteur vise l’un des éléments suivants :

Un ensemble précis de blocs, en spécifiant des sélecteurs comme paramètres
Le paquet entier, en spécifiant zéro sélecteur

Après avoir créé le moniteur d’installation, inscrivez un gestionnaire pour l’un des événements suivants :

L’événement progression de l’installation modifiée, à l’aide de XPackageRegisterInstallationProgressChanged
L’événement paquet installé, à l’aide de XPackageRegisterPackageInstalled

L’événement paquet installé indique le moment où l’installation du paquet entier est terminée. L’événement progression modifiée vous permet de surveiller la progression de l’installation. Notez que l’événement progression modifiée indique également le moment où l’installation est terminée; il n’est donc pas nécessaire d’inscrire un gestionnaire paquet installé si vous avez déjà inscrit un gestionnaire progression modifiée. Voici un exemple. Un jeu a implémenté un marqueur de lancement; il peut donc être exécuté avant d’être complètement installé. Le jeu devra savoir quelles parties sont installées et lesquelles ne le sont pas. Pour présenter les circuits disponibles à l’utilisateur, le jeu doit savoir à quel moment sont installés les blocs associés à un circuit de course portant un nom de circuit donné.

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() 
    { 
        // ... 
    } 
};

Documentation de référence des API

XPackage (contenu de l’API)
- Fonctions

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Documentation de référence des API

​Documentation de référence des API

Documentation de référence des API