Pular para o conteúdo principal
Este artigo fornece uma visão geral de como implantar/criar builds para VMs usando o sistema operacional Windows no PowerShell em um dispositivo de desenvolvimento com Windows 10. Ao implantar um build usando PowerShell/API, você provavelmente usará uma combinação do Game Manager e das APIs. Por isso, os comandos de PowerShell/API estão listados por funcionalidade abaixo. Se esta for a primeira vez que você implanta um build, recomendamos implantar um build usando o exemplo Wrapper, pois ele vem com todos os ativos necessários para realmente implantar servidores.
Para usar e ver o PlayFab Multiplayer Servers, você precisa habilitar o recurso. Se você for um novo usuário, recomendamos usar o método do Game Manager para habilitar esse recurso. Para obter instruções, consulte Habilitar o recurso PlayFab Server.

Obter a ID do título e a chave secreta de desenvolvedor

  • Obtenha a ID do título do PlayFab
    • Faça logon na sua conta de desenvolvedor em PlayFab.com
    • No Game Manager, vá para a página My Studios and Titles. Procure o título do seu jogo e obtenha a ID do título do jogo no PlayFab
  • Obtenha a chave secreta de desenvolvedor do título
    • No Game Manager, selecione seu título > configurações (ícone de engrenagem)
    • Selecione Title settings e, em seguida, a guia Secret Keys para obter a chave secreta de desenvolvedor
Para obter mais informações sobre chaves secretas, consulte Gerenciamento de chaves secretas.

Instalar o módulo do PowerShell PlayFab MultiplayerAPI

  1. Abra o Windows PowerShell como Administrador
  2. Se você instalou anteriormente o módulo PlayFab Multiplayer PowerShell, desinstale-o com o comando a seguir. Esse módulo foi preterido.
Para ajudar na transição para o novo módulo, consulte Mapeamento de comandos para encontrar os novos comandos equivalentes. Saiba que tanto os comandos quanto os argumentos podem ser diferentes.
  1. Instale o novo módulo PlayFabMultiplayer API
Para obter a documentação detalhada sobre cada comando, consulte a documentação dos cmdlets.
Antes de instalar o módulo, talvez seja necessário definir sua política de execução executando primeiro Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser no PowerShell. Para saber mais, consulte Políticas de execução do PowerShell.
  1. Saiba mais sobre os cmdlets do módulo PlayFab Multiplayer PowerShell executando o comando a seguir. Ou consulte a documentação de referência dos cmdlets do PlayFabMultiplayerApi.

Obter um EntityToken para o seu título

Execute o comando a seguir usando a ID do título e a chave de desenvolvedor associada. Você deve executar esse comando no início de qualquer sessão ao usar o módulo do PowerShell PlayFabMultiplayerApi. Ele chama a API GetEntityToken para obter um EntityToken e o armazena em uma variável de ambiente para uso em cmdlets futuros.

Habilitar o recurso de servidores multijogador para o seu título

Execute o cmdlet abaixo para habilitar os recursos do Multiplayer Servers. Ele chama a API enable multiplayer servers.
Se você receber um erro que diz Title must have a valid payment instrument associated with it in order to enable Multiplayer Servers, consulte Habilitar o PlayFab Multiplayer Servers usando o Game Manager para adicionar suas informações de pagamento.

Carregar um ativo

Carregar um ativo é obrigatório ao implantar um build para servidores Windows. Isso ocorre porque seus ativos personalizam a imagem de contêiner Windows gerenciada. No entanto, é opcional ao implantar um build para servidores Linux, pois você pode personalizar a imagem de contêiner Linux. Para saber mais, consulte Criar e implantar builds Linux. Execute este comando para carregar um ativo.
em que:
  • Filepath: caminho para o arquivo local que você deseja carregar
  • AssetName: nome do ativo a ser carregado
Para obter mais detalhes, consulte a documentação de referência de New-PfAsset.

Criar um build

  • Ao criar um build para servidores Windows, você precisa ter carregado um ativo. Caso contrário, consulte Carregar um ativo.
  • Ao criar um build para servidores Linux, você precisa ter carregado sua imagem de contêiner Linux personalizada no registro de contêiner do PlayFab. Para saber mais, consulte Criar e implantar builds Linux.
Use os valores corretos para vmSize__ e __regions se você planeja aproveitar os recursos oferecidos para avaliação gratuita.
Veja abaixo um código de exemplo para ajudar a implantar builds para servidores de jogo Windows.
Veja abaixo um código de exemplo para ajudar a implantar builds para servidores de jogo Linux.
Durante o desenvolvimento, desative todas as regiões não utilizadas ou não íntegras para evitar o uso de horas de núcleo de VM. O uso de horas de núcleo começa durante a inicialização da VM e continua até que a VM seja desligada. As VMs de uma região não serão desligadas automaticamente, a menos que a meta de servidores em espera da região chegue a 0 ou que a região seja excluída.

Desligando VMs

Há três maneiras de desligar VMs
  1. Definir a meta de servidores em espera de uma região como 0; isso desligará as VMs somente dessa região.
  2. Excluir uma região específica de um build.
  3. Excluir o build inteiro; isso desligará as VMs em todas as regiões desse build.

Listar os builds implantados

Para ver uma lista de builds do seu título, execute os comandos abaixo.

Solicitar um servidor multijogador

Depois que você criar um build, um ou mais servidores serão criados após a execução do seu arquivo .exe. Esses servidores agora estão “em espera”. Você pode vê-los ao listar todos os servidores que executam o nosso build usando este comando.
Quando virmos alguns servidores em espera, vamos solicitar um para o jogo…
A resposta a essa chamada inclui um endereço IPv4 e um número de porta aos quais os clientes podem se conectar. O WindowsRunnerCSharp.exe hospeda um servidor Web simples, portanto, você pode navegar até o endereço IPv4 e o número da porta para obter uma resposta:
Esta é a essência dos servidores multijogador do PlayFab: em até 3 segundos após o seu serviço de matchmaking chamar RequestMultiplayerServer, o PlayFab alocará um novo servidor. Esses servidores vêm de pools de servidores em espera reabastecidos continuamente, que você configura por região e por build.

Mapeamento de comandos

A tabela abaixo mostra o novo equivalente dos comandos antigos. Este é um mapeamento rápido para ajudar quem usou a versão anterior do módulo do PowerShell e precisa converter seus comandos existentes. Leia a definição de cada comando para obter os detalhes completos da alteração, pois alguns dos argumentos também foram alterados.

Confira também

Última modificação em 8 de outubro de 2026