1. FFmpeg+SDL快进快退
ffmpeg播放器实现详解 - 快进快退控制：https://www.cnblogs.com/breakpointlab/p/15807316.html
1.1. 源代码一览
#import <UIKit/UIKit.h>
#import "AppDelegate.h"
#import "SDL.h"
//#include <jni.h>
//#include <string>
//#include <android/log.h>
#include <errno.h>
#include "SDL.h"
#include "SDL_thread.h"
#include "SDL_syswm.h"
#import "ViewController.h"
#define SDL_AUDIO_BUFFER_SIZE 1024
#define MAX_AUDIO_FRAME_SIZE 192000
#define AV_SYNC_THRESHOLD 0.01//前后两帧间的显示时间间隔的最小值0.01s
#define AV_NOSYNC_THRESHOLD 10.0//最小刷新间隔时间10ms
#define MAX_AUDIOQ_SIZE (5 * 16 * 1024)
#define MAX_VIDEOQ_SIZE (5 * 256 * 1024)
#define FF_ALLOC_EVENT (SDL_USEREVENT)
#define FF_REFRESH_EVENT (SDL_USEREVENT + 1)
#define FF_QUIT_EVENT (SDL_USEREVENT + 2)
#define VIDEO_PICTURE_QUEUE_SIZE 1
#define SAMPLE_CORRECTION_PERCENT_MAX 10
#define AUDIO_DIFF_AVG_NB 20
//extern "C" {
#include <libavcodec/avcodec.h>
#include "libavformat/avformat.h"
#include <libavutil/avstring.h>
#include <libavutil/imgutils.h>
#include <libswscale/swscale.h>
#include <libavutil/time.h>
#include <libswresample/swresample.h>
#include <libavutil/opt.h>
//}
AVPacket flush_pkt;//在执行[快进]/[快退]操作后，ffmpeg需要执行重置解码器操作
uint64_t global_video_pkt_pts = AV_NOPTS_VALUE;
enum {//同步时钟源
AV_SYNC_AUDIO_MASTER,//音频时钟为主同步源
AV_SYNC_VIDEO_MASTER,//视频时钟为主同步源
AV_SYNC_EXTERNAL_MASTER,//外部时钟为主同步源
};
#define DEFAULT_AV_SYNC_TYPE AV_SYNC_AUDIO_MASTER//指定以视频时钟为主同步源(时间基准)
SDL_Window *screen;//SDL绘图表面
/*-------链表节点结构体--------
typedef struct AVPacketList {
AVPacket pkt;//链表数据
struct AVPacketList *next;//链表后继节点
} AVPacketList;
---------------------------*/
// 数据包队列(链表)结构体
typedef struct PacketQueue {
AVPacketList *first_pkt, *last_pkt;// 队列首尾节点指针
int nb_packets;// 队列长度
int size;// 保存编码数据的缓存长度，size=packet->size
SDL_mutex *qlock;// 队列互斥量，保护队列数据
SDL_cond *qready;// 队列就绪条件变量
} PacketQueue;
// 图像帧结构体
typedef struct VideoPicture {
AVFrame *avframe_yuv420p;
int width, height;//Source height & width.
int allocated;//是否分配内存空间，视频帧转换为SDL overlay标识
double pts;//当前图像帧的绝对显示时间戳
} VideoPicture;
typedef struct VideoState {
AVFormatContext *pFormatCtx;// 保存文件容器封装信息及码流参数的结构体
AVStream *video_st;// 视频流信息结构体
AVStream *audio_st;//音频流信息结构体
struct SwsContext *sws_ctx;// 描述转换器参数的结构体
struct SwsContext *sws_ctx_audio;
PacketQueue videoq;// 视频编码数据包队列(编码数据队列，以链表方式实现)
VideoPicture pictq[VIDEO_PICTURE_QUEUE_SIZE];
int pictq_size, pictq_rindex, pictq_windex;// 队列长度，读/写位置索引
SDL_mutex *pictq_lock;// 队列读写锁对象，保护图像帧队列数据
SDL_cond *pictq_ready;// 队列就绪条件变量
SDL_Rect sdl_rect;
SDL_Renderer* sdl_renderer;
SDL_Texture* sdl_texture;
PacketQueue audioq;// 音频编码数据包队列(编码数据队列，以链表方式实现)
uint8_t audio_buf[(MAX_AUDIO_FRAME_SIZE*3)/2];//保存解码一个packet后的多帧原始音频数据(解码数据队列，以数组方式实现)
unsigned int audio_buf_size;//解码后的多帧音频数据长度
unsigned int audio_buf_index;//累计写入stream的长度
uint8_t *audio_pkt_data;//编码数据缓存指针位置
int audio_pkt_size;//缓存中剩余的编码数据长度(是否已完成一个完整的pakcet包的解码，一个数据包中可能包含多个音频编码帧)
AVPacket audio_pkt;//保存从队列中提取的数据包
AVFrame audio_frame;//保存从数据包中解码的音频数据
int video_width;
int video_height;
char filename[1024];// 输入文件完整路径名
int videoStream, audioStream;// 音视频流类型标号
SDL_Thread *parse_tid;// 编码数据包解析线程id
SDL_Thread *decode_tid;// 解码线程id
int quit;// 全局退出进程标识，在界面上点了退出后，告诉线程退出
//video/audio_clock save pts of last decoded frame/predicted pts of next decoded frame
double video_clock;//keep track of how much time has passed according to the video
double audio_clock;
double frame_timer;//视频播放到当前帧时的累计已播放时间
double frame_last_pts;//上一帧图像的显示时间戳，用于在video_refersh_timer中保存上一帧的pts值
double frame_last_delay;//上一帧图像的动态刷新延迟时间
int av_sync_type;//主同步源类型
double external_clock;//External clock base
int64_t external_clock_time;//外部时钟的绝对时间
double audio_diff_cum;//音频时钟与同步源累计时差，sed for AV difference average computation
double audio_diff_avg_coef;//音频时钟与同步源时差均值加权系数
double audio_diff_threshold;//音频时钟与同步源时差均值阈值
int audio_diff_avg_count;//音频不同步计数(音频时钟与主同步源存在不同步的次数)
int audio_hw_buf_size;
double video_current_pts;//当前帧显示时间戳，Current displayed pts (different from video_clock if frame fifos are used)
int64_t video_current_pts_time;//取得video_current_pts的系统时间，time (av_gettime) at which we updated video_current_pts - used to have running video pts
int seek_req;//[快进]/[后退]操作开启标志位
int seek_flags;//[快进]/[后退]操作类型标志位
int64_t seek_pos;//[快进]/[后退]操作后的参考时间戳
} VideoState;// Since we only have one decoding thread, the Big Struct can be global in case we need it.
VideoState *global_video_state;
/*------取得当前播放音频数据的pts------
* 音视频同步的原理是根据音频的pts来控制视频的播放
* 也就是说在视频解码一帧后，是否显示以及显示多长时间，是通过该帧的PTS与同时正在播放的音频的PTS比较而来的
* 如果音频的PTS较大，则视频准备完毕立即刷新，否则等待
*
* 因为pcm数据采用audio_callback回调方式进行播放
* 对于音频播放我们只能得到写入回调函数前缓存音频帧的pts，而无法得到当前播放帧的pts(需要采用当前播放音频帧的pts作为参考时钟)
* 考虑到音频的大小与播放时间成正比(相同采样率)，那么当前时刻正在播放的音频帧pts(位于回调函数缓存中)
* 就可以根据已送入声卡的pcm数据长度、缓存中剩余pcm数据长度，缓存长度及采样率进行推算了
--------------------------------*/
double get_audio_clock(VideoState *is) {
double pts=is->audio_clock;//Maintained in the audio thread，取得解码操作完成时的当前播放时间戳
//还未(送入声卡)播放的剩余原始音频数据长度，等于解码后的多帧原始音频数据长度-累计送入声卡的长度
int hw_buf_size=is->audio_buf_size-is->audio_buf_index;//计算当前音频解码数据缓存索引位置
int bytes_per_sec=0;//每秒的原始音频字节数
int pcm_bytes=is->audio_st->codec->channels*2;//每组原始音频数据字节数=声道数*每声道数据字节数
if (is->audio_st) {
bytes_per_sec=is->audio_st->codec->sample_rate*pcm_bytes;//计算每秒的原始音频字节数
}
if (bytes_per_sec) {//检查每秒的原始音频字节数
pts-=(double)hw_buf_size/bytes_per_sec;//根据送入声卡缓存的索引位置，往前倒推计算当前时刻的音频播放时间戳pts
}
return pts;//返回当前正在播放的音频时间戳
}
/*-----------取得视频时钟-----------
* 即取得当前播放视频帧的pts，以视频时钟pts作为音视频同步基准，return the current time offset of the video currently being played
* 该值为当前帧时间戳pts+一个微小的修正值delta
* 因为在ms的级别上，在毫秒级别上，若取得视频时钟(即当前帧pts)的时刻，与调用视频时钟的时刻(如将音频同步到该视频pts时刻)存在延迟
* 那么，视频时钟需要在被调用时进行修正，修正值delta为
* delta=[取得视频时钟的时刻值video_current_pts_time] 到 [调用get_video_clock时刻值] 的间隔时间
* 通常情况下，都会选择以外部时钟或音频时钟作为主同步源，以视频同步到音频或外部时钟为首选同步方案
* 以视频时钟作为主同步源的同步方案，属于3种基本的同步方案(同步到音频、同步到视频、同步到外部时钟)
* 本利仅为展示同步到视频时钟的方法，一般情况下同步到视频时钟仅作为辅助的同步方案
--------------------------------*/
double get_video_clock(VideoState *is) {
double delta=(av_gettime()-is->video_current_pts_time)/1000000.0;
//pts_of_last_frame+(Current_time-time_elapsed_since_pts_value_was_set)
return is->video_current_pts+delta;
}
//取得系统时间，以系统时钟作为同步基准
double get_external_clock(VideoState *is) {
return av_gettime()/1000000.0;//取得系统当前时间，以1/1000000秒为单位，便于在各个平台移植
}
//取得主时钟(基准时钟)
double get_master_clock(VideoState *is) {
if (is->av_sync_type == AV_SYNC_VIDEO_MASTER) {
return get_video_clock(is);//返回视频时钟
} else if (is->av_sync_type == AV_SYNC_AUDIO_MASTER) {
return get_audio_clock(is);//返回音频时钟
} else {
return get_external_clock(is);//返回系统时钟
}
}
/*---------------------------
* return the wanted number of samples to get better sync if sync_type is video or external master clock
* 通常情况下会以音频或系统时钟为主同步源，只有在音频或系统时钟失效的情况下才以视频为主同步源
* 该函数比对音频时钟与主同步源的时差，通过动态丢帧(或插值)部分音频数据，以起到减少(或增加)音频播放时长，减少与主同步源时差的作用
* 该函数对音频缓存数据进行丢帧(或插值)，返回丢帧(或插值)后的音频数据长度
* 因为音频同步可能带来输出声音不连续等副作用，该函数通过音频不同步次数(audio_diff_avg_count)及时差均值(avg_diff)来约束音频的同步过程
---------------------------*/
int synchronize_audio(VideoState *is, short *samples, int samples_size, double pts) {
double ref_clock;//主同步源(基准时钟)
int pcm_bytes=is->audio_st->codec->channels*2;//每组音频数据字节数=声道数*每声道数据字节数
/* if not master, then we try to remove or add samples to correct the clock */
if (is->av_sync_type != AV_SYNC_AUDIO_MASTER) {//检查主同步源，若同步源不是音频时钟的情况下，执行以下代码
double diff, avg_diff;//diff-音频帧播放间与主同步源时差，avg_diff-采样不同步平均值
int wanted_size, min_size, max_size;//经过丢帧(或插值)后的缓存长度，缓存长度最大/最小值
ref_clock = get_master_clock(is);//取得当前主同步源，以主同步源为基准时间
diff = get_audio_clock(is) - ref_clock;//计算音频时钟与当前主同步源的时差
if (diff<AV_NOSYNC_THRESHOLD) {//检查音频是否处于不同步状态(通过AV_NOSYNC_THRESHOLD限制丢弃的音频数据长度，避免出现声音不连续)
//Accumulate the diffs，对时差加权累加(离当前播放时间近的时差权值系数大)
is->audio_diff_cum=diff+is->audio_diff_avg_coef*is->audio_diff_cum;
if (is->audio_diff_avg_count<AUDIO_DIFF_AVG_NB) {//将音频不同步计数与阈值进行比对
//not enough measures to have a correct estimate
is->audio_diff_avg_count++;//音频不同步计数更新
} else {//当音频不同步次数超过阈值限定后，触发音频同步操作
avg_diff=is->audio_diff_cum*(1.0-is->audio_diff_avg_coef);//计算时差均值(等比级数几何平均数)
if (fabs(avg_diff)>=is->audio_diff_threshold) {//比对时差均值与时差阈值
wanted_size=samples_size+((int)(diff*is->audio_st->codec->sample_rate)*pcm_bytes);//根据时差换算同步后的缓存长度
min_size=samples_size*((100-SAMPLE_CORRECTION_PERCENT_MAX)/100);//同步后的缓存长度最小值
max_size=samples_size*((100+SAMPLE_CORRECTION_PERCENT_MAX)/100);//同步后的缓存长度最大值
if (wanted_size<min_size) {//若同步后缓存长度<最小缓存长度
wanted_size=min_size;//用最小缓存长度作为同步后的缓存长度
} else if (wanted_size>max_size) {//若同步后缓存长度>最小缓存长度
wanted_size=max_size;//用最大缓存长度作为同步后的缓存长度
}
if (wanted_size<samples_size) {//比对同步后的音频缓存数据长度与原始缓存长度
samples_size=wanted_size;//Remove samples，用丢帧后的音频缓存长度更新原始缓存长度
} else if (wanted_size>samples_size) {//若同步后缓存长度大于当前缓存长度
//Add samples by copying final sample，通过复制最后一个音频数据进行插值
//int nb=samples_size-wanted_size;
int nb=wanted_size-samples_size;//计算插值后缓存长度与原始缓存长度间的差值(需要插值的音频数据组数)
uint8_t *samples_end=(uint8_t*)samples+samples_size-pcm_bytes;//取得缓存末端数据指针
uint8_t *q=samples_end+pcm_bytes;//初始插值位置|<-----samples----->||q|
while (nb>0) {//检查插值音频组数(每组包括两个声道的pcm数据)
memcpy(q,samples_end,pcm_bytes);//在samples原始缓存后追加插值
q += pcm_bytes;//更新插值位置
nb -= pcm_bytes;//更新插值组数
}
samples_size=wanted_size;//返回音频同步后的缓存长度
}
}
}
} else {
// Difference is too big, reset diff stuff，时差过大，重置时差累计值
is->audio_diff_avg_count = 0;//音频不同步计数重置
is->audio_diff_cum = 0;//音频累计时差重置
}
}//end for if (is->av_sync_type != AV_SYNC_AUDIO_MASTER)
return samples_size;//返回发送到声卡的音频缓存字节数
}
// 定时器触发的回调函数
static Uint32 sdl_refresh_timer_cb(Uint32 interval, void *opaque) {
SDL_Event event;//SDL事件对象
event.type = FF_REFRESH_EVENT;//视频显示刷新事件
event.user.data1 = opaque;//传递用户数据
SDL_PushEvent(&event);//发送事件
return 0; // 0 means stop timer.
}
/*---------------------------
* Schedule a video refresh in 'delay' ms.
* 告诉sdl在指定的延时后来推送一个 FF_REFRESH_EVENT 事件
* 这个事件将在事件队列里触发sdl_refresh_timer_cb函数的调用
--------------------------*/
static void schedule_refresh(VideoState *is, int delay) {
SDL_AddTimer(delay, sdl_refresh_timer_cb, is);//在指定的时间(ms)后回调用户指定的函数
}
// 视频(图像)帧渲染
void video_display(VideoState *is) {
SDL_Rect rect;// SDL矩形对象
VideoPicture *vp;// 图像帧结构体指针
float aspect_ratio;//宽度/高度比
int w, h, x, y;//窗口尺寸及起始位置
vp = &is->pictq[is->pictq_rindex];//从图像帧队列(数组)中提取图像帧结构对象
if (vp->avframe_yuv420p) {//检查像素数据指针是否有效
if (is->video_st->codec->sample_aspect_ratio.num == 0) {
aspect_ratio = 0;
} else {
aspect_ratio = av_q2d(is->video_st->codec->sample_aspect_ratio) * is->video_st->codec->width / is->video_st->codec->height;
}
if (aspect_ratio <= 0.0) {
aspect_ratio = (float) is->video_st->codec->width / (float) is->video_st->codec->height;
}
// SDL中获取屏幕尺寸
SDL_DisplayMode DM;
SDL_GetCurrentDisplayMode(0, &DM);
h = DM.h;
w = ((int) rint(h * aspect_ratio)) & -3;
if (w > DM.w) {
w = DM.w;
h = ((int) rint(w / aspect_ratio)) & -3;
}
x = (DM.w - w) / 2;
y = (DM.h - h) / 2;
// 设置纹理数据
SDL_UpdateTexture(is->sdl_texture, // 纹理
NULL,// 渲染区域
vp->avframe_yuv420p->data[0],// 需要渲染数据：视频像素数据帧
vp->avframe_yuv420p->linesize[0]);// 帧宽
// 将纹理数据拷贝给渲染器
// 设置左上角位置(全屏)
is->sdl_rect.x = x;
is->sdl_rect.y = y;
is->sdl_rect.w = w;
is->sdl_rect.h = h;
SDL_RenderClear(is->sdl_renderer);
SDL_RenderCopy(is->sdl_renderer, is->sdl_texture, NULL, &is->sdl_rect);
// 呈现画面帧
SDL_RenderPresent(is->sdl_renderer);
}// end for if
}// end for video_display
// 显示刷新函数(FF_REFRESH_EVENT响应函数)
int video_current_index = 0;
void video_refresh_timer(void *userdata) {
VideoState *is = (VideoState *)userdata;// 传递用户数据
VideoPicture *vp;//图像帧对象
//delay-前后帧间的显示时间间隔，diff-图像帧显示与音频帧播放间的时间差
//sync_threshold-前后帧间的最小时间差，actual_delay-当前帧-下已帧的显示时间间隔(动态时间、真实时间、绝对时间)
double delay,diff,sync_threshold,actual_delay,ref_clock;//ref_clock-音频时间戳
if (is->video_st) {
if (is->pictq_size == 0) {// 检查图像帧队列是否有待显示图像
schedule_refresh(is, 1);//若队列为空，则发送显示刷新事件并再次进入video_refresh_timer函数
} else {// 刷新图像
vp = &is->pictq[is->pictq_rindex];//从显示队列中取得等待显示的图像帧
is->video_current_pts = vp->pts;//取得当前帧的显示时间戳
is->video_current_pts_time = av_gettime();//取得系统时间，作为当前帧播放的时间基准
//计算当前帧和前一帧显示(pts)的间隔时间(显示时间戳的差值)
//计算当前帧和前一帧显示(pts)的间隔时间(显示时间戳的差值)
delay = vp->pts - is->frame_last_pts;//The pts from last time，前后帧间的时间差
if (delay <= 0 || delay >= 1.0) {//检查时间间隔是否在合理范围
// If incorrect delay, use previous one
delay = is->frame_last_delay;//沿用之前的动态刷新间隔时间
}
// Save for next time
is->frame_last_delay = delay;//保存上一帧图像的动态刷新延迟时间
is->frame_last_pts = vp->pts;//保存上一帧图像的显示时间戳
// Update delay to sync to audio，取得声音播放时间戳(作为视频同步的参考时间)
// Update delay to sync to audio，取得声音播放时间戳(作为视频同步的参考时间)
if (is->av_sync_type != AV_SYNC_VIDEO_MASTER) {//检查主同步时钟源
ref_clock = get_master_clock(is);//根据Audio clock来判断Video播放的快慢，获取当前播放声音的时间戳
//也就是说在diff这段时间中声音是匀速发生的，但是在delay这段时间frame的显示可能就会有快慢的区别
diff = vp->pts - ref_clock;//计算图像帧显示与音频帧播放间的时间差
//根据时间差调整播放下一帧的延迟时间，以实现同步 Skip or repeat the frame，Take delay into account
sync_threshold = (delay > AV_SYNC_THRESHOLD) ? delay
: AV_SYNC_THRESHOLD;//比较前后两帧间的显示时间间隔与最小时间间隔
//判断音视频不同步条件，即音视频间的时间差 & 前后帧间的时间差<10ms阈值，若>该阈值则为快进模式，不存在音视频同步问题
if (fabs(diff) < AV_NOSYNC_THRESHOLD) {
if (diff <=
-sync_threshold) {//比较前一帧&当前帧[画面-声音]间的时间间隔与前一帧 & 当前帧[画面-画面]间的时间间隔，慢了，delay设为0
//下一帧画面显示的时间和当前的声音很近的话加快显示下一帧（即后面video_display显示完当前帧后开启定时器很快去显示下一帧
delay = 0;
} else if (diff >= sync_threshold) {//比较两帧画面间的显示时间与两帧画面间声音的播放时间，快了，加倍delay
delay = 2 * delay;
}
}//如果diff(明显)大于AV_NOSYNC_THRESHOLD，即快进的模式了，画面跳动太大，不存在音视频同步的问题了
}
//更新视频播放到当前帧时的已播放时间值(所有图像帧动态播放累计时间值-真实值)，frame_timer一直累加在播放过程中我们计算的延时
is->frame_timer+=delay;
//每次计算frame_timer与系统时间的差值(以系统时间为基准时间)，将frame_timer与系统时间(绝对时间)相关联的目的
actual_delay=is->frame_timer-(av_gettime()/1000000.0);//Computer the REAL delay
if (actual_delay < 0.010) {//检查绝对时间范围
actual_delay = 0.010;// Really it should skip the picture instead
}
schedule_refresh(is, (int)(actual_delay*1000+0.5));//用绝对时间开定时器去动态显示刷新下一帧
// Show the picture!
video_display(is);// 图像帧渲染
video_current_index++;
// __android_log_print(ANDROID_LOG_INFO, "main", "video_current_index：%d，vp->pts: %f，ref_clock：%f，actual_delay：%f", video_current_index, vp->pts, ref_clock, actual_delay);
// Update queue for next picture!
if (++is->pictq_rindex == VIDEO_PICTURE_QUEUE_SIZE) {// 更新并检查图像帧队列读位置索引
is->pictq_rindex = 0;// 重置读位置索引
}
SDL_LockMutex(is->pictq_lock);// 锁定互斥量，保护画布的像素数据
is->pictq_size--;// 更新图像帧队列长度
SDL_CondSignal(is->pictq_ready);// 发送队列就绪信号
SDL_UnlockMutex(is->pictq_lock);// 释放互斥量
}
} else {
schedule_refresh(is, 100);
}
}
// 数据包队列初始化函数
void packet_queue_init(PacketQueue *q) {
memset(q, 0, sizeof(PacketQueue));// 全零初始化队列结构体对象
q->qlock = SDL_CreateMutex();// 创建互斥量对象
q->qready = SDL_CreateCond();// 创建条件变量对象
}
// 向队列中插入数据包
int packet_queue_put(PacketQueue *q, AVPacket *pkt) {
/*-------准备队列(链表)节点对象------*/
AVPacketList *pktlist=(AVPacketList *)av_malloc(sizeof(AVPacketList));// 在堆上创建链表节点对象
if (!pktlist) {// 检查链表节点对象是否创建成功
return -1;
}
pktlist->pkt = *pkt;// 将输入数据包赋值给新建链表节点对象中的数据包对象
pktlist->next = NULL;// 链表后继指针为空
// if (av_packet_ref(pkt, pkt) < 0) {// 增加pkt编码数据的引用计数(输入参数中的pkt与新建链表节点中的pkt共享同一缓存空间)
// return -1;
// }
/*---------将新建节点插入队列-------*/
SDL_LockMutex(q->qlock);// 队列互斥量加锁，保护队列数据
if (!q->last_pkt) {// 检查队列尾节点是否存在(检查队列是否为空)
q->first_pkt = pktlist;// 若不存在(队列尾空)，则将当前节点作队列为首节点
}
else {
q->last_pkt->next = pktlist;// 若已存在尾节点，则将当前节点挂到尾节点的后继指针上，并作为新的尾节点
}
q->last_pkt = pktlist;// 将当前节点作为新的尾节点
q->nb_packets++;// 队列长度+1
q->size += pktlist->pkt.size;// 更新队列编码数据的缓存长度
SDL_CondSignal(q->qready);// 给等待线程发出消息，通知队列已就绪
SDL_UnlockMutex(q->qlock);// 释放互斥量
return 0;
}
// 从队列中提取数据包，并将提取的数据包出队列
static int packet_queue_get(PacketQueue *q, AVPacket *pkt, int block) {
AVPacketList *pktlist;// 临时链表节点对象指针
int ret;// 操作结果
SDL_LockMutex(q->qlock);// 队列互斥量加锁，保护队列数据
for (;;) {
if (global_video_state->quit) {// 检查退出进程标识
ret = -1;// 操作失败
break;
}//end for if
pktlist = q->first_pkt;// 传递将队列首个数据包指针
if (pktlist) {// 检查数据包是否为空(队列是否有数据)
q->first_pkt = pktlist->next;// 队列首节点指针后移
if (!q->first_pkt) {// 检查首节点的后继节点是否存在
q->last_pkt = NULL;// 若不存在，则将尾节点指针置空
}
q->nb_packets--;// 队列长度-1
q->size -= pktlist->pkt.size;// 更新队列编码数据的缓存长度
*pkt = pktlist->pkt;// 将队列首节点数据返回
av_free(pktlist);// 清空临时节点数据(清空首节点数据，首节点出队列)
ret = 1;// 操作成功
break;
} else if (!block) {
ret = 0;
break;
} else {// 队列处于未就绪状态，此时通过SDL_CondWait函数等待qready就绪信号，并暂时对互斥量解锁
/*---------------------
* 等待队列就绪信号qready，并对互斥量暂时解锁
* 此时线程处于阻塞状态，并置于等待条件就绪的线程列表上
* 使得该线程只在临界区资源就绪后才被唤醒，而不至于线程被频繁切换
* 该函数返回时，互斥量再次被锁住，并执行后续操作
--------------------*/
SDL_CondWait(q->qready, q->qlock);// 暂时解锁互斥量并将自己阻塞，等待临界区资源就绪(等待SDL_CondSignal发出临界区资源就绪的信号)
}
}//end for for-loop
SDL_UnlockMutex(q->qlock);// 释放互斥量
return ret;
}
// 创建/重置图像帧，为图像帧分配内存空间
void alloc_picture(void *userdata) {
VideoState *is = (VideoState *)userdata;// 传递用户数据
VideoPicture *vp=&is->pictq[is->pictq_windex];// 从图像帧队列(数组)中提取图像帧结构对象
if (vp->avframe_yuv420p) {// 检查图像帧是否已存在
// We already have one make another, bigger/smaller.
av_frame_free(&vp->avframe_yuv420p);
}
vp->width = is->video_st->codec->width;// 设置图像帧宽度
vp->height = is->video_st->codec->height;// 设置图像帧高度
SDL_LockMutex(is->pictq_lock);// 锁定互斥量，保护画布的像素数据
vp->allocated = 1;// 图像帧像素缓冲区已分配内存
// AV_PIX_FMT_YUV420P格式的视频帧
vp->avframe_yuv420p = av_frame_alloc();
// 给缓冲区设置类型
int buffer_size =av_image_get_buffer_size(AV_PIX_FMT_YUV420P,// 视频像素数据格式类型
is->video_st->codec->width,// 一帧视频像素数据宽 = 视频宽
is->video_st->codec->height,// 一帧视频像素数据高 = 视频高
1);// 字节对齐方式，默认是1
// 开辟一块内存空间
uint8_t *out_buffer = (uint8_t *)av_malloc(buffer_size);
// 向avframe_yuv420p填充数据
av_image_fill_arrays(vp->avframe_yuv420p->data,// 目标视频帧数据
vp->avframe_yuv420p->linesize,// 目标视频帧行大小
out_buffer,// 原始数据
AV_PIX_FMT_YUV420P,// 视频像素数据格式类型
is->video_st->codec->width,// 视频宽
is->video_st->codec->height,//视频高
1);// 字节对齐方式
SDL_CondSignal(is->pictq_ready);// 给等待线程发出消息，通知队列已就绪
SDL_UnlockMutex(is->pictq_lock);// 释放互斥量
}
/*---------------------------
* queue_picture：图像帧插入队列等待渲染
* @is：全局状态参数集
* @pFrame：保存图像解码数据的结构体
* 1、首先检查图像帧队列(数组)是否存在空间插入新的图像，若没有足够的空间插入图像则使当前线程休眠等待
* 2、在初始化的条件下，队列(数组)中VideoPicture的bmp对象(YUV overlay)尚未分配空间，通过FF_ALLOC_EVENT事件的方法调用alloc_picture分配空间
* 3、当队列(数组)中所有VideoPicture的bmp对象(YUV overlay)均已分配空间的情况下，直接跳过步骤2向bmp对象拷贝像素数据，像素数据在进行格式转换后执行拷贝操作
---------------------------*/
int queue_picture(VideoState *is, AVFrame *pFrame, double pts) {
/*--------1、检查队列是否有插入空间-------*/
// Wait until we have space for a new pic.
SDL_LockMutex(is->pictq_lock);// 锁定互斥量，保护图像帧队列
while (is->pictq_size >= VIDEO_PICTURE_QUEUE_SIZE && !is->quit) {// 检查队列当前长度
SDL_CondWait(is->pictq_ready, is->pictq_lock);// 线程休眠等待pictq_ready信号
}
SDL_UnlockMutex(is->pictq_lock);// 释放互斥量
if (is->quit) {// 检查进程退出标识
return -1;
}
/*-------2、初始化/重置YUV overlay-------*/
// windex is set to 0 initially.
VideoPicture *vp=&is->pictq[is->pictq_windex];// 从图像帧队列中抽取图像帧对象
// Allocate or resize the buffer，检查YUV overlay是否已存在，否则初始化YUV overlay，分配像素缓存空间
if (!vp->avframe_yuv420p || vp->width!=is->video_st->codec->width || vp->height!=is->video_st->codec->height) {
vp->allocated = 0;// 图像帧未分配空间
// We have to do it in the main thread.
SDL_Event event;// SDL事件对象
event.type = FF_ALLOC_EVENT;//指定分配图像帧内存事件
event.user.data1 = is;//传递用户数据
SDL_PushEvent(&event);//发送SDL事件
// Wait until we have a picture allocated.
SDL_LockMutex(is->pictq_lock);// 锁定互斥量，保护图像帧队列
while (!vp->allocated && !is->quit) {// 检查当前图像帧是否已初始化
SDL_CondWait(is->pictq_ready, is->pictq_lock);// 线程休眠等待alloc_picture发送pictq_ready信号唤醒当前线程
}
SDL_UnlockMutex(is->pictq_lock);// 释放互斥量
if (is->quit) {// 检查进程退出标识
return -1;
}
}// end for if
/*--------3、拷贝视频帧到YUV overlay-------*/
// We have a place to put our picture on the queue.
if (vp->avframe_yuv420p) {//检查像素数据指针是否有效
// Convert the image into YUV format that SDL uses，将解码后的图像帧转换为AV_PIX_FMT_YUV420P格式，并拷贝到图像帧队列
sws_scale(is->sws_ctx, (uint8_t const * const *)pFrame->data, pFrame->linesize, 0, is->video_st->codec->height, vp->avframe_yuv420p->data, vp->avframe_yuv420p->linesize);
vp->pts = pts;//传递当前图像帧的绝对显示时间戳
// Now we inform our display thread that we have a pic ready.
if (++is->pictq_windex == VIDEO_PICTURE_QUEUE_SIZE) {//更新并检查当前图像帧队列写入位置
is->pictq_windex = 0;//重置图像帧队列写入位置
}
SDL_LockMutex(is->pictq_lock);//锁定队列读写锁，保护队列数据
is->pictq_size++;//更新图像帧队列长度
SDL_UnlockMutex(is->pictq_lock);//释放队列读写锁
}// end for if
return 0;
}
/*---------------------------
* 更新内部视频播放计时器(记录视频已经播时间(video_clock)）
* @is：全局状态参数集
* @src_frame：当前(输入的)(待更新的)图像帧对象
* @pts：当前图像帧的显示时间戳
* update the PTS to be in sync
---------------------------*/
double synchronize_video(VideoState *is, AVFrame *src_frame, double pts) {
/*----------检查显示时间戳----------*/
if (pts != 0) {//检查显示时间戳是否有效
// If we have pts, set video clock to it.
is->video_clock = pts;//用显示时间戳更新已播放时间
} else {//若获取不到显示时间戳
// If we aren't given a pts, set it to the clock.
pts = is->video_clock;//用已播放时间更新显示时间戳
}
/*--------更新视频已经播时间--------*/
// Update the video clock，若该帧要重复显示(取决于repeat_pict)，则全局视频播放时序video_clock应加上重复显示的数量*帧率
double frame_delay = av_q2d(is->video_st->codec->time_base);//该帧显示完将要花费的时间
// If we are repeating a frame, adjust clock accordingly,若存在重复帧，则在正常播放的前后两帧图像间安排渲染重复帧
frame_delay += src_frame->repeat_pict*(frame_delay*0.5);//计算渲染重复帧的时值(类似于音符时值)
is->video_clock += frame_delay;//更新视频播放时间
// printf("repeat_pict=%d \n",src_frame->repeat_pict);
return pts;//此时返回的值即为下一帧将要开始显示的时间戳
}
// These are called whenever we allocate a frame buffer. We use this to store the global_pts in a frame at the time it is allocated.
int our_get_buffer(struct AVCodecContext *c, AVFrame *pic, int flags) {
int ret = avcodec_default_get_buffer2(c, pic, 0);
uint64_t *pts = (uint64_t *)av_malloc(sizeof(uint64_t));
*pts = global_video_pkt_pts;
pic->opaque = pts;
return ret;
}
// 视频解码线程函数
int decode_thread(void *arg) {
VideoState *is = (VideoState *) arg;// 传递用户数据
AVPacket pkt, *packet = &pkt;// 在栈上创建临时数据包对象并关联指针
int frameFinished;// 解码操作是否成功标识
// Allocate video frame，为解码后的视频信息结构体分配空间并完成初始化操作(结构体中的图像缓存按照下面两步手动安装)
AVFrame *pFrame = av_frame_alloc();
double pts;//当前桢在整个视频中的(绝对)时间位置
for (;;) {
if (packet_queue_get(&is->videoq,packet,1)<0) {// 从队列中提取数据包到packet，并将提取的数据包出队列
// Means we quit getting packets.
break;
}
if (packet->data == flush_pkt.data) {//检查是否需要重新解码
avcodec_flush_buffers(is->video_st->codec);//重新解码前需要重置解码器
continue;
}
pts = 0;//(绝对)显示时间戳初始化
global_video_pkt_pts = packet->pts;// Save global pts to be stored in pFrame in first call.
/*-----------------------
* Decode video frame，解码完整的一帧数据，并将frameFinished设置为true
* 可能无法通过只解码一个packet就获得一个完整的视频帧frame，可能需要读取多个packet才行
* avcodec_decode_video2()会在解码到完整的一帧时设置frameFinished为真
* Technically a packet can contain partial frames or other bits of data
* ffmpeg's parser ensures that the packets we get contain either complete or multiple frames
* convert the packet to a frame for us and set frameFinisned for us when we have the next frame
-----------------------*/
avcodec_decode_video2(is->video_st->codec, pFrame, &frameFinished, packet);
//取得编码数据包中的显示时间戳PTS(int64_t),并暂时保存在pts(double)中
// if (packet->dts==AV_NOPTS_VALUE && pFrame->opaque && *(uint64_t*)pFrame->opaque!=AV_NOPTS_VALUE) {
// pts = *(uint64_t *)pFrame->opaque;
// } else if (packet->dts != AV_NOPTS_VALUE) {
// pts = packet->dts;
// } else {
// pts = 0;
// }
pts=av_frame_get_best_effort_timestamp(pFrame);//取得编码数据包中的图像帧显示序号PTS(int64_t),并暂时保存在pts(double)中
/*-------------------------
* 在解码线程函数中计算当前图像帧的显示时间戳
* 1、取得编码数据包中的图像帧显示序号PTS(int64_t),并暂时保存在pts(double)中
* 2、根据PTS*time_base来计算当前桢在整个视频中的显示时间戳，即PTS*(1/framerate)
* av_q2d把AVRatioal结构转换成double的函数，
* 用于计算视频源每个图像帧显示的间隔时间(1/framerate),即返回(time_base->num/time_base->den)
-------------------------*/
//根据pts=PTS*time_base={numerator=1,denominator=25}计算当前桢在整个视频中的显示时间戳
pts*=av_q2d(is->video_st->time_base);//time_base为AVRational有理数结构体{num=1,den=25}，记录了视频源每个图像帧显示的间隔时间
// Did we get a video frame，检查是否解码出完整一帧图像
if (frameFinished) {
pts = synchronize_video(is, pFrame, pts);//检查当前帧的显示时间戳pts并更新内部视频播放计时器(记录视频已经播时间(video_clock)）
if (queue_picture(is, pFrame, pts)<0) {// 将解码完成的图像帧添加到图像帧队列
break;
}
}
av_packet_unref(packet);// 释放pkt中保存的编码数据
}
av_free(pFrame);// 清除pFrame中的内存空间
return 0;
}
//当音频数据不为16位采样格式情况下，采用decode_frame_from_packet计算解码数据长度
int decode_frame_from_packet(VideoState *is, AVFrame decoded_frame) {
if (decoded_frame.channel_layout == 0) {
decoded_frame.channel_layout = av_get_default_channel_layout(decoded_frame.channels);
}
int src_nb_samples = decoded_frame.nb_samples;//一帧数据包含的pcm个数
int src_linesize = (int) decoded_frame.linesize;//扫描行数据长度
uint8_t **src_data = decoded_frame.data;//解码后原始数据缓存指针
int src_rate = decoded_frame.sample_rate;//采样率
int dst_rate = decoded_frame.sample_rate;
int64_t src_ch_layout = decoded_frame.channel_layout;
int64_t dst_ch_layout = decoded_frame.channel_layout;
enum AVSampleFormat src_sample_fmt = decoded_frame.format;
enum AVSampleFormat dst_sample_fmt = AV_SAMPLE_FMT_S16;
av_opt_set_int(is->sws_ctx_audio, "in_channel_layout", src_ch_layout, 0);
av_opt_set_int(is->sws_ctx_audio, "out_channel_layout", dst_ch_layout, 0);
av_opt_set_int(is->sws_ctx_audio, "in_sample_rate", src_rate, 0);
av_opt_set_int(is->sws_ctx_audio, "out_sample_rate", dst_rate, 0);
av_opt_set_sample_fmt(is->sws_ctx_audio, "in_sample_fmt", src_sample_fmt, 0);
av_opt_set_sample_fmt(is->sws_ctx_audio, "out_sample_fmt", dst_sample_fmt, 0);
int ret;//返回结果
// Initialize the resampling context.
if ((ret = swr_init((struct SwrContext *) is->sws_ctx_audio)) < 0) {
fprintf(stderr, "Failed to initialize the resampling context\n");
return -1;
}
// Allocate source and destination samples buffers.
int src_nb_channels=av_get_channel_layout_nb_channels(src_ch_layout);
ret=av_samples_alloc_array_and_samples(&src_data,&src_linesize,src_nb_channels,src_nb_samples,src_sample_fmt,0);
if (ret < 0) {
fprintf(stderr, "Could not allocate source samples\n");
return -1;
}
//Compute the number of converted samples: buffering is avoided ensuring that the output buffer will contain at least all the converted input samples.
int dst_nb_samples = av_rescale_rnd(src_nb_samples, dst_rate, src_rate, AV_ROUND_UP);
int max_dst_nb_samples = dst_nb_samples;
int dst_linesize;
uint8_t **dst_data = NULL;
// Buffer is going to be directly written to a rawaudio file, no alignment.
int dst_nb_channels = av_get_channel_layout_nb_channels(dst_ch_layout);
ret=av_samples_alloc_array_and_samples(&dst_data,&dst_linesize,dst_nb_channels,dst_nb_samples,dst_sample_fmt,0);
if (ret < 0) {
fprintf(stderr, "Could not allocate destination samples\n");
return -1;
}
//Compute destination number of samples.
dst_nb_samples=av_rescale_rnd(swr_get_delay((struct SwrContext*)is->sws_ctx_audio,src_rate)+src_nb_samples,dst_rate,src_rate,AV_ROUND_UP);
//Convert to destination format.
ret=swr_convert((struct SwrContext*)is->sws_ctx_audio,dst_data,dst_nb_samples,(const uint8_t **)decoded_frame.data,src_nb_samples);
if (ret<0) {
fprintf(stderr, "Error while converting\n");
return -1;
}
int dst_bufsize = av_samples_get_buffer_size(&dst_linesize, dst_nb_channels, ret, dst_sample_fmt, 1);
if (dst_bufsize < 0) {
fprintf(stderr, "Could not get sample buffer size\n");
return -1;
}
memcpy(is->audio_buf, dst_data[0], dst_bufsize);
if (src_data) {
av_freep(&src_data[0]);
}
av_freep(&src_data);
if (dst_data) {
av_freep(&dst_data[0]);
}
av_freep(&dst_data);
return dst_bufsize;
}
// 音频解码函数，从缓存队列中提取数据包、解码，并返回解码后的数据长度(对一个完整的packet解码，将解码数据写入audio_buf缓存，并返回多帧解码数据的总长度)
int audio_decode_frame(VideoState *is, double *pts_ptr) {
int coded_consumed_size,data_size=0,pcm_bytes;// 每次消耗的编码数据长度[input](len1)，输出原始音频数据的缓存长度[output]，每组音频采样数据的字节数
AVPacket *pkt = &is->audio_pkt;// 保存从队列中提取的数据包
double pts;//音频播放时间戳
for (;;) {
while (is->audio_pkt_size>0) {// 检查缓存中剩余的编码数据长度(是否已完成一个完整的pakcet包的解码，一个数据包中可能包含多个音频编码帧)
int got_frame = 0;// 解码操作成功标识，成功返回非零值
// 解码一帧音频数据，并返回消耗的编码数据长度
coded_consumed_size = avcodec_decode_audio4(is->audio_st->codec, &is->audio_frame, &got_frame, pkt);
if (coded_consumed_size < 0) {// 检查是否执行了解码操作
// If error, skip frame.
is->audio_pkt_size = 0;// 更新编码数据缓存长度
break;
}
if (got_frame) {// 检查解码操作是否成功
if (is->audio_frame.format != AV_SAMPLE_FMT_S16) {//检查音频数据格式是否为16位采样格式
//当音频数据不为16位采样格式情况下，采用decode_frame_from_packet计算解码数据长度
data_size=decode_frame_from_packet(is, is->audio_frame);
} else {//计算解码后音频数据长度[output]
data_size=av_samples_get_buffer_size(NULL,is->audio_st->codec->channels,is->audio_frame.nb_samples,is->audio_st->codec->sample_fmt, 1);
memcpy(is->audio_buf,is->audio_frame.data[0],data_size);//将解码数据复制到输出缓存
}
}
is->audio_pkt_data += coded_consumed_size;// 更新编码数据缓存指针位置
is->audio_pkt_size -= coded_consumed_size;// 更新缓存中剩余的编码数据长度
if (data_size <= 0) {// 检查输出解码数据缓存长度
// No data yet, get more frames.
continue;
}
pts=is->audio_clock;//用每次更新的音频播放时间更新音频PTS
*pts_ptr=pts;
/*---------------------
* 当一个packet中包含多个音频帧时
* 通过[解码后音频原始数据长度]及[采样率]来推算一个packet中其他音频帧的播放时间戳pts
* 采样频率44.1kHz，量化位数16位，意味着每秒采集数据44.1k个，每个数据占2字节
--------------------*/
pcm_bytes=2*is->audio_st->codec->channels;//计算每组音频采样数据的字节数=每个声道音频采样字节数*声道数
/*----更新audio_clock---
* 一个pkt包含多个音频frame，同时一个pkt对应一个pts(pkt->pts)
* 因此，该pkt中包含的多个音频帧的时间戳由以下公式推断得出
* bytes_per_sec=pcm_bytes*is->audio_st->codec->sample_rate
* 从pkt中不断的解码，推断(一个pkt中)每帧数据的pts并累加到音频播放时钟
--------------------*/
is->audio_clock+=(double)data_size/(double)(pcm_bytes*is->audio_st->codec->sample_rate);
// We have data, return it and come back for more later.
return data_size;// 返回解码数据缓存长度
}
if (pkt->data) {// 检查数据包是否已从队列中提取
av_packet_unref(pkt);// 释放pkt中保存的编码数据
}
if (is->quit) {// 检查退出进程标识
return -1;
}
// Next packet，从队列中提取数据包到pkt
if (packet_queue_get(&is->audioq, pkt, 1) < 0) {
return -1;
}
if (pkt->data == flush_pkt.data) {//检查是否需要重新解码
avcodec_flush_buffers(is->audio_st->codec);//重新解码前需要重置解码器
continue;
}
is->audio_pkt_data = pkt->data;// 传递编码数据缓存指针
is->audio_pkt_size = pkt->size;// 传递编码数据缓存长度
// If update, update the audio clock w/pts
if (pkt->pts != AV_NOPTS_VALUE) {//检查音频播放时间戳
//获得一个新的packet的时候，更新audio_clock，用packet中的pts更新audio_clock(一个pkt对应一个pts)
is->audio_clock=pkt->pts*av_q2d(is->audio_st->time_base);//更新音频已经播的时间
}
}
}
/*------Audio Callback-------
* 音频输出回调函数，sdl通过该回调函数将解码后的pcm数据送入声卡播放,
* sdl通常一次会准备一组缓存pcm数据，通过该回调送入声卡，声卡根据音频pts依次播放pcm数据
* 待送入缓存的pcm数据完成播放后，再载入一组新的pcm缓存数据(每次音频输出缓存为空时，sdl就调用此函数填充音频输出缓存，并送入声卡播放)
* When we begin playing audio, SDL will continually call this callback function
* and ask it to fill the audio buffer with a certain number of bytes
* The audio function callback takes the following parameters:
* stream: A pointer to the audio buffer to be filled，输出音频数据到声卡缓存
* len: The length (in bytes) of the audio buffer,缓存长度wanted_spec.samples=SDL_AUDIO_BUFFER_SIZE(1024)
--------------------------*/
void audio_callback(void *userdata, Uint8 *stream, int len) {
VideoState *is = (VideoState *) userdata;// 传递用户数据
int wt_stream_len, audio_size;// 每次写入stream的数据长度，解码后的数据长度
double pts;//音频时间戳
while (len > 0) {//检查音频缓存的剩余长度
if (is->audio_buf_index >= is->audio_buf_size) {// 检查是否需要执行解码操作
// We have already sent all our data; get more，从缓存队列中提取数据包、解码，并返回解码后的数据长度，audio_buf缓存中可能包含多帧解码后的音频数据
audio_size = audio_decode_frame(is, &pts);
if (audio_size < 0) {// 检查解码操作是否成功
// If error, output silence.
is->audio_buf_size = 1024;
memset(is->audio_buf, 0, is->audio_buf_size);// 全零重置缓冲区
} else {
//在回调函数中增加音频同步过程，即对音频数据缓存进行丢帧(或插值)，以起到降低音频时钟与主同步源时差的目的
audio_size=synchronize_audio(is,(int16_t*)is->audio_buf,audio_size,pts);//返回音频同步后的缓存长度
is->audio_buf_size = audio_size;// 返回packet中包含的原始音频数据长度(多帧)
}
is->audio_buf_index = 0;// 初始化累计写入缓存长度
}//end for if
wt_stream_len=is->audio_buf_size-is->audio_buf_index;// 计算解码缓存剩余长度
if (wt_stream_len > len) {// 检查每次写入缓存的数据长度是否超过指定长度(1024)
wt_stream_len = len;// 指定长度从解码的缓存中取数据
}
// 每次从解码的缓存数据中以指定长度抽取数据并写入stream传递给声卡
memcpy(stream, (uint8_t *)is->audio_buf + is->audio_buf_index, wt_stream_len);
len -= wt_stream_len;// 更新解码音频缓存的剩余长度
stream += wt_stream_len;// 更新缓存写入位置
is->audio_buf_index += wt_stream_len;// 更新累计写入缓存数据长度
}//end for while
}
// 根据指定类型打开流，找到对应的解码器、创建对应的音频配置、保存关键信息到 VideoState、启动音频和视频线程
int stream_component_open(VideoState *is, int stream_index) {
AVFormatContext *pFormatCtx = is->pFormatCtx;// 传递文件容器的封装信息及码流参数
AVCodecContext *codecCtx = NULL;// 解码器上下文对象，解码器依赖的相关环境、状态、资源以及参数集的接口指针
AVCodec *codec = NULL;// 保存编解码器信息的结构体，提供编码与解码的公共接口，可以看作是编码器与解码器的一个全局变量
//检查输入的流类型是否在合理范围内
if (stream_index < 0 || stream_index >= pFormatCtx->nb_streams) {
return -1;
}
// Get a pointer to the codec context for the video stream.
codecCtx = pFormatCtx->streams[stream_index]->codec;// 取得解码器上下文
if (codecCtx->codec_type == AVMEDIA_TYPE_AUDIO) {//检查解码器类型是否为音频解码器
SDL_AudioSpec wanted_spec, spec;//SDL_AudioSpec a structure that contains the audio output format，创建 SDL_AudioSpec 结构体，设置音频播放数据
// Set audio settings from codec info,SDL_AudioSpec a structure that contains the audio output format
// 创建SDL_AudioSpec结构体，设置音频播放参数
wanted_spec.freq = codecCtx->sample_rate;//采样频率 DSP frequency -- samples per second
wanted_spec.format = AUDIO_S16SYS;//采样格式 Audio data format
wanted_spec.channels = codecCtx->channels;//声道数 Number of channels: 1 mono, 2 stereo
wanted_spec.silence = 0;//无输出时是否静音
//默认每次读音频缓存的大小，推荐值为 512~8192，ffplay使用的是1024 specifies a unit of audio data refers to the size of the audio buffer in sample frames
wanted_spec.samples = SDL_AUDIO_BUFFER_SIZE;
wanted_spec.callback = audio_callback;//设置读取音频数据的回调接口函数 the function to call when the audio device needs more data
wanted_spec.userdata = is;//传递用户数据
/*---------------------------
* 以指定参数打开音频设备，并返回与指定参数最为接近的参数，该参数为设备实际支持的音频参数
* Opens the audio device with the desired parameters(wanted_spec)
* return another specs we actually be using
* and not guaranteed to get what we asked for
--------------------------*/
if (SDL_OpenAudio(&wanted_spec, &spec) < 0) {
fprintf(stderr, "SDL_OpenAudio: %s\n", SDL_GetError());
return -1;
}
is->audio_hw_buf_size = spec.size;
}
/*-----------------------
* Find the decoder for the video stream，根据视频流对应的解码器上下文查找对应的解码器，返回对应的解码器(信息结构体)
* The stream's information about the codec is in what we call the "codec context.
* This contains all the information about the codec that the stream is using
-----------------------*/
codec = avcodec_find_decoder(codecCtx->codec_id);
AVDictionary *optionsDict = NULL;
if (!codec || (avcodec_open2(codecCtx, codec, &optionsDict) < 0)) {
// __android_log_print(ANDROID_LOG_INFO, "main", "打开解码器失败\n");
return -1;
}
// 打印解码器信息
// __android_log_print(ANDROID_LOG_INFO, "main", "解码器名称：%s\n", codec->name);
// 检查解码器类型
switch(codecCtx->codec_type) {
case AVMEDIA_TYPE_AUDIO:// 音频解码器
is->audioStream = stream_index;// 音频流类型标号初始化
is->audio_st = pFormatCtx->streams[stream_index];
is->audio_buf_size = 0;// 解码后的多帧音频数据长度
is->audio_buf_index = 0;//累 计写入stream的长度
// Averaging filter for audio sync.
is->audio_diff_avg_coef=exp(log(0.01/AUDIO_DIFF_AVG_NB));//音频时钟与主同步源累计时差加权系数
is->audio_diff_avg_count=0;//音频不同步计数初始化
// Correct audio only if larger error than this.
is->audio_diff_threshold=2.0*SDL_AUDIO_BUFFER_SIZE/codecCtx->sample_rate;
is->sws_ctx_audio = (struct SwsContext *) swr_alloc();
if (!is->sws_ctx_audio) {
fprintf(stderr, "Could not allocate resampler context\n");
return -1;
}
memset(&is->audio_pkt, 0, sizeof(is->audio_pkt));
packet_queue_init(&is->audioq);// 音频数据包队列初始化
SDL_PauseAudio(0);// audio callback starts running again，开启音频设备，如果这时候没有获得数据那么它就静音
break;
case AVMEDIA_TYPE_VIDEO:// 视频解码器
is->videoStream = stream_index;// 视频流类型标号初始化
is->video_st = pFormatCtx->streams[stream_index];
//以系统时间为基准，初始化播放到当前帧的已播放时间值，该值为真实时间值、动态时间值、绝对时间值
is->frame_timer=(double)av_gettime()/1000000.0;
is->frame_last_delay = 40e-3;//初始化上一帧图像的动态刷新延迟时间
is->video_current_pts_time = av_gettime();//取得系统当前时间
packet_queue_init(&is->videoq);// 视频数据包队列初始化
is->decode_tid = SDL_CreateThread(decode_thread,"视频解码线程" ,is);// 创建视频解码线程
// Initialize SWS context for software scaling，设置图像转换像素格式为AV_PIX_FMT_YUV420P
is->sws_ctx = sws_getContext(is->video_st->codec->width, is->video_st->codec->height, is->video_st->codec->pix_fmt, is->video_st->codec->width, is->video_st->codec->height, AV_PIX_FMT_YUV420P, SWS_BILINEAR, NULL, NULL, NULL);
codecCtx->get_buffer2 = our_get_buffer;
break;
default:
break;
}
return 0;
}
//清除队列缓存，释放队列中所有动态分配的内存
static void packet_queue_flush(PacketQueue *q) {
AVPacketList *pkt, *pkttmp;//队列当前节点，临时节点
SDL_LockMutex(q->qlock);//锁定互斥量
for (pkt = q->first_pkt; pkt != NULL; pkt = pkttmp) {//遍历队列所有节点
pkttmp = pkt->next;//队列头节点后移
av_packet_unref(&pkt->pkt);//当前节点引用计数-1
av_freep(&pkt);//释放当前节点缓存
}
q->last_pkt = NULL;//队列尾节点指针置零
q->first_pkt = NULL;//队列头节点指针置零
q->nb_packets = 0;//队列长度置零
q->size = 0;//队列编码数据的缓存长度置零
SDL_UnlockMutex(q->qlock);//互斥量解锁
}
// 编码数据包解析线程函数(从视频文件中解析出音视频编码数据单元，一个AVPacket的data通常对应一个NAL)
int parse_thread(void *arg) {
VideoState *is = (VideoState *)arg;// 传递用户参数
global_video_state = is;// 传递全局状态参量结构体
/*-------------------------
* 打开封装格式
* 打开视频文件，读文件头内容，取得文件容器的封装信息及码流参数并存储在avformat_context中
* 参数一：封装格式上下文
* 参数二：视频路径
* 参数三：指定输入的格式
* 参数四：设置默认参数
--------------------------*/
AVFormatContext *avformat_context = NULL;// 参数一：封装格式上下文
int avformat_open_input_result = avformat_open_input(&avformat_context, is->filename, NULL, NULL);
if (avformat_open_input_result != 0){
// __android_log_print(ANDROID_LOG_INFO, "main", "查找音视频流\n");
return -1;
}
is->pFormatCtx = avformat_context;//传递文件容器封装信息及码流参数
/*-------------------------
* 查找码流
* 取得文件中保存的码流信息，并填充到avformat_context->stream 字段
* 参数一：封装格式上下文
* 参数二：指定默认配置
-------------------------*/
int avformat_find_stream_info_result = avformat_find_stream_info(avformat_context, NULL);
if (avformat_find_stream_info_result < 0){
// __android_log_print(ANDROID_LOG_INFO, "main", "查找音视频流失败\n");
return -1;
}
// 查找解码器
is->videoStream = -1;//视频流类型标号初始化为-1
is->audioStream = -1;//音频流类型标号初始化为-1
// 视频流类型标号初始化为-1
int av_video_stream_index = -1;
// 音频流类型标号初始化为-1
int av_audio_stream_index = -1;
for (int i = 0; i < avformat_context->nb_streams; ++i) {
// 若文件中包含有视频流
if (avformat_context->streams[i]->codec->codec_type == AVMEDIA_TYPE_VIDEO){
av_video_stream_index = i;
}
// 若文件中包含有音频流
if (avformat_context->streams[i]->codec->codec_type == AVMEDIA_TYPE_AUDIO){
av_audio_stream_index = i;
}
}
// 检查文件中是否存在视频流
if (av_video_stream_index == -1) {
// __android_log_print(ANDROID_LOG_INFO, "main", "没有找到视频流\n");
goto fail;//跳转至异常处理
return -1;
}
// 检查文件中是否存在音频流
if (av_audio_stream_index == -1) {
// __android_log_print(ANDROID_LOG_INFO, "main", "没有找到音频流\n");
goto fail;//跳转至异常处理
return -1;
}
stream_component_open(is, av_audio_stream_index);// 根据指定类型打开音频流
stream_component_open(is, av_video_stream_index);// 根据指定类型打开视频流
// Main decode loop.
for (;;) {
if (is->quit) {//检查退出进程标识
break;
}
// Seek stuff goes here
if (is->seek_req) {//检查[快进]/[快退]操作标志位是否开启
int stream_index= -1;//初始化音视频流类型标号
int64_t seek_target = is->seek_pos;//取得[快进]/[快退]操作后的参考时间戳
if (is->videoStream >= 0) {//检查是否取得视频流类型标号
stream_index = is->videoStream;//取得视频流类型标号
} else if (is->audioStream >= 0) {//检查是否取得音频流类型标号
stream_index = is->audioStream;//取得音频流类型标号
}
if (stream_index >= 0){//检查是否取得音视频流类型标号
//时间单位转换，将seek_target的单位由AV_TIME_BASE_Q转换为time_base
seek_target= av_rescale_q(seek_target, AV_TIME_BASE_Q, avformat_context->streams[stream_index]->time_base);
}
//根据[快进]/[快退]操作后的时间戳，跳到指定帧(该函数只能跳到离指定帧最近的关键帧)
if (av_seek_frame(is->pFormatCtx, stream_index, seek_target, is->seek_flags) < 0) {
fprintf(stderr, "%s: error while seeking\n", is->pFormatCtx->filename);
} else {//在执行[快进]/[快退]操作后，立刻清空缓存队列，并重置音视频解码器
if (is->audioStream >= 0) {//检查是否取得音频流类型标号
packet_queue_flush(&is->audioq);//清除音频队列缓存，释放队列中所有动态分配的内存
packet_queue_put(&is->audioq, &flush_pkt);//将flush_pkt插入音频数据包队列，执行重置音频解码器操作avcodec_flush_buffers
}
if (is->videoStream >= 0) {//取得视频流类型标号
packet_queue_flush(&is->videoq);//清除视频队列缓存，释放队列中所有动态分配的内存
packet_queue_put(&is->videoq, &flush_pkt);//将flush_pkt插入视频数据包队列，执行重置视频解码器操作avcodec_flush_buffers
}
}
is->seek_req = 0;//关闭[快进]/[快退]操作标志位
}//end for if (is->seek_req)
// Seek stuff goes here，检查音视频编码数据包队列长度是否溢出
if (is->audioq.size > MAX_AUDIOQ_SIZE || is->videoq.size > MAX_VIDEOQ_SIZE) {
SDL_Delay(10);
continue;
}
/*-----------------------
* read in a packet and store it in the AVPacket struct
* ffmpeg allocates the internal data for us,which is pointed to by packet.data
* this is freed by the av_free_packet()
-----------------------*/
// 负责保存压缩编码数据相关信息的结构体,每帧图像由一到多个packet包组成
AVPacket pkt, *packet = &pkt;// 在栈上创建临时数据包对象并关联指针
if (av_read_frame(is->pFormatCtx, packet) < 0) {
if (is->pFormatCtx->pb->error == 0) {
SDL_Delay(100); // No error; wait for user input.
continue;
} else {
break;
}
}
// Is this a packet from the video stream?
if (packet->stream_index == is->videoStream) {// 检查数据包是否为视频类型
packet_queue_put(&is->videoq, packet);// 向队列中插入数据包
} else if (packet->stream_index == is->audioStream) {// 检查数据包是否为音频类型
packet_queue_put(&is->audioq, packet);// 向队列中插入数据包
} else {// 检查数据包是否为字幕类型
av_packet_unref(packet);// 释放packet中保存的(字幕)编码数据
}
}
// All done - wait for it.
while (!is->quit) {
SDL_Delay(100);
}
fail:// 异常处理
if (1) {
SDL_Event event;// SDL事件对象
event.type = FF_QUIT_EVENT;// 指定退出事件类型
event.user.data1 = is;// 传递用户数据
SDL_PushEvent(&event);// 将该事件对象压入SDL后台事件队列
}
return 0;
}
int init_sdl(VideoState *is) {
// 初始化SDL多媒体框架
if (SDL_Init( SDL_INIT_VIDEO | SDL_INIT_AUDIO | SDL_INIT_TIMER ) == -1) {
// __android_log_print(ANDROID_LOG_INFO, "main", "初始化失败：%s", SDL_GetError());
// Mac使用
// printf("初始化失败：%s", SDL_GetError());
return -1;
}
// SDL中获取屏幕尺寸
SDL_DisplayMode DM;
SDL_GetCurrentDisplayMode(0, &DM);
// 初始化SDL窗口
SDL_Window* sdl_window = SDL_CreateWindow("FFmpeg+SDL播放视频",// 参数一：窗口名称
SDL_WINDOWPOS_CENTERED,// 参数二：窗口在屏幕上的x坐标
SDL_WINDOWPOS_CENTERED,// 参数三：窗口在屏幕上的y坐标
DM.w,// 参数四：窗口在屏幕上宽
DM.h,// 参数五：窗口在屏幕上高
SDL_WINDOW_OPENGL);// 参数六：窗口状态(打开)
if (sdl_window == NULL){
// __android_log_print(ANDROID_LOG_INFO, "main", "窗口创建失败：%s", SDL_GetError());
// Mac使用
// printf("窗口创建失败： %s\n", SDL_GetError());
// 退出程序
SDL_Quit();
return -1;
}
screen = sdl_window;
// 创建渲染器
// 定义渲染器区域
SDL_Renderer* sdl_renderer = SDL_CreateRenderer(sdl_window,// 渲染目标创建
-1, // 从那里开始渲染(-1:表示从第一个位置开始)
0);// 渲染类型(软件渲染)
if (sdl_renderer == NULL){
// __android_log_print(ANDROID_LOG_INFO, "main", "渲染器创建失败：%s", SDL_GetError());
// Mac使用
// printf("渲染器创建失败： %s\n", SDL_GetError());
// 退出程序
SDL_Quit();
return -1;
}
// 创建纹理
SDL_Texture* sdl_texture = SDL_CreateTexture(sdl_renderer,// 渲染器
SDL_PIXELFORMAT_IYUV,// 像素数据格式
SDL_TEXTUREACCESS_STREAMING,// 绘制方式：频繁绘制-
is->video_width,// 纹理宽
is->video_height);// 纹理高
if (sdl_texture == NULL) {
// __android_log_print(ANDROID_LOG_INFO, "main", "纹理创建失败：%s", SDL_GetError());
// Mac使用
// printf("纹理创建失败： %s\n", SDL_GetError());
// 退出程序
SDL_Quit();
return -1;
}
is->sdl_renderer = sdl_renderer;
is->sdl_texture = sdl_texture;
return 0;
}
//设置[快进]/[快退]状态参数
void stream_seek(VideoState *is, int64_t pos, int rel) {
if (!is->seek_req) {//检查[快进]/[快退]操作标志位是否开启
is->seek_pos = pos;//更新[快进]/[快退]后的参考时间戳
is->seek_flags = rel < 0 ? AVSEEK_FLAG_BACKWARD : 0;//确定[快进]还是[快退]操作
is->seek_req = 1;//开启[快进]/[快退]标志位
}
}
int init_controller(VideoState *is) {
SDL_Window *sdl_window2 = SDL_GL_GetCurrentWindow();
SDL_SysWMinfo systemWindowInfo;
SDL_VERSION(&systemWindowInfo.version);
if (!SDL_GetWindowWMInfo(sdl_window2, &systemWindowInfo)) {
return -1;
}
ViewController *vc = [ViewController new];
vc.tapFastForwardButtonBlock = ^{
printf("前进10秒\n");
if (global_video_state) {
double incr, pos;
incr = 10.0;
pos = get_master_clock(global_video_state);//取得当前主同步源时间戳
pos += incr;//根据键盘操作更新主同步源时间戳(AV_TIME_BASE为时间戳基准值)
stream_seek(global_video_state,(int64_t)(pos*AV_TIME_BASE),incr);//根据主同步源时间戳设置查找位置
}
};
vc.tapFastBackwardButtonBlock = ^{
printf("后退10秒\n");
if (global_video_state) {
double incr, pos;
incr = -10.0;
pos = get_master_clock(global_video_state);//取得当前主同步源时间戳
pos += incr;//根据键盘操作更新主同步源时间戳(AV_TIME_BASE为时间戳基准值)
stream_seek(global_video_state,(int64_t)(pos*AV_TIME_BASE),incr);//根据主同步源时间戳设置查找位置
}
};
UIWindow *customWindow = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
customWindow.rootViewController = vc;
[customWindow makeKeyAndVisible];
[systemWindowInfo.info.uikit.window addSubview:customWindow];
return 0;
}
// SDL入口
//extern "C"
int main(int argc, char *argv[]) {
/*-------------------------
* 注册组件
* 注册所有ffmpeg支持的多媒体格式及编解码器
-------------------------*/
av_register_all();
// 创建全局状态对象
VideoState *is= (VideoState *)av_mallocz(sizeof(VideoState));
NSString* inPath = [[NSBundle mainBundle] pathForResource:@"test" ofType:@"mov"];
av_strlcpy(is->filename, [inPath UTF8String], sizeof(is->filename));// 复制视频文件路径名
is->video_width = 640;
is->video_height = 352;
// av_strlcpy(is->filename, "/storage/emulated/0/DCIM/Camera/TG-2022-04-13-160703582.mp4", sizeof(is->filename));// 复制视频文件路径名
// is->video_width = 720;
// is->video_height = 1280;
is->pictq_lock = SDL_CreateMutex();// 创建编码数据包队列互斥锁对象
is->pictq_ready = SDL_CreateCond();// 创建编码数据包队列就绪条件对象
int init_sdl_result = init_sdl(is);
if (init_sdl_result < 0) {
// __android_log_print(ANDROID_LOG_INFO, "main", "初始化SDL失");
}
init_controller(is);
// 在指定的时间(40ms)后回调用户指定的函数，进行图像帧的显示更新
schedule_refresh(is, 40);
is->av_sync_type = DEFAULT_AV_SYNC_TYPE;//指定主同步源
// 创建编码数据包解析线程
is->parse_tid = SDL_CreateThread(parse_thread, "编码数据包解析线程", is);
if (!is->parse_tid) {// 检查线程是否创建成功
av_free(is);
return -1;
}
av_init_packet(&flush_pkt);//初始化flush_pkt
//将flush_pkt的data成员指定为"FLUSH"，当数据包队列中某个包的data成员取值为"FLUSH"，执行重置解码器操作
flush_pkt.data = (unsigned char *) "FLUSH";
// SDL事件对象
SDL_Event event;
for (;;) {// SDL事件循环
SDL_WaitEvent(&event);// 主线程阻塞，等待事件到来
switch(event.type) {// 事件到来后唤醒主线程，检查事件类型
case FF_QUIT_EVENT:
case SDL_QUIT:// 退出进程事件
is->quit = 1;
// If the video has finished playing, then both the picture and audio queues are waiting for more data.
// Make them stop waiting and terminate normally..
avcodec_close(is->video_st->codec);
avformat_free_context(is->pFormatCtx);
SDL_CondSignal(is->audioq.qready);// 发出队列就绪信号避免死锁
SDL_CondSignal(is->videoq.qready);
SDL_DestroyTexture(is->sdl_texture);
SDL_DestroyRenderer(is->sdl_renderer);
SDL_Quit();
return 0;
case FF_ALLOC_EVENT:
alloc_picture(event.user.data1);// 分配视频帧事件响应函数
break;
case FF_REFRESH_EVENT:// 视频显示刷新事件
video_refresh_timer(event.user.data1);// 视频显示刷新事件响应函数
break;
default:
break;
}
}
return 0;
}