编码与格式 / 系统课时
数据包时间戳换算
数据包时间戳换算
本课解决转码与转封装中时间戳单位不一致的问题。你将把 pts、dts 和 duration 在输入流、编码器与输出流时间基之间正确换算,并通过可运行示例验证结果,避免播放速度异常、音画不同步或封装器拒绝写入。
学习目标
- 理解时间戳数值与时间基共同表示真实时间的方式
- 掌握转码与转封装两种场景的换算路径
- 能正确使用
av_rescale_q与av_packet_rescale_ts
时间戳本质与转换路径
FFmpeg 的时间戳不是固定的毫秒值,而是某个时间基下的整数刻度。真实时间可写成 。例如,时间基为 1/90000 时,pts=9000 表示 0.1 秒;同一时刻若改用 1/1000,对应的时间戳应为 100。
转码通常存在三种时间基:输入流 in_stream->time_base、编码器 enc_ctx->time_base 和输出流 out_stream->time_base。解码帧的时间戳先从输入流时间基换算到编码器时间基;编码器产生的数据包,再从编码器时间基换算到输出流时间基。

转封装不经过解码与编码,因此输入数据包可直接从 in_stream->time_base 换算到 out_stream->time_base。无论走哪条路径,都要先确认当前时间戳属于哪个时间基,再转换到下一组件要求的时间基。
完整换算示例
下面的程序同时演示转码和转封装。转码路径先用 av_rescale_q 换算帧的 pts,再用 av_packet_rescale_ts 换算编码包;转封装路径则直接换算输入包的三个时间字段。
#include <inttypes.h>
#include <stdio.h>
#include <libavcodec/packet.h>
#include <libavutil/mathematics.h>
#include <libavutil/rational.h>
static void print_packet(const char *stage, const AVPacket *packet, AVRational tb) {
printf("%s: pts=%" PRId64 ", dts=%" PRId64
", duration=%" PRId64 ", time_base=%d/%d\n",
stage, packet->pts, packet->dts, packet->duration, tb.num, tb.den);
}
int main(void) {
const AVRational input_tb = {1, 90000};
const AVRational encoder_tb = {1, 30};
const AVRational output_tb = {1, 1000};
// 转码时,解码帧的显示时间戳先进入编码器时间基。
int64_t input_frame_pts = 9000;
int64_t encoder_frame_pts = av_rescale_q(input_frame_pts,
input_tb,
encoder_tb);
printf("frame: input_pts=%" PRId64 ", encoder_pts=%" PRId64 "\n",
input_frame_pts, encoder_frame_pts);
AVPacket *encoded_packet = av_packet_alloc();
AVPacket *remux_packet = av_packet_alloc();
if (encoded_packet == NULL || remux_packet == NULL) {
fprintf(stderr, "Failed to allocate packets.\n");
av_packet_free(&encoded_packet);
av_packet_free(&remux_packet);
return 1;
}
// 编码器输出的包属于编码器时间基,写入前换算到输出流时间基。
encoded_packet->pts = 3;
encoded_packet->dts = 2;
encoded_packet->duration = 1;
av_packet_rescale_ts(encoded_packet, encoder_tb, output_tb);
print_packet("transcode output", encoded_packet, output_tb);
// 转封装不经过编码器,输入包可直接换算到输出流时间基。
remux_packet->pts = 9000;
remux_packet->dts = 6000;
remux_packet->duration = 3000;
av_packet_rescale_ts(remux_packet, input_tb, output_tb);
print_packet("remux output", remux_packet, output_tb);
av_packet_free(&encoded_packet);
av_packet_free(&remux_packet);
return 0;
}运行命令:
cc timestamp_rescale.c -o timestamp_rescale $(pkg-config --cflags --libs libavcodec libavutil)
./timestamp_rescale预期输出:
frame: input_pts=9000, encoder_pts=3
transcode output: pts=100, dts=67, duration=33, time_base=1/1000
remux output: pts=100, dts=67, duration=33, time_base=1/1000dts=2 从 1/30 换算到 1/1000 后约为 66.67,因此结果按 FFmpeg 的舍入规则得到 67。时间戳换算存在整数舍入,但换算前后代表的真实时间应保持接近。
边界与检查方法
编码后的数据包通常属于 enc_ctx->time_base,不能继续按输入流时间基处理。转封装包则使用原始 in_stream->time_base。若源时间基选错,即使 API 调用成功,结果也会在时间轴上整体放大或缩小。
AV_NOPTS_VALUE 表示时间戳未知,av_packet_rescale_ts 会保留该值,不要自行改成 0。写入前还应检查同一输出流的 dts 是否总体单调递增;若出现回退,应排查源时间基、流映射和 B 帧重排序,而不是简单给时间戳累加 1。
Tips:
av_rescale_q适合换算单个整数,av_packet_rescale_ts适合完整数据包,因为它会按 FFmpeg 约定统一处理pts、dts和duration。