本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
实时服务器的脚本回调
您可以通过在 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)