Exemplo Wrapper

​

Conteúdo do exemplo

• Wrapper: integra o pacote NuGet mais recente do PlayFab Game Server SDK (GSDK) ao seu servidor de jogo. Este aplicativo wrapper não se destina ao uso em produção
• Fakegame: um servidor de jogo básico que não tem conhecimento do GSDK. É como um servidor de jogo típico que você teria antes de usar o PlayFab Multiplayer Servers. Ele inicia o servidor Web Kestrel do ASP.NET Core, que escuta na porta TCP 80. Ele se destina a simular um servidor de jogo que não tem absolutamente nenhum conhecimento do GSDK. Você pode usá-lo se não tiver um servidor de jogo próprio. Ele tem duas rotas GET que podemos usar: /hello, para obter uma resposta simples, e /hello/terminate, que pode encerrar o servidor.

​

Requisitos

• .NET Core 3.1 x64 SDK

​

Passo a passo

​

Obter e criar o executável do Wrapper

• Obtenha o exemplo do wrapper do GSDK usando os métodos padrão do Git ou baixando-o como um arquivo zip
• Abra o Prompt de Comando e use o comando cd para alterar o caminho do diretório para o local do arquivo wrapper.csproj. Exemplo: cd C:/ReplaceWithYourFilePath/wrappingGsdk/wrapper
• Em seguida, execute o seguinte comando da CLI do .NET Core:

dotnet publish --self-contained -r win-x64 /p:PublishSingleFile=true /p:PublishTrimmed=true

​

Criar um ativo de servidor de jogo

​

Usar o servidor de jogo Fakegame com o wrapper

• Abra o PowerShell
• Use o comando cd para alterar o caminho do diretório para o local do script build.ps1. Exemplo: cd C:/ReplaceWithYourFilePath/wrappingGsdk/
• Execute \build.ps1
• Depois que o script for executado com êxito, vá para a pasta ..\wrappingGsdk\drop. Você encontrará um arquivo gameassets.zip criado, que contém o build do servidor de jogo falso, o executável do wrapper (criado na etapa anterior) e outros arquivos necessários.

​

Usar os arquivos do seu próprio servidor de jogo com o wrapper

• Siga as instruções em Criar o executável do wrapper
• Vá para o local de publicação do wrapper em ..\wrappingGsdk\wrapper\bin\Debug\netcoreapp3.1\win-x64\publish
• Em outra janela, vá para o build do seu servidor de jogo e para os arquivos necessários para executá-lo. Se não tiver certeza de quais arquivos são necessários, consulte Determinando os arquivos DLL necessários
• Copie o build do servidor de jogo e todos os arquivos necessários para o local de publicação do wrapper
• Selecione todos os arquivos no local de publicação do wrapper
• Com todos os arquivos selecionados, clique com o botão direito do mouse e selecione Enviar para > Pasta compactada. Não selecione a pasta de publicação do wrapper para adicioná-la ao zip. Isso causaria um mapeamento incorreto.

​

Criar e carregar uma imagem de contêiner Linux (somente para servidores Linux)

1. Configurar seu dispositivo de desenvolvimento Windows (opcional)
2. Obter as credenciais de entrada do registro de contêiner do PlayFab
3. Usar o Dockerfile existente/criar o seu próprio Esta etapa é diferente dependendo de você estar usando o FakeGame ou o seu próprio servidor de jogo.
   • Se estiver usando o FakeGame, verifique se você tem o Dockerfile
   • Se estiver usando o seu jogo ou precisar criar um Dockerfile, consulte Criar seu Dockerfile. Você pode usar o Dockerfile do FakeGame como ponto de partida.
4. Abra seu terminal Linux com o Docker instalado, como o Ubuntu. Substitua os valores das variáveis TAG e ACR pelos seus valores. Em seguida, execute os comandos abaixo.

TAG="0.1"
ACR="customer5555555.azurecr.io"
docker login ${ACR}

5. Insira o nome de usuário e a senha obtidos na etapa anterior.
6. Crie e carregue a imagem de contêiner Linux.

docker build -t ${ACR}/wrapper:${TAG} .
docker push ${ACR}/wrapper:${TAG}

​

Implantar um build usando o Game Manager ou a API

​

Implantar servidores de jogo Windows

• Usar o Game Manager para implantar e configurar servidores
• Usar PowerShell/API para implantar e configurar servidores

• Comando de início:
  • Use C:\Assets\wrapper.exe -g C:\Assets\fakegame.exe arg1 arg2
  • Substitua fakegame.exe pelo nome do executável do seu servidor de jogo, se estiver usando o build do seu servidor de jogo
• Configuração de rede: Nome: gameport, Porta: 80, Protocolo: TCP
• Ativos: ao usar o FakeGame, carregue gameassets.zip como ativo.

​

Implantar servidores de jogo Linux

• Usar o Game Manager para implantar e configurar servidores
• Usar PowerShell/API para implantar e configurar servidores

• Selecione o contêiner que você carregou
• Configuração de rede: Nome: gameport, Porta: 80, Protocolo: TCP
• Não é necessário carregar ativos nem definir o Start Command

​

Executando o wrapper usando o LocalMultiplayerAgent

"AssetDetails": [
    {
        "MountPath": "C:\\Assets",
        "SasTokens": null,
        "LocalFilePath": "C:\\projects\\gsdkSamples\\wrappingGsdk\\drop\\gameassets.zip"
    }
],
"StartGameCommand": "C:\\Assets\\wrapper.exe -g C:\\Assets\\fakegame.exe",

// if you are using fakegameserver you should also configure port mapping for port 80
"PortMappingsList": [
            [
                {
                    "NodePort": 56100,
                    "GamePort": {
                        "Name": "gameport",
                        "Number": 80,
                        "Protocol": "TCP"
                    }
                }
            ]
        ]

​

Como se conectar a um servidor de jogo no MPS

​

Usar o Game Manager

1. Faça logon no Game Manager
2. Vá para a página Multiplayer => Servers e selecione seu build
3. Vá para a página Servers e clique no botão “Request server”.
4. Na próxima página, anote o endereço IPv4 público e a Porta.
5. Use o curl para se conectar em http://[IPV4Address]:[Ports->Num]/Hello.”

​

Usar o exemplo MPS Allocator

1. Compile e execute o exemplo MPS Allocator.
2. Use o comando “ListBuildSummaries” para ver os builds disponíveis e suas IDs de build correspondentes.
3. Invoque “RequestMultiplayerServer” para iniciar uma solicitação de uma instância de servidor de jogo.
4. Insira a ID de build selecionada no comando “ListMultiplayerServers” para gerar uma lista dos servidores disponíveis.
5. Escolha uma instância de servidor de jogo ativa e, em seguida, use “GetMultiplayerServerDetails” com as IDs de build e de sessão obtidas nas etapas anteriores.
6. Anote o IPV4Address e o Ports->Num exibidos na resposta.
7. Use o curl para se conectar em http://[IPV4Address]:[Ports->Num]/Hello.

​

Confira também

• Criar seu primeiro servidor
• Recursos e exemplos
• SDKs do PlayFab Multiplayer Server
• Referência de API