snapbuf

package

v0.9.0 Latest Latest Go to latest Published: Aug 19, 2026 License: Apache-2.0 Imports: 1 Imported by: 0

Details

Package snapbuf 提供固定深度的环形快照缓冲,用于延迟补偿/server rewind。

This section is empty.

This section is empty.

This section is empty.

type Ring[S any] struct {
	// contains filtered or unexported fields
}

Ring 保存最近 depth 帧的快照(S 由业务定义,如 world 副本)。

func New[S any](depth int) *Ring[S]

New 创建深度为 depth 的环形缓冲(depth<=0 时取 64)。

func (r *Ring[S]) At(frame uint64) (S, bool)

At 精确查找 frame 对应的快照。

func (r *Ring[S]) Latest() (frame uint64, snap S, ok bool)

Latest 返回最新帧号与快照。

func (r *Ring[S]) Len() int

Len 返回当前缓冲中的帧数(<= depth)。

func (r *Ring[S]) Nearest(frame uint64) (S, uint64, bool)

Nearest 返回 <= frame 的最近快照(用于 RTT 补偿)。

func (r *Ring[S]) Push(frame uint64, snap S)

Push 写入 frame 对应的快照;frame 应单调递增。