> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Conecte o XBOX GDK a builds do Unreal Engine anteriores à 4.26 editando o Build.cs, adicionando manualmente os caminhos de inclusão e de biblioteca e iniciando com o wdapp.

Use este tópico se você estiver preparando seu jogo para publicação na Microsoft Store para PC e seu jogo usar uma versão do Unreal Engine anterior à 4.26.

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

Se você estiver usando o Unreal Engine versão 4.26 ou posterior, consulte [Introdução ao Unreal no PC](/pt-BR/build/gdk-and-engines/unreal/unreal).

Se você estiver usando o Unreal Engine versão 4.25 ou anterior e não puder atualizar para a versão 4.26 ou posterior, ainda poderá integrar as principais experiências do ecossistema XBOX usando as bibliotecas de importação do Gaming Runtime e da XBOX Services API (XSAPI).

Essas bibliotecas de importação permitem que os jogos chamem diretamente as APIs do Gaming Runtime e a XSAPI, sem precisar adicionar um destino de plataforma GDK ao projeto do jogo.

### 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**
   ```csharp theme={null}
       PublicDefinitions.Add("_GAMING_DESKTOP");  // For Unreal 4.12 or earlier, use "Definitions.Add()" instead
   ```
3. Adicione os seguintes caminhos de inclusão
   ```csharp theme={null}
       // 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
   ```csharp theme={null}
       // 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*

<Note>
  Os caminhos de inclusão e de biblioteca podem ser diferentes na sua máquina, dependendo da versão do GDK e do local de instalação.
</Note>

### 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
   ```cpp theme={null}
       // 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

Antes de testar a funcionalidade dos XBOX services ou publicar um jogo na Microsoft Store, você precisa criar seu produto habilitado para XBOX services no Partner Center. Para obter mais informações sobre o Partner Center, consulte Configurar um aplicativo ou jogo no Partner Center, para Parceiros Gerenciados.

### Criar um arquivo MicrosoftGame.config para o seu jogo

Para que o jogo possa entrar nos XBOX services, você precisa incluir um arquivo **MicrosoftGame.config** no pacote do jogo e preencher os campos "MSAAppId" e "TitleId" com os valores do projeto do Partner Center que você criou na etapa anterior. A maneira mais fácil de criar o arquivo de configuração é usar o [MicrosoftGame.config Editor](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Editor). Para obter mais informações sobre o arquivo MicrosoftGame.config, consulte [Visão geral do MicrosoftGame.config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Overview).

<Note>
  Certifique-se de que o arquivo MicrosoftGame.config esteja no mesmo diretório que contém o arquivo executável principal do seu jogo.
</Note>

### Criar e registrar o pacote do seu jogo

Para entrar nos XBOX services a partir do seu jogo e testar a integração do serviço, você precisa criar um pacote e registrá-lo.

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.
   ```cpp theme={null}
       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.
   ```cpp theme={null}
       wdapp register {full path to the directory containing the MicrosoftGame.Config file}
   ```

<Note>
  Clicar duas vezes diretamente no executável não funcionará para fins de entrada nos XBOX services.
</Note>

## Confira também

[Solução de problemas de entrada e sandboxes](/pt-BR/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)


## Related topics

- [Visão geral do plug-in PlayFab Unreal GSDK](/pt-BR/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [Usar o GDK com o Unreal Engine](/pt-BR/build/gdk-and-engines/unreal/unreal.md)
- [Integrar o GDK a um mecanismo C/C++ personalizado](/pt-BR/build/gdk-and-engines/custom-engine.md)
- [Notas de versão do PlayFab OnlineSubsystem para Unreal Engine](/pt-BR/services/playfab/multiplayer/networking/unreal-release-notes.md)
- [Integrar o plug-in do PlayFab do Unreal Engine Marketplace](/pt-BR/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration.md)