Reordenação dinâmica de chunks

Quando a instalação de um título começa, o sistema de instalação adquire e copia chunks, coleções de arquivos a serem instalados como um grupo, de acordo com a ordem padrão definida por você. Depois que os chunks necessários para a execução do título forem instalados, o título poderá fornecer uma ordem personalizada para a instalação dos chunks restantes, que será processada pelo sistema de instalação antes de ele retornar à ordem de instalação padrão. Dessa forma, os títulos podem controlar a ordem de aquisição do conteúdo em resposta a várias situações diferentes ou tipos de entrada dos usuários. Essa reordenação dinâmica pode minimizar o tempo que os usuários passam esperando a instalação do conteúdo e lhes oferece a opção de escolher o que desejam ter disponível primeiro. Depois que a ordem de instalação for alterada, se os chunks forem necessários para a jogabilidade ou para o uso do título, ele poderá monitorar o status da instalação usando um dos métodos descritos em Instalação por streaming: status.

Como alterar a ordem em que os chunks são instalados

No código de exemplo a seguir, um jogo precisa acessar um arquivo em breve para permitir que o usuário continue jogando. A função PrioritizeChunk é definida e verifica o status atual de instalação de um chunk.

Se o chunk ainda não estiver instalado, a função solicita que o sistema de streaming instale esse chunk primeiro e, em seguida, retorna um monitor de instalação do progresso do chunk.
Se o chunk já estiver instalado, a função retorna um monitor nulo.

template<> 
struct std::default_delete<XPackageInstallationMonitorHandle> { 
    typedef XPackageInstallationMonitorHandle pointer; 
    void operator()(XPackageInstallationMonitorHandle handle) const noexcept  
    {   
        XPackageCloseInstallationMonitorHandle(handle);  
    } 
}; 
 
HRESULT PrioritizeChunk(uint32_t chunkId, XPackageInstallationMonitorHandle* monitor) 
{ 
    char id[PACKAGE_IDENTIFIER_MAX_LENGTH]; 
 
    *monitor = nullptr; 
    RETURN_IF_FAILED(XPackageGetCurrentProcessPackageIdentifier(_countof(id), id)); 
 
    XPackageChunkSelector selector; 
    selector.type = XPackageChunkSelectorType::Chunk; 
    selector.chunk = chunkId; 
 
    XPackageInstallationMonitorHandle temp; 
    RETURN_IF_FAILED(XPackageCreateInstallationMonitor(id, 1, &selector, 1000, queue, &temp)); 
    std::unique_ptr<XPackageInstallationMonitorHandle> localMonitor(temp); 
 
    XPackageInstallationProgress progress; 
    XPackageGetInstallationProgress(localMonitor.get(), &progress); 
 
    if (!progress.completed) 
    { 
        RETURN_IF_FAILED(XPackageChangeChunkInstallOrder(id, 1, &selector)); 
        *monitor = localMonitor.release(); 
    } 
 
    return S_OK; 
} 

Porting

Build Paths

Como alterar a ordem em que os chunks são instalados

​Como alterar a ordem em que os chunks são instalados

Como alterar a ordem em que os chunks são instalados