ビルド エイリアスの管理と割り当て

​

後方互換性のある安全な展開

• Build 1: Weight = 1

• Build 1: Weight = 8
• Build 2: Weight = 2

​

後方互換性のない展開

• Build 1: Weight = 1

• Build 2: Weight = 1

​

後方互換性のある一括展開

• Build 1: Weight = 1

• Build 1: Weight = 0
• Build 2: Weight = 1

​

後方互換性のある展開のテスト

• Build 1: Weight = 1

• Build 2: Weight = 1

• Build 1: Weight = 8
• Build 2: Weight = 2

​

他のビルドやリージョンへのフォールバック

1. MPS はビルドの重みを使用して、リクエストに対するエイリアスのビルドの順序を決定します。重みが大きいビルドほど、最初に来る可能性が高くなります。
2. MPS は、列挙された順にリージョンを確認します。各リージョンで、その順序ですべてのビルドを試行します。そのリージョンに展開されていないビルドはスキップされます。
3. MPS は、StandingBy サーバーを持つ最初のビルドからサーバーを割り当てます。そのリージョンにどのビルドにも StandingBy サーバーがない場合、MPS は次のリージョンに進みます。どのリージョンにもない場合、リクエストは MultiplayerServerTooManyRequests エラーで失敗します。

1. East US での Build 1 の割り当てが試行されます。
2. #1 が失敗した場合、East US での Build 2 の割り当てが試行されます。
3. #2 が失敗した場合、WestUS での Build 1 の割り当てが試行されます。
4. #3 が失敗した場合、WestUs での Build 2 の割り当てが試行されます。

​

PlayFab REST API を使用したビルド エイリアスの管理

1. API を使用してビルド エイリアスを作成します。 API:
   POST https://titleId.playfabapi.com/MultiplayerServer/CreateBuildAlias
   
   サンプル ボディ:
   {
       "AliasName":"TestingAlias",
       "BuildSelectionCriteria":
       [{
           "BuildWeightDistribution":{"9a8a4584-c81a-479c-9ef9-16d3743f7ca7":"1"}
       }]
   }
   
   サンプル レスポンス:
   {
       "AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6",
       "AliasName":"TestingAlias",
       "BuildSelectionCriteria":
       [{
           "BuildWeightDistribution":{"9a8a4584-c81a-479c-9ef9-16d3743f7ca7":"1"}
       }]
   }
   
   ビルド エイリアス ID はレスポンスの一部として提供されます。
2. ビルド エイリアスの任意のパラメーターを更新します。 API:
   POST https://titleId.playfabapi.com/MultiplayerServer/UpdateBuildAlias
   
   サンプル ボディ:
   {
       "AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6",
       "AliasName":"TestingAliasRenamed",
       "BuildSelectionCriteria":
       [{
           "BuildWeightDistribution":{"9a8a4584-c81a-479c-9ef9-16d3743f7ca7":"1",
           "7ac7f347-3d61-9fe9-c974-a18c4854a8a9":"1"}
       }]
   }
   
   サンプル レスポンス:
   {
       "AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6",
       "AliasName":"TestingAliasRenamed",
       "BuildSelectionCriteria":
       [{
           "BuildWeightDistribution":{"9a8a4584-c81a-479c-9ef9-16d3743f7ca7":"1",
           "7ac7f347-3d61-9fe9-c974-a18c4854a8a9":"1"}
       }]
   }
   
3. ビルド エイリアスを削除します。 API:
   POST https://titleId.playfabapi.com/MultiplayerServer/DeleteBuildAlias
   
   サンプル ボディ:
   {
       "AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6"
   }
   
4. ビルド エイリアスを一覧表示します。 API:
   GET https://titleId.playfabapi.com/MultiplayerServer/ListBuildAliases
   
   サンプル レスポンス:
   [{
       "AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6",
       "AliasName":"TestingAliasRenamed",
       "BuildSelectionCriteria":
       [{
           "BuildWeightDistribution":{"9a8a4584-c81a-479c-9ef9-16d3743f7ca7":"1",
           "7ac7f347-3d61-9fe9-c974-a18c4854a8a9":"1"}
       }]
   }]
   

​

ビルド エイリアスを使用して割り当てる

POST https://titleId.playfabapi.com/MultiplayerServer/RequestMultiplayerServer

{
    "SessionId":"6a07440c-7bcc-4e23-8b81-4934543ff966",
    "PreferredRegions":["SouthCentralUs"],
    "BuildAliasParams":
        {"AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6"}
}