Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Fügen Sie Ihrem Spiel-Backend-Service Code hinzu, um Matchmaking-Anfragen an a zu verwalten FlexMatch Matchmaker. Der Prozess der Anfrage FlexMatch Matchmaking ist identisch für Spiele, die verwenden FlexMatch mit Amazon GameLift Servers Hosting und für Spiele, die verwenden FlexMatch als eigenständige Lösung.
Um eine Matchmaking-Anfrage zu erstellen:
Rufen Sie den an Amazon GameLift Servers API StartMatchmaking. Jede Anforderung muss die folgenden Informationen enthalten.
- Matchmaker
-
Der Name der Matchmaking-Konfiguration, die für die Anfrage verwendet werden soll. FlexMatch platziert jede Anfrage in den Pool für den angegebenen Matchmaker, und die Anfrage wird auf der Grundlage der Konfiguration des Matchmakers verarbeitet. Dies umfasst das Erzwingen eines Zeitlimits, ob die Spieler-Akzeptanz von Matches angefordert werden soll, welche Warteschlange beim Platzieren einer resultierenden Spielsitzung verwendet werden soll usw. Weitere Informationen zu Matchmakern und Regelsätzen finden Sie unter Entwerfen Sie ein FlexMatch Ehevermittler.
- Ticket-ID
-
Eine der Anforderung zugewiesene eindeutige Ticket-ID. Alles im Zusammenhang mit der Anforderung, u. a. auch Ereignisse und Benachrichtigungen, referenziert die Ticket-ID.
- Spielerdaten
-
Liste der Spieler, für die Sie ein Match erstellen möchten. Wenn einer der Spieler in der Anforderung die Match-Anforderungen nicht erfüllt, führt die Matchmaking-Anforderung basierend auf den Match-Regeln und Latenzminimalen nie zu einem erfolgreichen Match. Sie können bis zu zehn Spieler in eine Match-Anforderung aufnehmen. Wenn eine Anfrage mehrere Spieler enthält, FlexMatch versucht, ein einzelnes Spiel zu erstellen und alle Spieler derselben Mannschaft zuzuweisen (zufällig ausgewählt). Wenn eine Anforderung zu viele Spieler enthält, um in eines der Match-Teams zu passen, wird die Anforderung nicht abgeglichen. Wenn Sie beispielsweise Ihren Matchmaker so eingerichtet haben, dass 2v2-Matches (zwei Teams mit zwei Spielern) erstellt werden, können Sie keine Matchmaking-Anforderung senden, die mehr als zwei Spieler enthält.
Anmerkung
Ein Spieler (identifiziert durch die Spieler-ID) kann jeweils nur in eine aktive Matchmaking-Anforderung aufgenommen werden. Wenn Sie eine neue Anforderung für einen Spieler erstellen, werden alle aktiven Matchmaking-Tickets mit derselben Spieler-ID automatisch storniert.
Schließen Sie für jeden aufgelisteten Spieler die folgenden Daten ein:
-
Spieler-ID — Jeder Spieler muss eine eindeutige Spieler-ID haben, die Sie generieren. Siehe Spieler generieren IDs.
-
Spielerattribute — Wenn der verwendete Matchmaker Spielerattribute verlangt, muss die Anfrage diese Attribute für jeden Spieler angeben. Die erforderlichen Spielerattribute sind im Regelsatz des Matchmakers definiert, in dem auch der Datentyp für das Attribut angegeben wird. Ein Spielerattribut ist nur dann optional, wenn der Regelsatz einen Standardwert für das Attribut angibt. Wenn die Match-Anforderung nicht die erforderlichen Attribute für alle Spieler bereitstellt, kann die Matching-Anforderung niemals erfolgreich sein. Weitere Informationen zu Matchmaker-Regelsätzen und Spielerattributen finden Sie unter Baue ein FlexMatch Regelsatz und FlexMatch Beispiele für Regelsätze.
-
Spielerlatenzen — Wenn der verwendete Matchmaker über eine Spielerlatenzregel verfügt, muss in der Anfrage die Latenz für jeden Spieler angegeben werden. Bei Player-Latenzdaten handelt es sich um eine Liste mit einem oder mehreren Werten pro Spieler. Dadurch wird die Latenzerfahrung des Spielers für Regionen in der Warteschlange des Matchmakers darstellt. Wenn in der Anforderung keine Latenzwerte für einen Spieler enthalten sind, kann der Spieler in kein Match aufgenommen werden. Die Anforderung schlägt fehl.
-
Um die Details der Spielanfrage abzurufen
Nachdem eine Spielanfrage gesendet wurde, können Sie die Details der Anfrage einsehen, indem Sie DescribeMatchmakingmit der Ticket-ID der Anfrage anrufen. Dieser Aufruf gibt Informationen zur Anforderung zurück, u. a. den aktuellen Status. Sobald eine Anforderung erfolgreich abgeschlossen wurde, enthält das Ticket die Informationen, die der Spiele-Client zum Verbinden mit dem Match benötigt.
Um eine Spielanfrage zu stornieren
Sie können eine Matchmaking-Anfrage jederzeit stornieren, indem Sie StopMatchmakingmit der Ticket-ID der Anfrage anrufen.
