当前位置：首页 > article >正文

FFmpeg 时间戳回绕处理：保障流媒体时间连续性的核心机制

article 2025/9/4 21:40:05

一、回绕处理函数

/**  * Wrap a given time stamp, if there is an indication for an overflow  *  * @param st stream               // 传入一个指向AVStream结构体的指针，代表流信息  * @param timestamp the time stamp to wrap // 传入需要处理的时间戳  * @return resulting time stamp   // 返回处理后的时间戳  */  
static int64_t wrap_timestamp(const AVStream *st, int64_t timestamp)  
{  // 检查pts_wrap_behavior是否设置为不忽略，且pts_wrap_reference有效，并且传入的时间戳有效  if (st->pts_wrap_behavior != AV_PTS_WRAP_IGNORE &&  st->pts_wrap_reference != AV_NOPTS_VALUE && timestamp != AV_NOPTS_VALUE) {  // 如果pts_wrap_behavior设置为添加偏移量，并且时间戳小于参考时间戳  if (st->pts_wrap_behavior == AV_PTS_WRAP_ADD_OFFSET &&  timestamp < st->pts_wrap_reference)  // 返回时间戳加上一个由pts_wrap_bits定义的偏移量（通常是2的pts_wrap_bits次方）  return timestamp + (1ULL << st->pts_wrap_bits);  // 如果pts_wrap_behavior设置为减去偏移量，并且时间戳大于或等于参考时间戳  else if (st->pts_wrap_behavior == AV_PTS_WRAP_SUB_OFFSET &&  timestamp >= st->pts_wrap_reference)  // 返回时间戳减去一个由pts_wrap_bits定义的偏移量  return timestamp - (1ULL << st->pts_wrap_bits);  }  // 如果不满足上述条件，则直接返回原始时间戳，不进行任何处理  return timestamp;  
}

该函数wrap_timestamp用于处理可能发生溢出的时间戳。在流式媒体处理中，由于时间戳通常是使用固定位数的整数来表示的，当时间戳超过该整数类型能够表示的最大值时，它可能会回绕（wrap around）到0或者负数，造成处理上的混乱。为了处理这种回绕情况，FFmpeg库提供了这样的机制。

函数首先检查是否启用了时间戳回绕处理（pts_wrap_behavior不为AV_PTS_WRAP_IGNORE），并且有一个有效的参考时间戳（pts_wrap_reference）以及传入的时间戳是有效的。
如果满足条件，则根据pts_wrap_behavior的值来决定是添加还是减去一个偏移量。偏移量的大小由pts_wrap_bits决定，通常是2的pts_wrap_bits次方。
如果pts_wrap_behavior设置为AV_PTS_WRAP_ADD_OFFSET，并且传入的时间戳小于参考时间戳，说明时间戳即将回绕到0，此时需要加上一个偏移量来避免回绕。
如果pts_wrap_behavior设置为AV_PTS_WRAP_SUB_OFFSET，并且传入的时间戳大于或等于参考时间戳，说明时间戳还未回绕，此时需要减去一个偏移量来确保时间戳的连续性。
如果上述条件都不满足，则函数直接返回原始的时间戳，不进行任何处理。

通过这个函数，可以确保在处理流式媒体时，即使时间戳发生回绕，也能得到正确且连续的时间戳值。

二、读取输入流时的回绕处理

读取输入流时的回绕处理在函数 int ff_read_packet(AVFormatContext *s, AVPacket *pkt)；中，代码如下：

// 获取指定流的信息，stream_index 是数据包(pkt)所在的流的索引  
st = s->streams[pkt->stream_index];  // 调用 update_wrap_reference 函数，根据返回结果和流的 pts_wrap_behavior 设置来决定是否需要对时间戳进行调整  
if (update_wrap_reference(s, st, pkt->stream_index, pkt) && st->pts_wrap_behavior == AV_PTS_WRAP_SUB_OFFSET) {  // 如果流的 pts_wrap_behavior 是 AV_PTS_WRAP_SUB_OFFSET（即减去偏移量），并且 update_wrap_reference 返回 true  // 那么需要修正首次出现的时间戳为负值  // 如果 first_dts 不是相对值，则调用 wrap_timestamp 函数修正它  // 这里的目的是确保时间戳不会因为回绕而导致错误的排序  if (!is_relative(st->first_dts))  st->first_dts = wrap_timestamp(st, st->first_dts);  // 如果 start_time 不是相对值，同样调用 wrap_timestamp 函数修正它  // start_time 通常表示流的开始时间  if (!is_relative(st->start_time))  st->start_time = wrap_timestamp(st, st->start_time);  // 如果 cur_dts 不是相对值，也调用 wrap_timestamp 函数修正它  // cur_dts 表示当前解码时间戳  if (!is_relative(st->cur_dts))  st->cur_dts = wrap_timestamp(st, st->cur_dts);  
}  // 对数据包(pkt)的 dts（解码时间戳）调用 wrap_timestamp 函数进行修正  
pkt->dts = wrap_timestamp(st, pkt->dts);  // 对数据包(pkt)的 pts（显示时间戳）调用 wrap_timestamp 函数进行修正  
pkt->pts = wrap_timestamp(st, pkt->pts);