​

XGameRuntimeInitializeWithOptions

​

Sintaxis

HRESULT XGameRuntimeInitializeWithOptions(
    _In_ const XGameRuntimeOptions* options
)  

​

Parámetros

​

Valor devuelto

​

Comentarios

• Una clase denominada “GameEngine” que toma la ruta de acceso a los archivos del juego e inicia el juego. Este es el mismo motor que usa en tiempo de ejecución el “reproductor” del motor de juego.
• Una instancia de esta clase se almacena como variable global en el editor y representa el juego actual.

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: si el archivo DLL del entorno de ejecución ya se inicializó mediante otra llamada, esta API “adopta” las opciones de inicialización que se proporcionaron en la otra llamada. Si es la primera vez que se inicializa el entorno de ejecución, se usarán los valores predeterminados para las opciones de inicialización. Los juegos siempre deben inicializar el entorno de ejecución mediante esta API.
• XGameRuntimeInitializeWithOptions: todos los componentes que inicialicen el entorno de ejecución deben pasar las mismas opciones si usan este método. Si el entorno de ejecución se inicializó previamente con otro conjunto de opciones, esta llamada fallará con E_GAMERUNTIME_OPTIONS_MISMATCH. Los componentes de middleware, como un editor de juegos de Unity, pueden usar esta API para inicializar el entorno de ejecución con un GameConfig personalizado antes de iniciar el juego. El entorno de ejecución se puede volver a inicializar con opciones diferentes si primero se anula por completo su inicialización. Esto requiere que todos los módulos que llamaron a uno de los métodos XGameRuntimeInitialize* llamen a XGameRuntimeUninitialize.

• No descargará el archivo DLL del entorno de ejecución, ya que esto puede provocar un bloqueo.
• Almacenará el error para devolverlo más adelante en una futura llamada a XGameRuntimeInitialize*.
• Se emitirá un XErrorReport.

​

Requisitos

​

Consulte también