kercylan98
42 lines
1.6 KiB
Go
42 lines
1.6 KiB
Go
package component
|
|
|
|
// Lockstep 定义了帧同步组件的接口，用于处理客户端之间的同步操作。
|
|
// 每个客户端需要拥有可比较的ID，同时需要定义帧数据的数据格式。
|
|
// - ClientID：客户端ID类型
|
|
// - Command：帧数据类型
|
|
//
|
|
// 客户端ID类型通常为玩家ID类型，即通常将玩家作为帧同步客户端使用。
|
|
// - 内置实现：components.Lockstep
|
|
// - 构建函数：components.NewLockstep
|
|
type Lockstep[ClientID comparable, Command any] interface {
|
|
// JoinClient 加入客户端
|
|
JoinClient(client LockstepClient[ClientID])
|
|
// JoinClientWithFrame 加入客户端，并且指定从特定帧开始
|
|
JoinClientWithFrame(client LockstepClient[ClientID], frameIndex int)
|
|
// LeaveClient 离开客户端
|
|
LeaveClient(clientId ClientID)
|
|
// StartBroadcast 开始广播
|
|
StartBroadcast()
|
|
// StopBroadcast 停止广播
|
|
StopBroadcast()
|
|
// AddCommand 增加指令
|
|
AddCommand(command Command)
|
|
// GetCurrentFrame 获取当前帧
|
|
GetCurrentFrame() int
|
|
// GetClientCurrentFrame 获取客户端当前帧
|
|
GetClientCurrentFrame(clientId ClientID) int
|
|
// GetFrameLimit 获取帧上限
|
|
GetFrameLimit() int
|
|
// GetFrames 获取所有帧数据
|
|
GetFrames() [][]Command
|
|
|
|
// RegLockstepStoppedEvent 当停止广播时将立即执行被注册的事件处理函数
|
|
RegLockstepStoppedEvent(handle LockstepStoppedEventHandle[ClientID, Command])
|
|
OnLockstepStoppedEvent()
|
|
}
|
|
|
|
type (
|
|
// LockstepStoppedEventHandle 帧同步停止广播事件处理函数
|
|
LockstepStoppedEventHandle[ClientID comparable, Command any] func(lockstep Lockstep[ClientID, Command])
|
|
)
|