Integrar o GDK a um projeto do Unreal Engine anterior à versão 4.26

​

Usando uma versão anterior do Unreal Engine (anterior à versão 4.26)

​

Adicionar cabeçalhos e bibliotecas de importação para o Gaming Runtime e a XSAPI

1. Localize o arquivo de build do seu projeto Unreal: /Source/(ProjectName)/(ProjectName).Build.cs
2. Adicione a linha abaixo para definir a macro _GAMING_DESKTOP
       PublicDefinitions.Add("_GAMING_DESKTOP");  // For Unreal 4.12 or earlier, use "Definitions.Add()" instead
   
3. Adicione os seguintes caminhos de inclusão
       // Add the include path for Gaming Runtime
       PublicIncludePaths.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Include");
       // Add the include path for XSAPI
       PublicIncludePaths.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Services.API.C\Include");
   

Para o Microsoft GDK (junho de 2024) ou anterior, use: C:\Program Files (x86)\Microsoft GDK\230300\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Include

1. Adicione os seguintes caminhos de biblioteca para as bibliotecas de importação
       // Add the import library for Gaming Runtime
       PublicAdditionalLibraries.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\GameKit\Lib\amd64\xgameruntime.lib");
       // Add the import library for XSAPI
       PublicAdditionalLibraries.Add(@"C:\Program Files (x86)\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Services.API.C\Lib\Release\Microsoft.Xbox.Services.142.GDK.C.Thunks.lib");
   

Para o Microsoft GDK (junho de 2024) ou anterior, use: C:\Program Files (x86)\Microsoft GDK\230300\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\Lib\Release\Microsoft.Xbox.Services.141.GDK.C.Thunks.lib

​

Acessar o Gaming Runtime e a XSAPI a partir de arquivos de código C++

1. Determine onde você gostaria de adicionar a integração para recursos como entrada e desbloqueio de conquistas
2. Adicione os cabeçalhos do Gaming Runtime e da XSAPI
       // When using Unreal Engine 4.15 or later
       THIRD_PARTY_INCLUDES_START
       
       #include "XGameRuntimeInit.h" // For Gaming Runtime 
       #include "xsapi-c\services_c.h"  // For XSAPI
       // When using Unreal Engine 4.15 or later
       THIRD_PARTY_INCLUDES_END
   
3. Faça a integração com as chamadas de serviço. Veja os exemplos abaixo:

• Como fazer: prática recomendada para a entrada de um usuário
• Atualizando conquistas gerenciadas pelo título

​

Criando um produto no Partner Center

​

Criar um arquivo MicrosoftGame.config para o seu jogo

​

Criar e registrar o pacote do seu jogo

1. Acesse a caixa de diálogo de empacotamento selecionando File > Package Project > Windows > Windows (64-bit).
2. Escolha uma pasta para a saída do build na caixa de diálogo File Explorer e, em seguida, selecione Select Folder.
3. Inicie seu jogo com o wdapp.
       wdapp launch {full path to the game's executable in the same directory containing the MicrosoftGame.Config file}
   
4. Como alternativa, você pode registrar o pacote com o wdapp e depois iniciar o jogo pelo menu Iniciar.
       wdapp register {full path to the directory containing the MicrosoftGame.Config file}
   

​

Confira também