Instalação por streaming: status

Enquanto uma instalação está em andamento e um usuário está jogando, o título deve rastrear o conteúdo necessário para dar suporte à jogabilidade e verificar se o conteúdo exigido foi instalado. Um título pode usar APIs do sistema para consultar o status dos chunks no disco rígido e o progresso do conteúdo que está sendo baixado. Se o usuário tentar entrar em uma parte da jogabilidade que requer conteúdo ainda não instalado, o título deverá informar o usuário exibindo uma caixa de diálogo ou uma barra de progresso, e deverá comunicar o progresso da instalação. Além disso, o título deve sempre oferecer ao usuário a opção de sair da tela de progresso, idealmente para permitir que o usuário aproveite o conteúdo enquanto ele é instalado. Veja a seguir um exemplo. Ao jogar a campanha single-player de um título de tiro, o usuário chega ao ponto em que o conteúdo para dar suporte à próxima área da campanha ainda não está instalado. Uma boa experiência do usuário seria exibir uma barra de progresso que mostre o status da aquisição do conteúdo, juntamente com uma opção para participar de um jogo multiplayer. Essa opção seria habilitada incluindo um subconjunto do conteúdo multiplayer como parte dos dados necessários para iniciar o título. Um título pode monitorar e verificar a instalação e pode receber um alerta após a conclusão de uma instalação. Você pode monitorar a instalação de um pacote inteiro ou de um subconjunto de chunks do pacote. Para criar um monitor de instalação, use XPackageCreateInstallationMonitor. Especifique que o monitor se destina a um dos seguintes:

Um determinado conjunto de chunks, especificando seletores como parâmetros
O pacote inteiro, especificando zero seletores

Depois de criar o monitor de instalação, registre um manipulador para um dos seguintes:

O evento progresso da instalação alterado usando XPackageRegisterInstallationProgressChanged
O evento pacote instalado usando XPackageRegisterPackageInstalled

O evento pacote instalado indica quando todo o pacote terminou de ser instalado. O evento progresso alterado permite monitorar o progresso da instalação. Observe que o evento progresso alterado também indica quando a instalação foi concluída, portanto, não é necessário registrar um manipulador de pacote instalado se você já registrou um manipulador de progresso alterado. Veja a seguir um exemplo. Um jogo implementou um marcador de inicialização, para que possa ser executado antes de ser completamente instalado. O jogo precisará saber quais partes estão instaladas e quais não estão. Para apresentar as pistas disponíveis ao usuário, o jogo precisa saber quando os chunks associados a uma pista de corrida com um determinado nome de pista estão instalados.

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

Documentação de referência da API

XPackage (conteúdo da API)
- Funções

Porting

Build Paths

Documentação de referência da API

​Documentação de referência da API

Documentação de referência da API