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

Realtime Servers 的脚本回调

通过在Realtime脚本中实施这些回调,您可提供自定义逻辑来响应事件。

init

初始化 Realtime Server 并接收 Realtime Server 接口。

语法

init(rtsession)

onMessage

当收到的消息发送到服务器时调用。

语法

onMessage(gameMessage)

onHealthCheck

调用它可设置游戏会话运行状况。默认情况下,运行状况是正常(或 true)。可以实施此回调来执行自定义运行状况检查并返回状态。

语法

onHealthCheck()

onStartGameSession

在新游戏会话启动时调用,并传入一个游戏会话对象。

语法

onStartGameSession(session)

onProcessTerminate

在 Amazon GameLift 服务终止服务器进程时调用。这可以用作从游戏会话中完全退出的触发器。无需调用 processEnding().

语法

onProcessTerminate()

onPlayerConnect

当玩家请求连接并通过初始验证时调用。

语法

onPlayerConnect(connectMessage)

onPlayerAccepted

当接受玩家连接时调用。

语法

onPlayerAccepted(player)

onPlayerDisconnect

当玩家通过发送断开连接请求或通过其他方式断开与游戏会话的连接时调用。

语法

onPlayerDisconnect(peerId)

onProcessStarted

当启动服务器进程时调用。此回调允许脚本执行准备托管游戏会话所需的任何自定义任务。

语法

onProcessStarted(args)

onSendToPlayer

当服务器上从一个玩家接收的消息要传递给另一个玩家时调用。此进程在传递消息之前运行。

语法

nSendToPlayer(gameMessage)

onSendToGroup

当服务器上从一个玩家接收的消息要传递给一个组时调用。此进程在传递消息之前运行。

语法

onSendToGroup(gameMessage))

onPlayerJoinGroup

当玩家发送加入组的请求时调用。

语法

onPlayerJoinGroup(groupId, peerId)

onPlayerLeaveGroup

当玩家发送离开组的请求时调用。

语法

onPlayerLeaveGroup(groupId, peerId)