Packet Loss Notification

丢包通知

特征

• 关于每个丢失的不可靠数据包的通知
• 与传输无关
• 简单的记录器

概述

该项目提供了一个帮助程序类，用于检测和通知丢失的不可靠数据包。这是许多高级同步策略的重要组成部分。例如，最终一致性就使用它。

为简单起见，服务器仅支持一个客户端。

概述

探测器

检测的工作原理是将该标头添加到每个发送的数据包中：

• ushort本地序列 ID
• ushort最后一个远程序列 ID
• uint 32 个先前远程序列 ID 的位掩码

工作流程是这样的：

• 对等连接：
• • 在 helper 中调用AddPeer
• 向对等点发送数据包：
• • 获取空 BitBuffer
• • 调用AddHeaderForPeerId
• • 将实际有效负载写入 BitBuffer
• • 将 BitBuffer 的内容复制到分配的内存
• • 清除位缓冲区
• • 调用入EnqueueData
• • • 如果结果为 TRUE
• • • • 向对等方发送数据包
• • • 如果结果为 FALSE
• • • • 断开该对等点的连接
• 从 Peer 收到的数据包：
• • 将数据包的内容放入 BitBuffer
• • 用它调用ReadHeaderOfPeerId
• • • 如果结果为 TRUE
• • • • 读取实际负载
• 定期：
• • 调用ExecuteLostPackets
• 丢失数据包时：
• • 获取数据到BitBuffer
• • 调用ClearHeader
• • 读取实际负载
• 对等体断开连接：
• • 调用RemovePeer

如果数据包被视为丢失，则意味着它很可能已丢失。当数据包被视为已到达时，则确定已到达。

ILossHandler.OnPacketLost将为每个丢失的数据包以及每个在对等点断开连接时排队并仍在跟踪的数据包调用。

如果存在LOSS_DETECTOR_DEBUG符号，则所有丢失的数据包序列将输出到记录器。

方法

• void LossDetector ( ILossHandler handler, ushort maxPeerCount, ushort ackWindow ) - 将为每个丢失的数据包调用ILossHandler的实现。 MaxPeerCount - 连接到该对等点的最大对等点计数。 AckWindow - 每个对等点的本地跟踪数据包的最大计数。
• void AddPeer ( ushort peerId ) - 清除该peerId 的序列号。
• voidRemovePeer ( ushort peerId ) - 将该peerId的每个跟踪数据包排队为丢失。
• void AddHeaderForPeerId ( ushort peerId, BitBuffer data ) - 将标头信息写入该 peerId 的 BitBuffer 中。
• bool ReadHeaderOfPeerId ( ushort peerId, BitBuffer data ) - 从 BitBuffer 读取标头并检测是否有任何跟踪的数据包已被 ACK 或 NACK。在 ACK 检测器的情况下，将释放分配的内存。如果该peerId 的sequenceId 大于lastSequenceId，则返回True。
• bool EnqueueData ( ushort peerId, PacketData data ) - 尝试将数据放入该对等点的跟踪数据包队列中。如果队列已满，则返回 False。也许您已经太长时间没有收到来自另一个对等点的数据包，应该断开他的连接。
• void ExecuteLostPackets () - 将所有缓冲的丢失数据包转发到处理程序并释放其分配的内存。
• void ClearHeader ( BitBuffer data ) - 从 BitBuffer 中清除标头。

如果存在LOSS_DETECTOR_DEBUG符号，则这些方法也可用：

• void GetDebugString ( StringBuilder builder ) - 将每个peerId 的缓冲区的完整状态写入StringBuilder。
• void GetDebugString ( ushort peerId, StringBuilder builder ) - 写入该peerId 的缓冲区状态。

依赖关系

• 团结2019.1
• NetStack.序列化

Helper 本身与传输无关，但示例项目使用 ENet

• ENet CSharp 2.2.6

制作人员

fholm - 网络大师 - 帮了很多忙。