使用avformat_alloc_output_context2創建輸出文件

AVFormatContext是FFmpeg中最核心且最為重要的一個結構體，它包含了視頻和音頻編解碼器、封裝格式、媒體文件和音視頻流等元信息。而在輸出過程中，我們需要構建一個AVFormatContext來描述輸出文件的各種元信息，avformat_alloc_output_context2就是用來創建這個AVFormatContext的。

一、函數介紹

avformat_alloc_output_context2函數的定義如下：

AVOutputFormat *ofmt = av_guess_format(format_name, filename, nullptr);
AVFormatContext *ofc = nullptr;
if (ofmt) {
    avformat_alloc_output_context2(&ofc, ofmt, format_name, filename);
    // ...
}

其中，ofmt通過av_guess_format函數獲取，它表示所要生成的媒體文件的封裝格式。模塊通過提供的文件名來判斷應該使用哪種封裝格式。對於某些封裝格式，必須指定擴展名才能正確推斷出封裝格式。

同時，還可以通過第三個參數指定實際上寫入的文件類型。這個類型可以與ofmt不同。例如，推薦使用「matroska」作為封裝選項，並定義AVOutputFormat。在這種情況下，filename可以是保存在.mp4文件中的鏈接，但實際的封裝容器是Matroska。

函數的返回值為0表示成功，否則表示失敗。

二、創建AVFormatContext

在輸出過程中，我們需要創建一個AVFormatContext來描述輸出文件的各種元信息。avformat_alloc_output_context2就是用來創建這個AVFormatContext的。

首先需要獲取AVOutputFormat，示例如下：

AVOutputFormat *ofmt = av_guess_format(format_name, filename, nullptr);

接下來就可以通過調用avformat_alloc_output_context2來創建AVFormatContext了：

AVFormatContext *ofc = nullptr;
if (ofmt) {
    avformat_alloc_output_context2(&ofc, ofmt, format_name, filename);
    if (!ofc) {
        // 創建成功
    }
}

其中ofmt表示輸出文件的封裝格式，format_name和filename可以指定類型或擴展名，根據需要進行設置。

三、管理AVFormatContext

在使用AVFormatContext時，需要進行管理，確保資源的正確釋放。下面幾個函數與avformat_alloc_output_context2相關聯，一同來進行介紹：

• avformat_alloc_output_context2：創建AVFormatContext
• avformat_free_context：釋放AVFormatContext及其內部資源
• avio_open：打開指定URL並將其與AVFormatContext相互關聯
• av_dict_set：設置AVFormatContext的元數據信息（作者、標籤、標題、日期）

這些函數中，avformat_free_context是最重要的函數。在所有工作已經完成並關閉輸出文件時，必須確保對AVFormatContext及其內部內容進行釋放。

四、處理錯誤和成功

在操作avformat_alloc_output_context2的過程中，可能會發生各種異常情況。

例如，當參數ofmt為nullptr時，avformat_alloc_output_context2函數將返回一個錯誤。因此，在顯式調用AVFormatContext之前，必須檢查ofmt是否為nullptr。

而當創建成功時，ofc不應該為nullptr，並且返回0。

AVFormatContext *ofc = nullptr;
if (ofmt) {
    int ret = avformat_alloc_output_context2(&ofc, ofmt, format_name, filename);
    if (ret < 0) {
        // 創建AVFormatContext失敗
    } else {
        // 創建AVFormatContext成功
    }
}

五、總結

avformat_alloc_output_context2是一個用於創建AVFormatContext的函數。創建成功後，還需要進一步使用其他AVFormatContext管理函數來打開文件、設置元數據信息和釋放資源。同時，在使用avformat_alloc_output_context2時，需要考慮到各種異常情況的處理。