Amazon GameLift
开发人员指南 (版本 )
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

Realtime Servers 客户端 API (C#) 参考:异步回调

使用此 C# Realtime 客户端 API 参考可帮助您准备多人游戏,以便与 Amazon GameLift 队组上部署的 Realtime Servers 配合使用。有关集成过程的详细信息,请参阅 Realtime Servers 集成路线图

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

回调方法在 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

与消息活动相关的信息。

Type: DataReceivedEventArgs

必需:是

返回值

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

OnGroupMembershipUpdated()

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

语法

public void OnGroupMembershipUpdated(GroupMembershipEventArgs groupMembershipEventArgs)

参数

groupMembershipEventArgs

与组成员资格活动相关的信息。

Type: GroupMembershipEventArgs

必需:是

返回值

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