在做音視頻數據分析的時候，經常會遇到這樣的需求，每隔5分鐘抽取一幀數據進行分析。

在做播放器開發的時候，也會遇到這種情況，就是拖動進度條跳轉到某個位置進行播放。

如果直接用?av_read_frame()?不斷讀數據，讀到第 5 分鐘的?AVPacket?才開始處理，其他讀出來的?AVPacket?丟棄，這樣做會帶來非常大的磁盤IO。

其實上面兩種場景，都可以用同一個函數解決，那就是?avformat_seek_file()，這個函數類似于?Linux?的?lseek()?，設置文件的讀取位置。

只不過?avformat_seek_file()?是用于音視頻文件的。

---

avformat_seek_file()?函數的定義如下：

int avformat_seek_file(AVFormatContext *s, int stream_index, int64_t min_ts, int64_t ts, int64_t max_ts, int flags);

參數解釋如下：

1，AVFormatContext *s，已經打開的容器示例。

2，int stream_index，流索引，但是只有在?flags?包含?AVSEEK_FLAG_FRAME?的時候才是?設置某個流的讀取位置。其他情況都只是把這個流的 time_base （時間基）作為參考。

3，int64_t min_ts，跳轉到的最小的時間，但是這個變量不一定是時間單位，也有可能是字節單位，也可能是幀數單位（第幾幀）。

4，int64_t ts，要跳轉到的讀取位置，單位同上。

5，int64_t max_ts，跳轉到的最大的時間，單位同上，通常填?INT64_MAX?即可。

6，int flags，跳轉的方式，有 4 個?flags，如下：

• AVSEEK_FLAG_BYTE，按字節大小進行跳轉。
• AVSEEK_FLAG_FRAME，按幀數大小進行跳轉。
• AVSEEK_FLAG_ANY，可以跳轉到非關鍵幀的讀取位置，但是解碼會出現馬賽克。
• AVSEEK_FLAG_BACKWARD，往?ts?的后面找關鍵幀，默認是往?ts?的前面找關鍵幀。

---

avformat_seek_file()?函數默認是把文件的讀取位置，設置到離?ts?參數最近的關鍵幀的地方。

而且默認情況，是容器里面所有流的讀取位置都會被設置，包括 音頻流，視頻流，字幕流。

只要流的?discard?屬性小于?AVDISCARD_ALL?就會被設置。

AVStream.discard < AVDISCARD_ALL

---

min_ts?跟?max_ts?變量有一些設置的技巧。

如果是快進的時候，min_ts?可以設置得比 當前位置 大一點，例如加 2。 而?max_ts?可以填?INT64_MAX

min_ts = 當前位置 + 2 max_ts = INT64_MAX

+2?是為了防止某些情況，avformat_seek_file()?會把讀取位置往后挪一點。

如果是后退的時候，min_ts?可以填 INT64_MIN，max_ts?可以設置得比 當前位置 小一點，例如減 2。

min_ts = INT64_MIN max_ts = 當前位置 - 2

-2?是為了防止某些情況，avformat_seek_file()?會把讀取位置往前挪一點。

---

當?flags?為 0 的時候，默認情況，是按時間來?seek?的，而時間基是根據?stream_index?來確定的。

如果?stream_index?為?-1?，那?ts?的時間基就是?AV_TIME_BASE，

如果stream_index?不等于?-1?，那?ts?的時間基就是?stream_index?對應的流的時間基。

這種情況，avformat_seek_file()?會導致容器里面所有流的讀取位置都發生跳轉，包括音頻流，視頻流，字幕流。

---

當?flags?包含?AVSEEK_FLAG_BYTE，ts?參數就是字節大小，代表?avformat_seek_file()?會把讀取位置設置到第幾個字節。用?av_read_frame()?讀出來的?pkt?里面有一個字段?pos，代表當前讀取的字節位置?？梢杂胮kt->pos?輔助設置?ts?參數，

AVSEEK_FLAG_BYTE?是否是對所有流都生效，我后面測試一下再補充。

---

當?flags?包含?AVSEEK_FLAG_FRAME，ts?參數就是幀數大小，代表?avformat_seek_file()?會把讀取位置設置到第幾幀。這時候?stream_index?可以指定只設置某個流的讀取位置，如果?stream_index?為?-1?，代表設置所有的流。

---

當?flags?包含?AVSEEK_FLAG_ANY，那就代表?seek?可以跳轉到非關鍵幀的位置，但是非關鍵幀解碼會出現馬賽克。如果不設置?AVSEEK_FLAG_ANY， 默認是跳轉到離?ts?最近的關鍵幀的位置的。

---

當?flags?包含?AVSEEK_FLAG_BACKWARD，代表?avformat_seek_file()?在查找里?ts?最近的關鍵幀的時候，會往?ts?的后面找，默認是往?ts?的前面找關鍵幀。

提醒：AVSEEK_FLAG_BYTE?，AVSEEK_FLAG_FRAME，AVSEEK_FLAG_ANY?這 3 種方式，有些封裝格式是不支持的。

---

下面通過一個例子來演示?avformat_seek_file()?函數的用法。代碼下載地址：GitHb，編譯環境是 Qt 5.15.2 跟 MSVC2019_64bit 。

運行結果如下：

可以看到，跳轉之后，后面?av_read_frame()?讀取到的?AVPacket?的?pts?跟?pos?都有很大的偏移了。

avformat_seek_file()?函數介紹完畢。

擴展知識：avformat_seek_file()?對應的舊版函數是?av_seek_frame()

---

推薦一個零聲學院免費公開課程，個人覺得老師講得不錯，分享給大家：

Linux，Nginx，ZeroMQ，MySQL，Redis，fastdfs，MongoDB，ZK，流媒體，CDN，P2P，K8S，Docker，TCP/IP，協程，DPDK等技術內容，立即學習

總結

以上是生活随笔為你收集整理的avformat_seek_file函数介绍的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。