Como usar o plug-in PlayFab GSDK para Unreal
Este artigo descreve como integrar o plug-in Unreal Online Subsystem (OSS) do PlayFab Multiplayer Server SDK (GSDK) ao seu projeto do Unreal. Este plug-in oferece uma API de Blueprint e uma API de C++. A API de Blueprint ainda exige que o seu projeto do Unreal seja um projeto C++ e não funcionará em um projeto somente Blueprint. Se atualmente ele for um projeto somente Blueprint, você precisará convertê-lo em um projeto C++ antes de adicionar o plug-in. Ele foi testado originalmente com o Unreal Engine 4.26, 4.27, 5.0 e 5.1. Este plug-in será mantido ativamente para funcionar com as 3 a 4 versões mais recentes do Unreal. Se algo falhar ao usar essas versões, abra um problema aqui: Repositório do Unreal Engine GSDK. Para usar estes guias, substitua todas as ocorrências de ThirdPersonMP pelo nome do seu projeto, se for diferente.Requisitos
- Baixe o Visual Studio. A versão Community é gratuita.
- Cargas de trabalho necessárias: Desenvolvimento para desktop com .NET e Desenvolvimento para desktop com C++
- Baixe o código-fonte do Unreal Engine. Para obter instruções, consulte Baixando o código-fonte do Unreal Engine (externo).
- Se ainda não fez isso, execute um git clone deste repositório no seu computador local
git clone https://github.com/PlayFab/gsdk.git- As etapas posteriores envolverão a integração de arquivos deste repositório ao seu projeto
- [Opcional] Baixe o LocalMultiplayerAgent
- [Opcional] Como alternativa, baixe o código-fonte do LocalMultiplayerAgent.
- [Opcional] Plug-in do PlayFab no Marketplace ou a versão de código-fonte no GitHub. Esse plug-in não é necessário para o GSDK, mas é necessário para muitos serviços do PlayFab, incluindo o logon.
Criação do projeto
O projeto de servidor do Unreal precisa ser um projeto multijogador do Unreal habilitado para rede, com um modo de servidor dedicado. Se você não tiver um projeto que atenda a esses pré-requisitos, siga nosso guia de configuração de pré-requisitos do Unreal para configurar um. Depois de ter um projeto multijogador habilitado para rede, com um servidor dedicado, volte para esta etapa e continue. Quando estiver pronto, abra seu projeto de servidor multijogador do Unreal habilitado para rede e continue para a próxima etapa para instalar o Unreal GSDK.Configuração do GSDK no projeto
- Detalhes dos pré-requisitos do projeto para o GSDK
- Servidor dedicado:
- Seu projeto deve ter um arquivo {ProjectName}Server.Target.cs separado
- Esse arquivo deve conter
Type = TargetType.Server;para habilitar o modo de servidor dedicado - Quando criado na configuração “development server” para Win64, sua saída contém {ProjectName}Server.exe
- Habilitado para rede:
- Há várias maneiras de atender a esse requisito, mas a resposta simples é: seu cliente pode estabelecer uma conexão de rede com um servidor de jogo em outro computador e se comunicar de forma significativa
- Nossas instruções orientam você pelo sistema interno de replicação de dados do Unreal, que atende à maior parte desse requisito para você
- Você pode estabelecer essa conexão de forma mais direta com um soquete, por exemplo, por meio do ISocketSubsystem, que é um tópico muito mais avançado
- Multijogador:
- Seu servidor de jogo pode aceitar várias conexões de clientes de entrada e se comunicar corretamente com ambas
- Novamente, com a replicação de dados interna do Unreal, esse requisito é atendido em grande parte para você
- Servidor dedicado: