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

# 多人遊戲伺服器快速入門 (MpsAllocator 範例)

> MpsAllocator .NET 範例的快速入門，此範例會呼叫 PlayFab Multiplayer API 來列出組建、檢視 VM，並視需要配置遊戲伺服器。

# MpsAllocator 範例

<Note>
  您可以[在此處](https://github.com/PlayFab/MpsSamples/tree/master/MpsAllocatorSample)找到 MpsAllocatorSample 以及其餘的 MPS 範例。
</Note>

此範例是一個簡單的 .NET Core 應用程式，可讓您輕鬆呼叫一些常用的 MPS API，例如列出 VM/伺服器以及配置遊戲伺服器 (RequestMultiplayerServer) 的 API。若要從 Game Manager 輕鬆快速地要求多人遊戲伺服器，請選取伺服器頁面頂端可協助您完成此操作的按鈕。若要深入了解，請查看我們的[伺服器概觀](/zh-TW/services/playfab/multiplayer/servers/build-server-overview)。若要使用此範例，您需要安裝 .NET Core 3.1 ([在此處](https://dotnet.microsoft.com/download)下載)。接著，您可以使用 `dotnet build` 命令為您的平台建置可執行檔，或直接執行 `dotnet run` 來執行應用程式。

<Note>
  您可以找到更多關於
</Note>

`dotnet build` 命令的資訊，請參閱[此處](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-build)

為了向 PlayFab API 進行驗證，應用程式需要您的 PlayFab TitleID 和開發人員秘密金鑰。若要為您的遊戲建立秘密金鑰，請前往 PlayFab 開發人員入口網站上的 Settings/Secret-Keys 頁面：[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。您可以透過環境變數) `PF_TITLEID` 和 `PF_SECRET`，或以命令列引數的形式提供這些金鑰。

<Note>
  應用程式透過對應的 [Nuget 套件](https://www.nuget.org/packages/PlayFabAllSDK/)使用 PlayFab SDK
</Note>

執行應用程式後，您可以選擇要呼叫的 API。每個 API 都會要求您提供必要的參數。以下是可用選項的清單：

* [RequestMultiplayerServer](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/request-multiplayer-server)：此選項會配置遊戲伺服器並傳回其詳細資料 (IP、FQDN、連接埠)。成功叫用此 API 呼叫會讓遊戲伺服器從 "StandingBy" 狀態轉換為 "Active" (詳細資訊請參閱[此處](/zh-TW/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)：此選項會傳回您遊戲之組建的摘要
* [GetBuild](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/get-build)：此選項會傳回指定組建的詳細資料
* [ListMultiplayerServers](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/list-multiplayer-servers)：此選項會傳回指定組建中遊戲伺服器的摘要
* [ListVirtualMachineSummaries](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/list-virtual-machine-summaries)：此選項會傳回指定組建中虛擬機器的摘要
* [GetMultiplayerServerDetails](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/get-multiplayer-server-details)：此選項會傳回指定遊戲伺服器的詳細資料

## 另請參閱

* [建立您的第一部伺服器](/zh-TW/services/playfab/multiplayer/servers/create-your-first-server)
* [資源和範例](/zh-TW/services/playfab/multiplayer/servers/server-samples-resources)
* [PlayFab 多人遊戲伺服器 SDK](/zh-TW/services/playfab/multiplayer/servers/server-sdks/overview)
* [API 參考](xref:titleid.playfabapi.com.multiplayer.multiplayerserver)


## Related topics

- [多人遊戲伺服器範例和資源](/zh-TW/services/playfab/multiplayer/servers/server-samples-resources.md)
- [PlayFab 多人遊戲文件](/zh-TW/services/playfab/multiplayer/index.md)
- [Wrapper 範例](/zh-TW/services/playfab/multiplayer/servers/wrapper-sample.md)
- [多人遊戲伺服器的生命週期](/zh-TW/services/playfab/multiplayer/servers/multiplayer-game-server-lifecycle.md)
- [配對快速入門](/zh-TW/services/playfab/multiplayer/matchmaking/quickstart.md)