> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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.
</Note>

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](/pt-BR/services/playfab/multiplayer/servers/build-server-overview). 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
</Note>

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/\&lt;Your\_TitleID\&gt;/settings/secret-keys](https://developer.playfab.com/en-US/r/t/\&lt;Your_TitleID\&gt;/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
</Note>

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](/pt-BR/services/playfab/multiplayer/servers/allocating-game-servers-and-configuring-vs-debugging-tools))
* [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](/pt-BR/services/playfab/multiplayer/servers/create-your-first-server)
* [Recursos e exemplos](/pt-BR/services/playfab/multiplayer/servers/server-samples-resources)
* [SDKs do PlayFab Multiplayer Server](/pt-BR/services/playfab/multiplayer/servers/server-sdks/overview)
* [Referência de API](xref:titleid.playfabapi.com.multiplayer.multiplayerserver)


## Related topics

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