Especificando atributos nos seus tíquetes

As regras determinam quais tíquetes são combinados com base nos atributos especificados pelos jogadores. Esses atributos podem ser especificados de duas maneiras:

Na solicitação de criação de tíquete
Na entidade do jogador

Este tutorial descreve como especificar esses atributos.

Especificando na solicitação de criação de tíquete

Para regras configuradas com o tipo de atributo “User”, os atributos são especificados em uma solicitação CreateMatchmakingTicket, junto com a entidade do jogador, dentro de um DataObject de atributos.

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"
}

Veja abaixo um exemplo de configuração de fila com uma DifferenceRule. Essa regra contém um caminho e uma origem de atributo que obterão o valor 16.0, especificado pela solicitação CreateMatchmakingTicket acima.

"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
        }
    ]
}

As regras podem navegar pelo DataObject com um JSON Path. Substituir o campo Path por “nestExample.exp” faria com que a regra usasse o valor 1500 para o tíquete criado acima.

Especificando por meio de entidades de jogador

Para regras com o tipo de atributo “Player Entity”, os atributos são especificados por meio de uma chamada separada à API SetObjects. Isso permite que os dados sejam armazenados para um usuário, em vez de o título precisar especificá-los em cada chamada de criação de tíquete. Isso pode fazer mais sentido para valores que persistem para um usuário ou que não se pode confiar que os usuários enviem. Veja abaixo um exemplo dessa chamada 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"
    }
}

Uma fila com a configuração a seguir recuperaria o valor 16.0 para uso em sua regra DifferenceRule quando um tíquete fosse criado com esse jogador.

No campo Path, o primeiro item após a raiz é o ObjectName, permitindo que você escolha qual objeto armazenado referenciar.

"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
        }
    ]
}

Formatos especiais

A maioria das regras usa atributos que são cadeias de caracteres ou numéricos e que são simplesmente esses valores em formato JSON. As regras que exigem a passagem de atributos mais complexos estão listadas abaixo.

Regra de seleção de região

Uma regra de seleção de região exige uma matriz de medições de latência com o esquema especificado. O exemplo a seguir mostra o formato de atributo esperado para uma regra de seleção de região, junto com os dois atributos usados no exemplo de solicitação CreateMatchmakingTicket, para comparação.

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"
}

Neste exemplo, Latencies deve corresponder ao campo referenciado pelo campo Path na regra. Um exemplo de regra que usaria o campo Latencies está incluído na fila abaixo.

"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
        }
    ]
}

Ao usar a regra de seleção de região em uma fila que tenha a alocação de servidores habilitada, as regiões devem ser regiões válidas do Azure. Você pode encontrar a lista de regiões válidas do Azure aqui.

XBOX Services

PlayFab

Especificando na solicitação de criação de tíquete

Especificando por meio de entidades de jogador

Formatos especiais

Regra de seleção de região

​Especificando na solicitação de criação de tíquete

​Especificando por meio de entidades de jogador

​Formatos especiais

​Regra de seleção de região

Especificando na solicitação de criação de tíquete

Especificando por meio de entidades de jogador

Formatos especiais

Regra de seleção de região