Passo a passo: implantar builds usando PowerShell/API

Este tópico descreve como implantar/criar builds para VMs com sistema operacional Windows no PowerShell, em um dispositivo de desenvolvimento com Windows 10, com base no exemplo C# Windows Runner.

Para usar e ver o PlayFab Multiplayer Servers, você precisa habilitar o recurso. Recomendamos usar o método do Game Manager para habilitar esse recurso. Para obter instruções, consulte Habilitar o recurso PlayFab Server.

Pré-requisitos

Verifique se você concluiu as etapas a seguir.

1. 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

2. Instalar o módulo PlayFab Multiplayer PowerShell

Abra o Windows Powershell como Administrador e execute o comando a seguir para instalar o módulo PlayFabMultiplayer API. Esse novo módulo PlayFabMultiplayer API substitui o módulo Multiplayer PowerShell preterido. Se você instalou anteriormente o módulo PlayFab Multiplayer Powershell, desinstale-o com o comando a seguir. Para quem está fazendo a transição para o novo módulo, consulte Mapeamento de comandos para encontrar os novos comandos equivalentes.

Uninstall-Package PlayFabMultiplayer

Tanto os comandos quanto os argumentos são diferentes neste novo módulo. Para obter a documentação detalhada sobre cada comando, consulte a documentação dos cmdlets.

Install-Module -Name PlayFabMultiplayerApi

Antes de instalar o módulo, talvez seja necessário definir primeiro sua política de execução usando Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser. Para saber mais, consulte Políticas de execução do PowerShell.

3. Obter um EntityToken para o seu título

Na janela do PowerShell, execute o seguinte comando usando a ID do título e a chave de desenvolvedor associada:

Set-PfTitle -TitleID "mytitleID" -SecretKey "mysecretkey"

4. Carregar ativos

Ao implantar servidores Windows, você usará o contêiner Windows gerenciado. Basta carregar o PlayFab Multiplayer Game Server Build como um ativo. Atualize o valor do sinalizador FilePath com o local do arquivo local winrunnerSample.zip. Se não souber onde está esse arquivo, siga as instruções aqui para obtê-lo.

New-PfAsset -FilePath C:\windowsRunnerCSharp.zip -AssetName windowsRunnerCSharp.zip

5. Criar um build

Agora que o ativo foi carregado, podemos criar um build. Execute os comandos a seguir. O código abaixo usa a VM Standard_D2as_v4 na região EastUS. Substitua as cadeias de caracteres de acordo com a VM e a região que você deseja usar.

$vmSize = "Standard_D2as_v4"

$regions = @( @{ StandbyServers = 1; MaxServers = 1; Region = 'EastUS'; ScheduledStandbySettings = $NULL } )

$ports = @( @{ Name = 'game_port'; Num = 3600; Protocol = 'TCP' } )

$gameAssets = @( @{ FileName = 'windowsRunnerCSharp.zip'; MountPath = 'C:\Assets' } )

$buildResponse = New-PfBuild -BuildName PSTest_build -ContainerFlavor ManagedWindowsServerCore -StartMultiplayerServerCommand 'C:\Assets\WindowsRunnerCSharp.exe' -GameAssetReferences $gameAssets -VMSize $vmSize -MultiplayerServerCountPerVM 1 -Ports $ports -RegionConfigurations $regions

# All PlayFabMultiplayerApi cmdlets return objects, so we can pass the returned object to ConvertTo-Json for human readability.
$buildResponse | ConvertTo-Json -depth 5

Verificar se o build foi bem-sucedido

Em alguns segundos, você verá o build criado pelo PowerShell ou pela API ListBuildSummaries. Você também pode executar o comando a seguir para verificar se o build foi implantado com êxito.

Get-PfBuild | ConvertTo-Json -depth 5

XBOX Services

PlayFab

Pré-requisitos

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

2. Instalar o módulo PlayFab Multiplayer PowerShell

3. Obter um EntityToken para o seu título

4. Carregar ativos

5. Criar um build

Verificar se o build foi bem-sucedido

Confira também

​Pré-requisitos

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

​2. Instalar o módulo PlayFab Multiplayer PowerShell

​3. Obter um EntityToken para o seu título

​4. Carregar ativos

​5. Criar um build

​Verificar se o build foi bem-sucedido

​Confira também

Pré-requisitos

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

2. Instalar o módulo PlayFab Multiplayer PowerShell

3. Obter um EntityToken para o seu título

4. Carregar ativos

5. Criar um build

Verificar se o build foi bem-sucedido

Confira também