Wrapper 範例

​

範例內容

• Wrapper—將 PlayFab 遊戲伺服器 SDK (GSDK) 的最新 NuGet 套件與您的遊戲伺服器整合。此 wrapper 應用程式並非供生產環境使用
• Fakegame—不了解 GSDK 的基本遊戲伺服器。它就像您在使用 PlayFab 多人遊戲伺服器之前所擁有的典型遊戲伺服器。它會啟動接聽 TCP 連接埠 80 的 ASP.NET Core Web 伺服器 Kestrel。它旨在模擬完全不了解 GSDK 的遊戲伺服器。如果您沒有自己的遊戲伺服器，可以使用它。它有兩個我們可以使用的 GET 路由：/hello 用於取得簡單回應，/hello/terminate 可以終止伺服器。

​

需求

• .NET Core 3.1 x64 SDK

​

逐步解說

​

取得並建置 Wrapper 可執行檔

• 使用標準 Git 方法或下載 zip 檔案，取得 GSDK wrapper 範例
• 開啟命令提示字元，並使用 cd 命令將目錄路徑變更為 wrapper.csproj 檔案的位置。範例：cd C:/ReplaceWithYourFilePath/wrappingGsdk/wrapper
• 接著執行下列 .NET Core CLI 命令：

dotnet publish --self-contained -r win-x64 /p:PublishSingleFile=true /p:PublishTrimmed=true

​

建立遊戲伺服器資產

​

搭配 wrapper 使用 Fakegame 遊戲伺服器

• 開啟 PowerShell
• 使用 cd 命令將目錄路徑變更為 build.ps1 指令碼的位置。範例：cd C:/ReplaceWithYourFilePath/wrappingGsdk/
• 執行 \build.ps1
• 指令碼成功執行後，前往 ..\wrappingGsdk\drop\ 資料夾。您會發現已建立 gameassets.zip 檔案，其中包含模擬遊戲伺服器組建、wrapper 可執行檔 (在先前步驟中建置) 以及其他必要檔案。

​

搭配 wrapper 使用您自己的遊戲伺服器檔案

• 依照建置 wrapper 可執行檔中的指示操作
• 前往位於 ..\wrappingGsdk\wrapper\bin\Debug\netcoreapp3.1\win-x64\publish 的 wrapper 發佈位置
• 在另一個視窗中，前往您的遊戲伺服器組建以及執行遊戲伺服器組建所需的檔案。如果您不確定需要哪些檔案，請參閱判斷所需的 DLL 檔案
• 將遊戲伺服器組建和所有必要檔案複製到 wrapper 發佈位置
• 選取 wrapper 發佈位置中的所有檔案
• 選取所有檔案後，按一下滑鼠右鍵，然後選取 Send to > Compressed (zip) files to zip。不要選取 wrapper 發佈資料夾並新增至 zip。這會導致不正確的對應。

​

建立並上傳 Linux 容器映像 (僅限 Linux 伺服器)

1. 設定您的 Windows 開發裝置 (選用)
2. 取得您的 PlayFab 容器登錄登入認證
3. 使用現有的或建立您自己的 Dockerfile 此步驟會因您使用的是 FakeGame 還是您自己的遊戲伺服器而有所不同。
   • 如果您使用的是 FakeGame，請確認您有 Dockerfile
   • 如果您使用的是您的遊戲或需要建立 Dockerfile，請參閱建立您的 Dockerfile。您可以使用 FakeGame 的 Dockerfile 作為起點。
4. 開啟已安裝 Docker 的 Linux 終端機，例如 Ubuntu。將 TAG 和 ACR 變數的值取代為您的值。然後執行下列命令。

TAG="0.1"
ACR="customer5555555.azurecr.io"
docker login ${ACR}

5. 輸入從先前步驟取得的使用者名稱和密碼。
6. 建置並上傳 Linux 容器映像。

docker build -t ${ACR}/wrapper:${TAG} .
docker push ${ACR}/wrapper:${TAG}

​

使用 Game Manager 或 API 部署組建

​

部署 Windows 遊戲伺服器

• 使用 Game Manager 部署和設定伺服器
• 使用 PowerShell/API 部署和設定伺服器

• 啟動命令：
  • 使用 C:\Assets\wrapper.exe -g C:\Assets\fakegame.exe arg1 arg2
  • 如果您使用的是自己的遊戲伺服器組建，請將 fakegame.exe 取代為您的遊戲伺服器可執行檔名稱
• 網路設定：名稱：gameport，連接埠：80，通訊協定：TCP
• 資產：使用 FakeGame 時，請將 gameassets.zip 上傳為資產。

​

部署 Linux 遊戲伺服器

• 使用 Game Manager 部署和設定伺服器
• 使用 PowerShell/API 部署和設定伺服器

• 選取您上傳的容器
• 網路設定：名稱：gameport，連接埠：80，通訊協定：TCP
• 不需要上傳資產和設定 Start Command

​

使用 LocalMultiplayerAgent 執行 wrapper

"AssetDetails": [
    {
        "MountPath": "C:\\Assets",
        "SasTokens": null,
        "LocalFilePath": "C:\\projects\\gsdkSamples\\wrappingGsdk\\drop\\gameassets.zip"
    }
],
"StartGameCommand": "C:\\Assets\\wrapper.exe -g C:\\Assets\\fakegame.exe",

// if you are using fakegameserver you should also configure port mapping for port 80
"PortMappingsList": [
            [
                {
                    "NodePort": 56100,
                    "GamePort": {
                        "Name": "gameport",
                        "Number": 80,
                        "Protocol": "TCP"
                    }
                }
            ]
        ]

​

如何連線至 MPS 上的遊戲伺服器

​

使用 Game Manager

1. 登入 Game Manager
2. 前往 Multiplayer => Servers 頁面，選取您的組建
3. 前往 Servers 頁面，然後按一下 “Request server” 按鈕。
4. 在下一頁上，記下公用 IPv4 位址和連接埠。
5. 使用 curl 在 http://[IPV4Address]:[Ports->Num]/Hello 進行連線。“

​

使用 MPS Allocator 範例

1. 編譯並執行 MPS Allocator 範例。
2. 套用 “ListBuildSummaries” 命令以檢視可用的組建及其對應的組建識別碼。
3. 叫用 “RequestMultiplayerServer” 以起始遊戲伺服器執行個體的要求。
4. 將所選的組建識別碼輸入 “ListMultiplayerServers” 命令，以產生可用伺服器的清單。
5. 選擇作用中的遊戲伺服器執行個體，然後使用先前步驟取得的組建和工作階段識別碼執行 “GetMultiplayerServerDetails”。
6. 記下回應中顯示的 IPV4Address 和 Ports->Num。
7. 使用 curl 在 http://[IPV4Address]:[Ports->Num]/Hello 進行連線。

​

另請參閱

• 建立您的第一部伺服器
• 資源和範例
• PlayFab 多人遊戲伺服器 SDK
• API 參考