​

XGameRuntimeInitializeWithOptions

​

Sintaxe

HRESULT XGameRuntimeInitializeWithOptions(
    _In_ const XGameRuntimeOptions* options
)  

​

Parâmetros

​

Valor retornado

​

Comentários

• Uma classe chamada “GameEngine” que recebe o caminho para os arquivos do jogo e inicia o jogo. É o mesmo mecanismo usado em runtime pelo “player” do mecanismo de jogo.
• Uma instância dela é armazenada como global no editor e representa o jogo atual.

void StartGame(const char* gamePath) 
{ 
    // If there is an existing game running, shut it down 
    if (g_game.IsRunning()) 
    { 
        g_game.Stop() 
    } 
 
    // Initialize the runtime in this process for this path 
    std::string gameConfig(gamePath); 
    gameConfig.append(“\\MicrosoftGame.config”); 
    XGameRuntimeOptions options{}; 
    options.gameConfigSource = XGameRuntimeGameConfigSource::File; 
    options.gameConfig = gameConfig.c_str(); 
    THROW_IF_FAILED(XGameRuntimeInitializeWithOptions(&options)); 
 
    // Now launch the game normally. 
    GameEngine game; 
    game.Launch(gamePath); 
    g_game = std::move(game); 
} 
 

// Examples of Launch / Stop behavior in GameEngine 
void GameEngine::Stop() 
{ 
    // Disconnect all globals from the runtime, closing handles and removing event 
    // handlers 

    // Handle game shut down before uninitializing the runtime

    XGameRuntimeUninitialize(); 
} 

void GameEngine::Launch(const char* gamePath) 
{ 
    // Standard XGameRuntimeInitialize here is fine to call – it will adopt the 
    // GameConfig settings from the earlier XGameRuntimeInitializeWithOptions call. 

    XGameRuntimeInitialize(); 
    RunGame(gamePath); 
}

• XGameRuntimeInitialize: se a DLL do runtime já tiver sido inicializada por outra chamada, essa API “adota” as opções de inicialização fornecidas na outra chamada. Se for a primeira vez que o runtime é inicializado, valores padrão serão usados para as opções de inicialização. Os jogos devem sempre inicializar o runtime usando essa API.
• XGameRuntimeInitializeWithOptions: todos os componentes que inicializam o runtime devem passar as mesmas opções se usarem esse método. Se o runtime tiver sido inicializado anteriormente com outro conjunto de opções, essa chamada falhará com E_GAMERUNTIME_OPTIONS_MISMATCH. Componentes de middleware, como um editor de jogos Unity, podem usar essa API para inicializar o runtime com um GameConfig personalizado antes de iniciar o jogo. O runtime pode ser reinicializado com opções diferentes se primeiro tiver sua inicialização totalmente cancelada. Isso exige que todos os módulos que chamaram um dos métodos XGameRuntimeInitialize* chamem XGameRuntimeUninitialize.

• Não descarregará a DLL do runtime, pois isso pode causar uma falha.
• Armazenará o erro para retorná-lo posteriormente em uma chamada futura para XGameRuntimeInitialize*
• Emitirá um XErrorReport.

​

Requisitos

​

Confira também