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