Amazon GameLift Service API-Referenz (AWSSDK) - Amazon GameLift
GameLiftAmazon-Hosting-Ressourcen einrichten und verwaltenStarte Spielsitzungen und schließe dich Spielern an

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.

Amazon GameLift Service API-Referenz (AWSSDK)

Dieses Thema enthält eine aufgabenbasierte Liste von API-Vorgängen zur Verwendung mit von Amazon GameLift verwalteten Hosting-Lösungen, einschließlich des Hostings für benutzerdefinierte Spieleserver und Echtzeitserver. Diese Operationen sind in das AWS SDK im aws.gamelift Namespace gepackt. Laden Sie das AWS SDK herunter oder sehen Sie sich die GameLift Amazon-API-Referenzdokumentation an.

Die API umfasst zwei Operationssätze für das Hosting verwalteter Spiele:

Die Amazon GameLift Service API enthält auch Operationen zur Verwendung mit anderen GameLift Amazon-Tools und -Lösungen. Eine Liste der FleetIQ APIs finden Sie unter FleetIQ API-Aktionen. Eine Liste der FlexMatch APIs für Matchmaking finden Sie unter FlexMatchAPI-Aktionen.

GameLiftAmazon-Hosting-Ressourcen einrichten und verwalten

Rufen Sie diese Operationen auf, um Hosting-Ressourcen für Ihre Spielserver zu konfigurieren, die Kapazität zu skalieren, um den Anforderungen der Spieler gerecht zu werden, auf Leistungs- und Auslastungskennzahlen zuzugreifen und vieles mehr. Diese API-Operationen werden mit Spielservern verwendet, die auf Amazon gehostet werdenGameLift, einschließlich Echtzeitservern. Sie können die GameLiftAmazon-Konsole für die meisten Ressourcenverwaltungsaufgaben verwenden, oder Sie können den Service mithilfe des Tools AWS Command Line Interface (AWS CLI) oder des AWS SDK aufrufen.

Spielserver für den Einsatz vorbereiten

Laden Sie den Gameservercode Ihres Spiels hoch und konfigurieren Sie ihn, um die Bereitstellung und den Start auf Hosting-Ressourcen vorzubereiten.

Benutzerdefinierte Gameserver-Builds verwalten

  • upload-build — Laden Sie Build-Dateien von einem lokalen Pfad hoch und erstellen Sie eine neue GameLift Amazon-Build-Ressource. Dieser Vorgang, der nur als AWS CLI Befehl verfügbar ist, ist die gebräuchlichste Methode zum Hochladen von Gameserver-Builds.

  • CreateBuild— Erstellen Sie einen neuen Build mit Dateien, die in einem Amazon S3-Bucket gespeichert sind.

  • ListBuilds— Ruft eine Liste aller Builds ab, die in eine GameLift Amazon-Region hochgeladen wurden.

  • DescribeBuild— Ruft Informationen ab, die einem Build zugeordnet sind.

  • UpdateBuild— Ändern Sie die Build-Metadaten, einschließlich des Build-Namens und der Version.

  • DeleteBuild— Entferne einen Build von AmazonGameLift.

Konfigurationsskripts für Echtzeitserver verwalten

  • CreateScript— Laden Sie JavaScript Dateien hoch und erstellen Sie eine neue GameLift Amazon-Skriptressource.

  • ListScripts— Holen Sie sich eine Liste aller Echtzeit-Skripts, die in eine GameLift Amazon-Region hochgeladen wurden.

  • DescribeScript— Ruft Informationen ab, die einem Echtzeit-Skript zugeordnet sind.

  • UpdateScript— Ändern Sie die Skriptmetadaten und laden Sie überarbeitete Skriptinhalte hoch.

  • DeleteScript— Entfernen Sie ein Realtime-Skript von AmazonGameLift.

Rechenressourcen für das Hosting einrichten

Konfiguriere Hosting-Ressourcen und stelle sie mit deinem Gameserver-Build oder deinem Echtzeitkonfigurationsskript bereit.

