Référence de l'API client (C#) de Realtime Servers : rappels asynchrones - Amazon GameLift

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Référence de l'API client (C#) de Realtime Servers : rappels asynchrones

Utilisez cette référence d'API client C# Realtime pour vous aider à préparer votre jeu multijoueur en vue de son utilisation avec les serveurs en temps réel déployés sur les flottes Amazon. GameLift Pour plus d'informations sur le processus d'intégration, consultez Préparez votre serveur en temps réel.

Un client de jeu a besoin de mettre en œuvre ces méthodes de rappel pour répondre aux événements. Le serveur Realtime invoque ces rappels pour envoyer des informations relatives au jeu au client du jeu. Les rappels pour les mêmes événements peuvent également être implémentés avec une logique de jeu personnalisée dans le script du serveur en temps réel. Consultez Rappels de script pour les serveurs en temps réel.

Les méthodes de rappel sont définies dans ClientEvents.cs.

OnOpen()

Appelée lorsque le processus serveur accepte la demande de connexion d'un client de jeu et ouvre une connexion.

Syntaxe

public void OnOpen()

Paramètres

Cette méthode ne prend aucun paramètre.

Valeur renvoyée

Cette méthode ne renvoie rien.

OnClose()

Appelée lorsque le processus serveur met fin à la connexion avec le client de jeu, comme lorsqu'une session de jeu se termine.

Syntaxe

public void OnClose()

Paramètres

Cette méthode ne prend aucun paramètre.

Valeur renvoyée

Cette méthode ne renvoie rien.

OnError()

Appelée lorsqu'un échec se produit pour une demande d'API du client en temps réel. Ce rappel peut être personnalisé afin de prendre en charge une grande variété d'erreurs de connexion.

Syntaxe

private void OnError(byte[] args)

Paramètres

Cette méthode ne prend aucun paramètre.

Valeur renvoyée

Cette méthode ne renvoie rien.

OnDataReceived()

Invoqué lorsque le client du jeu reçoit un message du serveur Realtime. Il s'agit de la méthode principale de réception de messages et de notifications par un client de jeu.

Syntaxe

public void OnDataReceived(DataReceivedEventArgs dataReceivedEventArgs)

Paramètres

dataReceivedEventArgs

Informations liées à l'activité de messages.

Type: DataReceivedEventArgs

Obligatoire : oui

Valeur renvoyée

Cette méthode ne renvoie rien.

OnGroupMembershipUpdated()

Appelée lorsque l'adhésion à un groupe auquel le joueur appartient a été mise à jour. Ce rappel est également invoqué lorsqu'un client appelle RequestGroupMembership.

Syntaxe

public void OnGroupMembershipUpdated(GroupMembershipEventArgs groupMembershipEventArgs)

Paramètres

groupMembershipEventArgs

Informations liées à l'activité d'adhésion d'un groupe.

Type: GroupMembershipEventArgs

Obligatoire : oui

Valeur renvoyée

Cette méthode ne renvoie rien.