Referenz zur Realtime Server-Client-API (C#): Asynchrone Callbacks - Amazon GameLift

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.

Referenz zur Realtime Server-Client-API (C#): Asynchrone Callbacks

Verwenden Sie diese C#-Realtime-Client-API-Referenz, um Ihr Multiplayer-Spiel für die Verwendung mit Echtzeitservern vorzubereiten, die auf Amazon-Flotten eingesetzt werden. GameLift Weitere Informationen zu dem Integrationsprozess finden Sie unter Bereite deinen Realtime-Server vor.

Ein Spiele-Client muss diese Callback-Methoden implementieren, um auf Ereignisse reagieren zu können. Der Realtime-Server ruft diese Callbacks auf, um spielbezogene Informationen an den Spielclient zu senden. Callbacks für dieselben Ereignisse können auch mit benutzerdefinierter Spiellogik im Realtime-Serverskript implementiert werden. Siehe Script-Callbacks für Echtzeitserver.

Callback-Methoden sind in ClientEvents.cs definiert.

OnOpen()

Wird aufgerufen, wenn der Serverprozess die Verbindungsanfrage des Spiele-Clients akzeptiert und eine Verbindung öffnet.

Syntax

public void OnOpen()

Parameter

Diese Methode verwendet keine Parameter.

Rückgabewert

Diese Methode gibt nichts zurück.

OnClose()

Wird aufgerufen, wenn der Serverprozess die Verbindung mit dem Spiele-Client beendet, z. B. wenn eine Spielsitzung endet.

Syntax

public void OnClose()

Parameter

Diese Methode verwendet keine Parameter.

Rückgabewert

Diese Methode gibt nichts zurück.

OnError()

Wird aufgerufen, wenn ein Fehler für eine Realtime Client-API-Anfrage auftritt. Dieser Callback kann an eine Vielzahl von Verbindungsfehlern angepasst werden.

Syntax

private void OnError(byte[] args)

Parameter

Diese Methode verwendet keine Parameter.

Rückgabewert

Diese Methode gibt nichts zurück.

OnDataReceived()

Wird aufgerufen, wenn der Spielclient eine Nachricht vom Realtime-Server empfängt. Dies ist Methode, mit der die meisten Nachrichten und Benachrichtigungen von einem Spiele-Client empfangen werden.

Syntax

public void OnDataReceived(DataReceivedEventArgs dataReceivedEventArgs)

Parameter

dataReceivedEventArgs

Information im Zusammenhang mit Nachrichten-Aktivitäten.

Typ: DataReceivedEventArgs

Erforderlich: Ja

Rückgabewert

Diese Methode gibt nichts zurück.

OnGroupMembershipUpdated()

Wird aufgerufen, wenn die Mitgliedschaft für eine Gruppe, der der Spieler angehört, aktualisiert wurde. Dieser Callback wird auch aufgerufen, wenn ein Client RequestGroupMembership aufruft.

Syntax

public void OnGroupMembershipUpdated(GroupMembershipEventArgs groupMembershipEventArgs)

Parameter

groupMembershipEventArgs

Informationen im Zusammenhang mit Gruppenmitgliedschaftsaktivitäten.

Typ: GroupMembershipEventArgs

Erforderlich: Ja

Rückgabewert

Diese Methode gibt nichts zurück.