Flotten erstellen und verwalten

  • CreateFleet— Konfigurieren und implementieren Sie eine neue GameLift Amazon-Flotte von Computerressourcen für den Betrieb Ihrer Spieleserver. Nach der Bereitstellung werden die Spieleserver automatisch wie konfiguriert gestartet und sind bereit, Spielesitzungen zu hosten.

  • ListFleets— Holen Sie sich eine Liste aller Flotten in einer GameLift Amazonasregion.

  • DeleteFleet— Schließe eine Flotte ab, die keine Spielserver mehr betreibt oder Spieler hostet.

  • Flottenstandorte anzeigen/aktualisieren.

    • CreateFleetLocations— Fügen Sie einer bestehenden Flotte, die mehrere Standorte unterstützt, abgelegene Standorte hinzu

    • DescribeFleetLocationAttributes— Holen Sie sich eine Liste aller entfernten Standorte für eine Flotte und sehen Sie sich den aktuellen Status jedes Standorts an.

    • DeleteFleetLocations— Entferne Standorte aus einer Flotte, die mehrere Standorte unterstützt.

  • Anzeigen/Aktualisieren von Flottenkonfigurationen.

Flottenkapazität verwalten

  • DescribeEC2 InstanceLimits — Ruft die maximale Anzahl von Instanzen ab, die für das aktuelle AWS Konto und die aktuelle Nutzungsstufe zulässig sind.

  • DescribeFleetCapacity— Ruft die aktuellen Kapazitätseinstellungen für die Heimatregion einer Flotte ab.

  • DescribeFleetLocationCapacity— Rufen Sie die aktuellen Kapazitätseinstellungen für jeden Standort einer Flotte mit mehreren Standorten ab.

  • UpdateFleetCapacity— Passen Sie die Kapazitätseinstellungen für eine Flotte manuell an.

  • Richten Sie die automatische Skalierung ein:

    • PutScalingPolicy— Schalten Sie die zielbasierte automatische Skalierung ein oder erstellen Sie eine benutzerdefinierte Autoskalierungsrichtlinie oder aktualisieren Sie eine bestehende Richtlinie.

    • DescribeScalingPolicies— Rufen Sie eine bestehende Auto-Scaling-Richtlinie ab.

    • DeleteScalingPolicy— Löschen Sie eine Richtlinie zur automatischen Skalierung und verhindern Sie, dass sie sich auf die Kapazität einer Flotte auswirkt.

    • StartFleetActions— Starten Sie die Richtlinien für die automatische Skalierung einer Flotte neu.

    • StopFleetActions— Setzen Sie die Richtlinien für die automatische Skalierung einer Flotte aus.

Überwachen Sie die Flottenaktivität.

  • DescribeFleetUtilization— Ruft Statistiken über die Anzahl der Serverprozesse, Spielsitzungen und Spieler ab, die derzeit in einer Flotte aktiv sind.

  • DescribeFleetLocationUtilization— Rufen Sie Nutzungsstatistiken für jeden Standort in einer Flotte mit mehreren Standorten ab.

  • DescribeFleetEvents— Zeigt protokollierte Ereignisse für eine Flotte während eines bestimmten Zeitraums an.

  • DescribeGameSessions— Ruft Metadaten der Spielsitzung ab, einschließlich der Laufzeit eines Spiels und der aktuellen Spieleranzahl.

Einrichten von Warteschlangen für optimale Platzierung der Spielsitzung

Richten Sie Warteschlangen für mehrere Flotten und Regionen ein, um Spielsitzungen mit den besten verfügbaren Hosting-Ressourcen für Kosten, Latenz und Ausfallsicherheit zu platzieren.

  • CreateGameSessionQueue— Erstelle eine Warteschlange, die bei der Bearbeitung von Anfragen für Platzierungen in Spielsitzungen verwendet werden kann.

  • DescribeGameSessionQueues— Ruft Warteschlangen für Spielsitzungen ab, die in einer GameLift Amazon-Region definiert wurden.

  • UpdateGameSessionQueue— Ändert die Konfiguration einer Warteschlange für Spielsitzungen.

  • DeleteGameSessionQueue— Entferne eine Warteschlange für Spielsitzungen aus der Region.

Verwalten von Aliase

Verwenden Sie Aliase, um Ihre Flotten darzustellen oder ein zum Terminal alternatives Ziel zu erstellen. Aliase sind nützlich beim Übergang von Spielaktivitäten von einer Flotte zu einer anderen, wie z. B. bei Aktualisierungen des Spielserver-Builds.

  • CreateAlias— Definieren Sie einen neuen Alias und weisen Sie ihn optional einer Flotte zu.

  • ListAliases— Ruft alle Flottenaliase ab, die in einer GameLift Amazon-Region definiert sind.

  • DescribeAlias— Ruft Informationen zu einem vorhandenen Alias ab.

  • UpdateAlias— Ändern Sie die Einstellungen für einen Alias, indem Sie ihn beispielsweise von einer Flotte zu einer anderen umleiten.

  • DeleteAlias— Entferne einen Alias aus der Region.

  • ResolveAlias— Ruft die Flotten-ID ab, auf die ein bestimmter Alias verweist.

