实时服务器的脚本回调 - 亚马逊 GameLift
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

实时服务器的脚本回调

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

初始化

初始化实时服务器并接收实时服务器接口。

语法

init(rtsession)

onMessage

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

语法

onMessage(gameMessage)

onHealthCheck

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

语法

onHealthCheck()

onStartGame会话

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

语法

onStartGameSession(session)

onProcessTerminate

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

语法

onProcessTerminate()

onPlayerConnect

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

语法

onPlayerConnect(connectMessage)

onPlayerAccepted

当接受玩家连接时调用。

语法

onPlayerAccepted(player)

onPlayerDisconnect

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

语法

onPlayerDisconnect(peerId)

onProcessStarted

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

语法

onProcessStarted(args)

onSendTo玩家

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

语法

onSendToPlayer(gameMessage)

onSendTo小组

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

语法

onSendToGroup(gameMessage))

onPlayerJoin小组

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

语法

onPlayerJoinGroup(groupId, peerId)

onPlayerLeave小组

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

语法

onPlayerLeaveGroup(groupId, peerId)