PlayFab Multiplayer Servers와 통합 - XBOX Game Development Documentation

매치메이킹에는 결과 매치에 대한 게임 서버를 자동으로 만들 수 있는 옵션이 포함되어 있습니다. 할당된 서버는 큐의 구성에 구성된 빌드를 실행합니다. 시작 시 서버는 초기 플레이어 목록으로 매치의 멤버가 전달됩니다. 매치메이킹 큐는 단일 멀티플레이어 서버 빌드 또는 빌드 별칭에 연결됩니다.

매치메이킹과 서버의 직접 통합을 사용하기 위한 요구 사항

매치메이킹에서 멀티플레이어 서버를 할당하려면 먼저 빌드를 구성하고 배포해야 합니다. 선택적으로 빌드 별칭을 만들어 사용할 수도 있습니다. 빌드 별칭은 타이틀 사용에 더 많은 유연성을 허용하므로 선호됩니다. 여기서 제공하는 링크를 따라 Multiplayer Server 빌드 및 Multiplayer Server 빌드 별칭에 대한 자세한 정보를 얻으세요. 또한 매치메이킹은 빌드에 최적의 지역에서 매치가 할당될 수 있도록 큐에 지역 선택 규칙을 추가해야 합니다. 지역 선택 규칙에 전달되는 대기 시간 측정값은 빌드가 활성 상태인 지역과 일치해야 합니다. 지역 선택 규칙에 특성을 전달하는 방법에 대한 자세한 내용은 지역 선택 규칙을 참조하세요.

큐에 대한 서버 할당 활성화

큐에 대한 서버 할당을 사용 설정하려면 큐 구성 페이지에서 Enable server allocation 확인란을 사용 설정해야 합니다. 사용 설정한 후에는 Build alias 또는 Build Id를 선택합니다. 큐에서 사용할 올바른 값을 드롭다운에서 선택합니다. 이 기능을 사용 설정하면 매치메이킹은 큐 내에서 만들어진 모든 매치에 대해 서버를 할당하려고 시도합니다. 다음 예시는 Build Id를 사용하는 멀티플레이어 서버 통합이 있는 큐의 구성이 어떻게 보이는지 나타냅니다.

"MatchmakingQueue": {
    "Name": "ServerEnabledQueue",
    "MinMatchSize": 2,
    "MaxMatchSize": 2,
    "ServerAllocationEnabled": true,
    "BuildId": "88b3e315-829c-4b6d-9872-74f427ad5331",
	"RegionSelectionRule": {
		"MaxLatency": 1000,
		"Path": "Latencies",
		"Weight": 1.0,
		"Name": "RegionSelectionRule"
	}
}

빌드 별칭을 사용하는 동일한 예시입니다.

"MatchmakingQueue": {
    "Name": "ServerEnabledQueue",
    "MinMatchSize": 2,
    "MaxMatchSize": 2,
    "ServerAllocationEnabled": true,
    "BuildAliasParams": {
        "AliasId": "d14e2ac7-ea51-47aa-a7ba-cc427ab74f9s"
    },
	"RegionSelectionRule": {
		"MaxLatency": 1000,
		"Path": "Latencies",
		"Weight": 1.0,
		"Name": "RegionSelectionRule"
	}
}

서버 할당이 사용 설정되어 있어도 매치메이킹에 대한 호출 흐름은 동일하게 유지됩니다. 매치메이킹이 매치에 대한 서버를 할당하면 GetMatch를 호출하여 매치 개체 자체에서 결과 서버 세부 정보를 읽을 수 있습니다. 서버 할당이 사용 설정된 큐에 대한 GetMatch 호출에 대한 샘플 응답이 아래에 제공됩니다.

{
    "MatchId": "7c36330d-46b5-443f-8d8f-10390bce09d5",
    "Members": [{
        "TeamId": "",
        "Entity": {
            "Id": "67282A13A1A58910",
            "Type": "title_player_account",
            "TypeString": "title_player_account"
        },
        "Attributes": {
            "DataObject": null,
            "EscapedDataObject": "{\"StringEqualityRulePath\":\"0bc42969-76b1-4dcb-871d-d6e19cee741b\"}"
        }
    },
    {
        "TeamId": "",
        "Entity": {
            "Id": "6DB2B17FD21CC230",
            "Type": "title_player_account",
            "TypeString": "title_player_account"
        },
        "Attributes": {
            "DataObject": null,
            "EscapedDataObject": "{\"StringEqualityRulePath\":\"0bc42969-76b1-4dcb-871d-d6e19cee741b\"}"
        }
    }],
    "RegionPreferences": ["WestUs", " EastUs"],
    "ServerDetails": {
        "IPV4Address": "40.76.31.170",
        "Ports": [{
            "Name": "game_port",
            "Num": 30003
        }]
    }
}

클라이언트는 응답의 서버 세부 정보 섹션에서 IP와 포트를 사용하여 서버에 연결할 수 있습니다. 클라이언트를 멀티플레이어 서버에 연결하는 방법에 대한 자세한 내용은 클라이언트를 서버에 연결을 참조하세요.

빌드의 한 지역에 용량이 부족해지면 매치메이킹은 해당 지역의 큐에 대한 매치를 할당할 수 없습니다. 매치메이킹은 티켓이 만료될 때까지 할당을 계속 재시도합니다. 멀티플레이어 용량을 늘리려면 증가된 코어 제한 및 추가 Azure 지역 액세스를 참조하세요.

게임 서버에 전달되는 정보

다음은 매치메이킹이 서버에 전달하는 정보 목록입니다.

SessionId - 서버의 SessionId는 매치의 MatchId와 같습니다.
InitialPlayers - 이 값은 매치의 멤버 목록으로 설정됩니다. 플레이어 목록은 GSDK를 사용하여 게임에서 읽을 수 있습니다.
PreferredRegions - 이 필드는 매치의 RegionPreferences 필드로 설정됩니다. 게임 서버 서비스는 이 목록에서 서버에 적합한 지역을 선택합니다.

매치메이킹은 게임 서버에 티켓 특성을 전달하지 않습니다. 게임이 서버에서 티켓 특성에 액세스해야 하는 경우 ReturnMemberAttributes 헤더를 true로 하여 GetMatch를 호출하여 액세스할 수 있습니다.

최근에 서버 할당 중 큐 이름 전달을 사용 설정했습니다. 이 기능은 미리 보기 상태이며 여기에서 자세한 내용을 읽을 수 있습니다.

​매치메이킹과 서버의 직접 통합을 사용하기 위한 요구 사항

​큐에 대한 서버 할당 활성화

​게임 서버에 전달되는 정보

매치메이킹과 서버의 직접 통합을 사용하기 위한 요구 사항

큐에 대한 서버 할당 활성화

게임 서버에 전달되는 정보