实时服务器的脚本回调
通过在脚本中实施这些回调,您可提供自定义逻辑来响应事件。
init
初始化 Server 并接收 Realtime Server 接口。
语法
init(rtsession)
onMessage
当收到的消息发送到服务器时调用。
语法
onMessage(gameMessage)
onHealthCheck
调用它可设置游戏会话运行状况。默认情况下,运行状况是正常(或 true
)。可以实施此回调来执行自定义运行状况检查并返回状态。
语法
onHealthCheck()
onStartGameSession
在新游戏会话启动时调用,并传入一个游戏会话对象。
语法
onStartGameSession(session)
onProcessTerminate
在 服务终止服务器进程时调用。这可以用作从游戏会话中完全退出的触发器。无需调用 processEnding().
语法
onProcessTerminate()
onPlayerConnect
当玩家请求连接并通过初始验证时调用。
语法
onPlayerConnect(connectMessage)
onPlayerAccepted
当接受玩家连接时调用。
语法
onPlayerAccepted(player)
onPlayerDisconnect
当玩家通过发送断开连接请求或通过其他方式断开与游戏会话的连接时调用。
语法
onPlayerDisconnect(peerId)
onProcessStarted
当启动服务器进程时调用。此回调允许脚本执行准备托管游戏会话所需的任何自定义任务。
语法
onProcessStarted(args)
onSendToPlayer
当服务器上从一个玩家接收的消息要传递给另一个玩家时调用。此进程在传递消息之前运行。
语法
onSendToPlayer(gameMessage)
onSendToGroup
当服务器上从一个玩家接收的消息要传递给一个组时调用。此进程在传递消息之前运行。
语法
onSendToGroup(gameMessage))
onPlayerJoinGroup
当玩家发送加入组的请求时调用。
语法
onPlayerJoinGroup(groupId, peerId)
onPlayerLeaveGroup
当玩家发送离开组的请求时调用。
语法
onPlayerLeaveGroup(groupId, peerId)