本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Amazon GameLift ServersRealtime客户端 API (C#) 参考:异步回调
使用此 C# Realtime 客户端 API 参考来帮助您准备多人游戏,以便在Amazon GameLift Servers舰队上Amazon GameLift ServersRealtime部署时使用。
游戏客户端需要实施这些回调方法来响应事件。Realtime服务器调用这些回调以将游戏相关信息发送到游戏客户端。相同事件的回调也可使用Realtime服务器脚本中的自定义游戏逻辑实施。请参阅的脚本回调 Amazon GameLift ServersRealtime。
回调方法在 ClientEvents.cs
中定义。
OnOpen()
当服务器进程接受游戏客户端的连接请求并打开连接时调用。
语法
public void OnOpen()
参数
此方法未采用任何参数。
返回值
此方法不会返回任何内容。
OnClose()
当服务器进程终止与游戏客户端的连接时(例如,在游戏会话结束后)调用。
语法
public void OnClose()
参数
此方法未采用任何参数。
返回值
此方法不会返回任何内容。
OnError()
当实时客户端 API 请求发生故障时调用。可以自定义此回调以处理各种连接错误。
语法
private void OnError(byte[] args)
参数
此方法未采用任何参数。
返回值
此方法不会返回任何内容。
OnDataReceived()
当游戏客户端收到来自Realtime服务器的消息时调用。这是游戏客户端接收消息和通知的主要方法。
语法
public void OnDataReceived(DataReceivedEventArgs dataReceivedEventArgs)
参数
- dataReceivedEventArgs
-
与消息活动相关的信息。
必需:是
返回值
此方法不会返回任何内容。
OnGroupMembershipUpdated()
当玩家所属组的成员资格已更新时调用。客户端调用 RequestGroupMembership
时也会调用此回调。
语法
public void OnGroupMembershipUpdated(GroupMembershipEventArgs groupMembershipEventArgs)
参数
- groupMembershipEventArgs
-
与组成员资格活动相关的信息。
必需:是
返回值
此方法不会返回任何内容。