Zugreifen auf Hosting-Instances

Zeigen Sie Informationen zu einzelnen Instances in einer Flotte an oder fordern Sie zur Fehlerbehebung Fernzugriff auf eine bestimmte Flotteninstance an.

  • DescribeInstances— Rufen Sie Informationen zu jeder Instance in einer Flotte ab, einschließlich Instance-ID, IP-Adresse, Standort und Status.

  • GetInstanceAccess— Fordern Sie die Zugangsdaten an, die für die Remoteverbindung zu einer bestimmten Instance in einer Flotte erforderlich sind.

VPC-Peering einrichten

Erstellen und verwalten Sie VPC-Peering-Verbindungen zwischen Ihren GameLift Amazon-Hosting-Ressourcen und anderen AWS Ressourcen.

Starte Spielsitzungen und schließe dich Spielern an

Rufe diese Operationen von deinem Spielclient aus auf, um neue Spielsitzungen zu starten, Informationen über bestehende Spielsitzungen abzurufen und Spieler zu Spielsitzungen zu begleiten. Diese Operationen sind für benutzerdefinierte Spieleserver vorgesehen, die auf Amazon gehostet werdenGameLift. Wenn du Echtzeitserver verwendest, verwalte Spielsitzungen mit demReferenz zur Realtime Server-Client-API (C#).

  • Starten Sie neue Spielsitzungen für einen oder mehrere Spieler.

    • StartGameSessionPlacement— Bitten GameLift Sie Amazon, die besten verfügbaren Hosting-Ressourcen zu finden und eine neue Spielsitzung zu starten. Dies ist die bevorzugte Methode, um neue Spielsitzungen zu erstellen. Es stützt sich auf Warteschlangen für Spielsitzungen, um die Verfügbarkeit von Hostings in mehreren Regionen zu verfolgen, und verwendet FleetIQ-Algorithmen, um Platzierungen auf der Grundlage der Spielerlatenz, der Hosting-Kosten, des Standorts usw. zu priorisieren.

    • DescribeGameSessionPlacement— Informieren Sie sich über Details und Status einer Platzierungsanfrage.

    • StopGameSessionPlacement— Stornieren Sie eine Platzierungsanfrage.

    • CreateGameSession— Starte eine neue, leere Spielsitzung an einem bestimmten Flottenstandort. Durch diesen Vorgang haben Sie mehr Kontrolle darüber, wo Sie die Spielsitzung starten, anstatt FleetIQ zur Bewertung der Platzierungsoptionen zu verwenden. Sie müssen der neuen Spielsitzung in einem separaten Schritt Spieler hinzufügen.

  • Binden Sie Spieler in bestehende Spielsitzungen ein. Finden Sie laufende Spielsitzungen mit verfügbaren Spielerplätzen und reservieren Sie sie für neue Spieler.

    • CreatePlayerSession— Reserviere einen freien Slot, damit ein Spieler an einer Spielsitzung teilnehmen kann.

    • CreatePlayerSessions— Reservieren Sie offene Plätze für mehrere Spieler, um an einer Spielsitzung teilzunehmen.

  • Arbeiten Sie mit Spielsitzungs- und Spielersitzungsdaten. Verwalte Informationen zu Spielsitzungen und Spielersitzungen.

    • SearchGameSessions— Fordere anhand einer Reihe von Suchkriterien eine Liste der aktiven Spielsitzungen an.

    • DescribeGameSessions— Ruft Metadaten für bestimmte Spielsitzungen ab, einschließlich der aktiven Zeit und der aktuellen Spieleranzahl.

    • DescribeGameSessionDetails— Ruft Metadaten, einschließlich der Schutzeinstellungen für Spielsitzungen, für eine oder mehrere Spielsitzungen ab.

    • DescribePlayerSessions— Informieren Sie sich über die Spieleraktivitäten, einschließlich Status, Spielzeit und Spielerdaten.

    • UpdateGameSession— Ändere die Einstellungen der Spielsitzung, z. B. die maximale Spielerzahl und die Teilnahmerichtlinien.

    • GetGameSessionLogUrl— Ruft den Speicherort der gespeicherten Logs für eine Spielsitzung ab.