Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

实时服务器客户端 API (C#) 参考：异步回调

使用此 C# Realtime Client API 参考来帮助您准备多人游戏以用于部署在 Amazon GameLift 舰队上的实时服务器。有关集成过程的详细信息，请参阅 准备您的实时服务器。

游戏客户端需要实施这些回调方法来响应事件。实时服务器调用这些回调将与游戏相关的信息发送到游戏客户端。也可以使用实时服务器脚本中的自定义游戏逻辑实现相同事件的回调。请参阅实时服务器的脚本回调。

回调方法在 ClientEvents.cs 中定义。

OnOpen()

当服务器进程接受游戏客户端的连接请求并打开连接时调用。

语法

public void OnOpen()

参数

此方法未采用任何参数。

返回值

此方法不会返回任何内容。

OnClose()

当服务器进程终止与游戏客户端的连接时（例如，在游戏会话结束后）调用。

语法

public void OnClose()

参数

此方法未采用任何参数。

返回值

此方法不会返回任何内容。

OnError()

当实时客户端 API 请求发生故障时调用。可以自定义此回调以处理各种连接错误。

语法

private void OnError(byte[] args)

参数

此方法未采用任何参数。

返回值

此方法不会返回任何内容。

OnDataReceived()

当游戏客户端收到来自实时服务器的消息时调用。这是游戏客户端接收消息和通知的主要方法。

语法

public void OnDataReceived(DataReceivedEventArgs dataReceivedEventArgs)

参数

返回值

此方法不会返回任何内容。

OnGroupMembershipUpdated()

当玩家所属组的成员资格已更新时调用。客户端调用 RequestGroupMembership 时也会调用此回调。

语法

public void OnGroupMembershipUpdated(GroupMembershipEventArgs groupMembershipEventArgs)

参数

返回值

此方法不会返回任何内容。