NackTracker 是 WebRTC NetEq 模块中用于跟踪丢失的 RTP 数据包并生成 NACK(Negative Acknowledgement,)列表的核心类。
它的主要目的是在网络状况不佳导致丢包时,通过请求发送端重传丢失的数据包来恢复音频质量,同时避免请求那些已经“过时”(即播放时间已过或即将到达,重传来不及)的数据包。
NackTracker 是一个智能的丢包跟踪器。它不仅仅是记录哪些包没收到,更重要的是基于时间的决策引擎。它通过实时估算每个丢失包的“剩余寿命”(距离播放还有多久),结合网络 RTT,动态决定哪些包值得重传(Missing),哪些包应该放弃(Late 或过期),从而在恢复音频质量和控制延迟/带宽之间取得平衡。
一、核心概念:Missing vs. Late
NackTracker将未到达的数据包分为两类:
• Late (迟到): 数据包虽然还没到,但预计在其播放时间之前还有可能到达。此时不请求重传,继续等待。
• Missing (丢失): 数据包不仅没到,而且根据当前的网络往返时间(RTT)估计,即使现在请求重传,在播放时刻之前也大概率无法到达;或者该包已经严重滞后,不再有价值。此时将其标记为 Missing,并加入 NACK 列表请求重传。
二, 关键成员
2.1, nack_list_ (NackList):
• 一个 std::map,Key 是 RTP 序列号,Value 是 NackElement。
• NackElement 包含:
• time_to_play_ms: 估计该包还需要多少毫秒才被播放。
• estimated_timestamp: 估计该包的 RTP 时间戳。
• is_missing: 标记该包是“丢失”还是“迟到”。
2.2, nack_threshold_packets_:
• 阈值。如果当前收到的最新包序列号为 ,那么序列号小于 且未收到的包被视为 Missing。序列号在 之间的未收到包被视为 Late。
2.3 max_nack_list_size_:
• NACK 列表的最大长度限制。防止内存无限增长,只保留最近的丢失包。
2.4 samples_per_packet_ & sample_rate_khz_:
• 用于计算每个包的持续时间,从而估算 time_to_play。
三,主要工作流程函数
3.1 初始化与重置
1, Create(int nack_threshold_packets): 工厂方法创建实例。
2, Reset(): 清空 NACK 列表。通常在切换编解码器或采样率变化时调用,因为旧的包重传已无意义。
3, UpdateSampleRate(int sample_rate_hz): 更新采样率,以便正确计算播放时间。
3.2 状态更新
1, UpdateLastReceivedPacket(seq, ts):
• 当一个新的 RTP 包从网络到达并插入 NetEq/ACM 时调用。
• 核心逻辑:
a. 检测序列号跳跃,识别中间缺失的包。
b. 调用 AddToList 将缺失包加入 nack_list_。
c. 调用 ChangeFromLateToMissing:检查之前的 "Late" 包,如果它们现在的序列号距离最新包超过了 nack_threshold,则转为 "Missing"。
d. 调用 LimitNackListSize:移除过旧的包。
2 , UpdateLastDecodedPacket(seq, ts):
• 当 NetEq 成功解码并输出 10ms 音频时调用。
• 核心逻辑:
a. 更新最后解码包的序列号和时间戳。
b. 调用 UpdateEstimatedPlayoutTimeBy10ms:将 nack_list_ 中所有包的 time_to_play_ms 减去 10ms。因为时间流逝了,剩余等待播放的时间变短了。
3.3,获取 NACK 列表
1, GetNackList(int64_t round_trip_time_ms):
• 这是上层(如 RtpRtcp 模块)调用的接口,用于获取需要请求重传的序列号列表。
• 筛选逻辑:
a. 遍历 nack_list_。
b. 只选择 is_missing == true 的包。
c. 进一步筛选:只有当 time_to_play_ms > round_trip_time_ms 时才加入列表。
• 原因: 如果剩余播放时间小于 RTT,说明即使现在立刻请求重传,包也会在播放时刻之后才到达,因此请求重传是无效的,甚至浪费带宽。
四,辅助函数
1, EstimateTimestamp(seq):
根据已知包的时间戳和序列号差值,线性推算丢失包的时间戳。
2, TimeToPlay(timestamp):
根据当前解码进度和包的时间戳,计算该包距离被播放还有多少毫秒。