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

# Início rápido para servidores multijogador (exemplo MpsAllocator)

> Início rápido para o exemplo .NET MpsAllocator, que chama as APIs do PlayFab Multiplayer para listar builds, ver VMs e alocar servidores de jogo sob demanda.

# Exemplo MpsAllocator

> [!NOTE]
>
> O MpsAllocatorSample pode ser encontrado [aqui](https://github.com/PlayFab/MpsSamples/tree/master/MpsAllocatorSample), junto com o restante dos exemplos do MPS.

Este exemplo é um aplicativo .NET Core simples que permite chamar facilmente algumas APIs do MPS usadas com frequência, como as que listam VMs/servidores e alocam servidores de jogo (RequestMultiplayerServer). Para solicitar um servidor multijogador de forma fácil e rápida pelo Game Manager, selecione o botão localizado na parte superior da nossa página de servidores, que pode ajudar você a fazer isso. Para saber mais, confira nossa [Visão geral dos servidores](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/servers/build-server-overview.md). Para usá-lo, você precisa ter instalado o .NET Core 3.1 (baixe [aqui](https://dotnet.microsoft.com/download)). Em seguida, você pode usar o comando `dotnet build` para criar um executável para sua plataforma ou apenas executar `dotnet run` para executar o aplicativo.

> [!NOTE]
>
> Você pode encontrar mais informações sobre o

comando `dotnet build` [aqui](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-build)

Para se autenticar nas APIs do PlayFab, o aplicativo precisa da TitleID do PlayFab e de uma chave secreta de desenvolvedor. Para criar uma chave secreta para o seu título, visite a página Settings/Secret-Keys no portal do desenvolvedor do PlayFab aqui: [https://developer.playfab.com/en-US/r/t/\<Your\_TitleID\>/settings/secret-keys](https://developer.playfab.com/en-US/r/t/\<Your_TitleID\>/settings/secret-keys). Você pode fornecer essas chaves por meio das variáveis de ambiente `PF_TITLEID` e `PF_SECRET` ou como argumentos de linha de comando.

> [!NOTE]
>
> O aplicativo usa o SDK do PlayFab por meio do [pacote Nuget](https://www.nuget.org/packages/PlayFabAllSDK/) correspondente

Depois de executar o aplicativo, você pode escolher qual API chamar. Cada API solicitará que você forneça os parâmetros necessários. Veja a lista das opções disponíveis:

* [RequestMultiplayerServer](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/request-multiplayer-server): esta opção alocará um servidor de jogo e retornará seus detalhes (IP, FQDN, porta). A invocação bem-sucedida dessa chamada de API resultará na transição de um servidor de jogo do estado "StandingBy" para "Active" (mais informações [aqui](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/servers/allocating-game-servers-and-configuring-vs-debugging-tools.md))
* [ListBuildSummaries](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/list-build-summaries-v2): esta opção retornará resumos dos builds do seu título
* [GetBuild](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/get-build): esta opção retornará detalhes sobre o build especificado
* [ListMultiplayerServers](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/list-multiplayer-servers): esta opção retornará resumos dos servidores de jogo em um build especificado
* [ListVirtualMachineSummaries](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/list-virtual-machine-summaries): esta opção retornará resumos das máquinas virtuais em um build especificado
* [GetMultiplayerServerDetails](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/get-multiplayer-server-details): esta opção retornará detalhes sobre um servidor de jogo especificado

## Confira também

* [Criar seu primeiro servidor](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/servers/create-your-first-server.md)
* [Recursos e exemplos](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/servers/server-samples-resources.md)
* [SDKs do PlayFab Multiplayer Server](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/servers/server-sdks/overview.md)
* [Referência de API](xref:titleid.playfabapi.com.multiplayer.multiplayerserver)


## Related topics

- [Exemplo Wrapper](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/servers/wrapper-sample.md)
- [Servidores](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/servers/index.md)
- [Documentação do PlayFab Multiplayer](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/index.md)
- [Início rápido do Photon](https://docs.xbox.com/pt-BR/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)
- [Implantar builds usando o Game Manager](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/servers/deploy-using-game-manager.md)