為票證指定屬性

規則會根據玩家指定的屬性，決定要配對哪些票證。這些屬性可以透過以下兩種方式之一指定：

在建立票證要求中
在玩家的實體中

本教學課程說明如何指定這些屬性。

在建立票證要求中指定

對於設定為屬性類型「User」的規則，屬性會在 CreateMatchmakingTicket 要求中指定，與玩家實體一起放在屬性 DataObject 內。

POST https://{{TitleId}}.playfabapi.com/Match/CreateMatchmakingTicket
{
    "Creator": {
        "Entity": {
            "Id": "A8140AB9109712B",
            "Type": "title_player_account",
            "TypeString": "title_player_account"
        },
        "Attributes": {
            "DataObject": {
                "mu": 16.0,
                "sigma": 1.8,
                "nestExample": {
                    "exp": 1500
                }
            }
        }
    },
    "MembersToMatchWith": [],
    "GiveUpAfterSeconds": 2,
    "QueueName": "SkillRuleQueue"
}

以下是具有 DifferenceRule 的佇列設定範例。此規則包含屬性路徑和來源，會取得上述 CreateMatchmakingTicket 要求所指定的值 16.0。

"MatchmakingQueue": {
    "Name": "SkillRuleQueue",
    "MinMatchSize": 2,
    "MaxMatchSize": 2,
    "ServerAllocationEnabled": false,
    "Rules": [
        {
            "Type": "DifferenceRule",
            "Difference": 3,
            "MergeFunction": "Average",
            "Attribute": {
                "Path": "mu",
                "Source": "User"
            },
            "AttributeNotSpecifiedBehavior": "MatchAny",
            "Weight": 1,
            "Name": "SkillRule",
            "SecondsUntilOptional": 10
        }
    ]
}

規則可以使用 JSON Path 在 DataObject 中巡覽。將 Path 欄位取代為 “nestExample.exp”，會讓規則對上面建立的票證使用值 1500。

透過玩家實體指定

對於屬性類型為「Player Entity」的規則，屬性是透過另外呼叫 SetObjects API 來指定。這可讓資料為使用者儲存，而不需要遊戲在每次建立票證呼叫時指定。對於會為使用者持續保存的值，或無法信任使用者自行提交的值，這種方式可能更合適。以下顯示此 SetObjects 呼叫的範例。

POST https://{{TitleID}}.playfabapi.com/Object/SetObjects
{
    "Objects": [
        {
            "ObjectName": "playerSkill",
            "DataObject": {
                "skillDetail": {
                    "mu": 16.0,
                    "sigma": 2.0
                }
            }
        }
    ],
    "Entity": {
        "Id": "A8140AB9109712B",
        "Type": "title_player_account",
        "TypeString": "title_player_account"
    }
}

以此玩家建立票證時，具有下列設定的佇列會擷取值 16.0，以用於其 DifferenceRule 規則。

在 Path 欄位中，根目錄之後的第一個項目是 ObjectName，可讓您選擇要參考哪個已儲存的物件。

"MatchmakingQueue": {
    "Name": "PlayerEntityRuleQueue",
    "MinMatchSize": 2,
    "MaxMatchSize": 2,
    "ServerAllocationEnabled": false,
    "Rules": [
        {
            "Type": "DifferenceRule",
            "Difference": 1,
            "MergeFunction": "Average",
            "Attribute": {
                "Path": "$.playerSkill.skillDetail.mu",
                "Source": "PlayerEntity"
            },
            "AttributeNotSpecifiedBehavior": "MatchAny",
            "Weight": 1,
            "Name": "SkillRule",
            "SecondsUntilOptional": 10
        }
    ]
}

特殊格式

大多數規則使用的屬性都是字串或數值，也就是 JSON 格式的這些值。需要傳入更複雜屬性的規則列於下方。

區域選取規則

區域選取規則需要具有指定結構描述的延遲測量值陣列。下列範例是區域選取規則預期的屬性格式，並與 CreateMatchmakingTicket 要求範例中使用的兩個屬性並列以供比較。

POST https://{{TitleId}}.playfabapi.com/Match/CreateMatchmakingTicket
{
    "Creator": {
        "Entity": {
            "Id": "A8140AB9109712B",
            "Type": "title_player_account",
            "TypeString": "title_player_account"
        },
        "Attributes": {
            "DataObject": {
                "mu": 16.0,
                "sigma": 1.8,
                "Latencies": [
                    {
                        "region": "EastUs",
                        "latency": 150
                    },
                    {
                        "region": "WestUs",
                        "latency": 400
                    }
                ]
            }
        }
    },
    "MembersToMatchWith": [],
    "GiveUpAfterSeconds": 2,
    "QueueName": "ServerEnabledQueue"
}

在此範例中，Latencies 必須與規則中 Path 欄位所參考的欄位相符。下方佇列中包含會使用 Latencies 欄位的規則範例。

"MatchmakingQueue": {
    "Name": "ServerEnabledQueue",
    "MinMatchSize": 2,
    "MaxMatchSize": 2,
    "ServerAllocationEnabled": true,
    "BuildId": "88b3e315-829c-4b6d-9872-74f427ad5331",
    "Rules": [
        {
            "Type": "RegionSelectionRule",
            "MaxLatency": 1000,
            "Path": "Latencies",
            "Weight": 1,
            "Name": "RegionRule",
            "SecondsUntilOptional": 60
        }
    ]
}

對已啟用伺服器配置的佇列使用區域選取規則時，區域必須是有效的 Azure 區域。您可以在這裡找到有效的 Azure 區域清單。

XBOX Services

PlayFab

在建立票證要求中指定

透過玩家實體指定

特殊格式

區域選取規則

​在建立票證要求中指定

​透過玩家實體指定

​特殊格式

​區域選取規則

在建立票證要求中指定

透過玩家實體指定

特殊格式

區域選取規則