Inicializando o GDK

Para começar a usar o Steamworks depois de adicioná-lo ao projeto do seu jogo, você precisa chamar a função SteamAPI_Init para inicializar a API. Opcionalmente, você pode chamar SteamAPI_RestartAppIfNecessary para reiniciar o aplicativo pelo Steam, se necessário. Inicializar o XBOX Game Development Kit (GDK) é um pouco mais complexo, pois não há um aplicativo unificado usado para iniciar o jogo e se comunicar com os diferentes serviços de jogos, como acontece no Steam. Para começar a usar as APIs do XBOX Game Development Kit (GDK), você precisa seguir as etapas abaixo.

Adicione um arquivo MicrosoftGame.config ao seu projeto.
Inicialize o serviço Gaming Runtime.
Inicialize a XBOX Services API para fazer chamadas ao XBOX Live para identidade do usuário, salvamentos na nuvem, conquistas e muito mais.
Conecte o usuário ao XBOX Live. Armazene o identificador e a ID de usuário do XBOX (XUID) retornados após uma entrada bem-sucedida para uso futuro.

No Steam, você tem acesso à Steam ID do usuário e a todas as APIs no momento do carregamento, pois o inicializador do Steam injeta automaticamente as informações da conta do usuário quando os jogos são iniciados a partir do serviço. As APIs do XBOX Live são usadas por jogos em vários inicializadores, portanto você não obtém isso automaticamente. Você precisa conectar o usuário manualmente na inicialização.

Para obter informações sobre como realizar a etapa 1, confira Visão geral do MicrosoftGame.config. Você pode encontrar informações sobre como realizar as etapas 2 a 4 em Introdução às APIs do XBOX Live (ou resumidas a seguir), certificando-se de implementar também o comportamento descrito na seção Limpando o XSAPI desse tópico. Depois que o Gaming Runtime e a XBOX Services API forem inicializados, você poderá conectar o usuário ao XBOX Live. Você não precisa criar uma XTaskQueue, pois ela é criada automaticamente se você a deixar em branco.

#include <XGameRuntimeInit.h>
#include <XTaskQueue.h>
#include <xsapi-c/services_c.h>

// ...

void InitializeXboxLive()
{
    // ...
    HRESULT hr = XGameRuntimeInitialize();
    if (FAILED(hr))
    {
        // handle error: couldn't initialize the Gaming Runtime service.
    }

    XblInitArgs xblArgs = {};
    xblArgs.scid = "00000000-0000-0000-0000-000000000000"; // Add your SCID here that you got from the Partner Center web portal.

    HRESULT hr = XblInitialize(&xblArgs);
    if (FAILED(hr))
    {
        // handle error: couldn't initialize XBOX Live.
    }
    // ...
}

Conectar o usuário ao XBOX Live

Use a API XUserAddAsync para conectar um usuário ao XBOX Live. Se for a primeira vez que ele entra no seu jogo, ele verá uma lista dos privilégios que seu jogo está solicitando. Ele precisará autorizar explicitamente esses privilégios para acessar sua conta do XBOX Live. Depois que o usuário entrar com êxito, você poderá usar a referência XUserHandle que passou para a função XUserAddResult. Ela pode ser usada para obter informações sobre esse usuário do XBOX Live, como gamertag, imagem do jogador, estado de entrada, faixa etária e privilégios. Depois que o usuário entrar pela primeira vez, ele deverá conseguir entrar silenciosamente com êxito (ou seja, sem nenhuma ação de sua parte) se não precisar resolver uma solicitação de interface do usuário (como um novo contrato de privacidade) desde a última vez que iniciou o jogo. No entanto, você ainda precisará fazer essas chamadas de API para obter acesso à identidade. Um XblContextHandle será necessário para chamar as APIs do XBOX Live. Você pode usar a função XblContextCreateHandle para obter um XblContextHandle usando um XUserHandle.

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

Conectar o usuário ao XBOX Live

​Conectar o usuário ao XBOX Live

Conectar o usuário ao XBOX Live