1. 介紹
首先，需要明確一個根本問題。OpenCV 是一個基于 Apache2.0 許可（開源）發行的跨平臺計算機視覺和機器學習軟件庫。它實際上各種圖像處理和計算機視覺方面的通用算法的集中庫。
簡而言之就是：處理圖片。
通常都是使用 OpenCV 來進行各種圖片處理和計算。所以它并不是一個視頻編解碼庫。不要想著使用 OpenCV 來進行視頻播放
所有使用 OpenCV 進行播放視頻，實際上都是將視頻轉圖片了，再一張張圖片在切換顯示，編解碼和效率是遠遠沒有專門的視頻播放器效率高的。
如果要播放視頻，還是建議使用 FFmpeg 處理。
而我們可以通過OpenCV將視頻進行解碼成Mat文件，進行操作，并將編輯之后的結果存儲為視頻。
可以將相機拍攝的結果，進行實時處理之后。存儲為視頻等操作。
而使用到的就是VideoWriter? 和 VideoCapture類了。
以下內容基于：OpenCV 4.6.0 版本API進行的介紹和使用。
2. VideoCapture
用于從視頻文件、圖像序列或相機捕獲視頻的類。這個類提供了針對視頻的各種捕獲方法。
提供了幾種方法：
1.獲取每一幀數據，轉為Mat。
2.獲取視頻的一些配置信息，例如時長，FPS，幀數，寬高等等。
初始化如下：
VideoCapture videoCapture = new VideoCapture(); //創建一個VideoCapture對象
我們其實在創建過程中的時候，也可以進行初始化傳參。這些構造初始化時傳的參數和調用open()方法傳的參數實際是一樣的。
PS：使用 OpenCV 的方法時，請注意需要提前進行初始化加載 OpenCV 庫。否則會出現相關類找不到而崩潰
OpenCVLoader.initDebug(false);//加載OpenCV庫
2.1 加載 open() 方法
下面不管是相機加載，還是網絡地址加載。我在 Android 端上沒有成功。只有加載本地視頻成功了。
加載攝像頭應該是 Android 本身不支持的原因造成的。嘗試了各種 cameraId 值和相關 apiPreference 都失敗了。(我們可以使用CameraX加載攝像頭并進行處理和存儲)
加載網絡視頻失敗我估計，應該是因為 openCV 默認編譯的 Android SDK 中沒有相關依賴造成的。
（如果是缺少依賴庫造成的，希望能夠有明白的小伙伴指點一下吧。各種嘗試我都失敗了）。
boolean isOpen = videoCapture.open("/storage/emulated/0/Android/data/com.zinyan.demo/files/demo.mp4", Videoio.CAP_ANDROID); //加載本地視頻
boolean isOpen = videoCapture.open(0); //加載攝像頭
boolean isOpen = videoCapture.open("https://host:port/script_name?script_params|auth", Videoio.CAP_ANDROID); //加載網絡視頻。open方法傳遞主要是以下一種參數：
- String filename：文件地址，可以是Url地址也可以是本地文檔地址。
- int index：相機id， 如果0 會調用設備默認的后置攝像頭。
- int apiPreference: api首選項。該參數為：Videoio.CAP_ANY，Videoio.CAP_DSHOW,Videoio.CAP_ANDROID等.
VideoCapture? 中傳入的apiPrefreence的可選參數列表如下所示：
// C++: enum VideoCaptureAPIs
public static final int
CAP_ANY = 0,
CAP_VFW = 200,
CAP_V4L = 200,
CAP_V4L2 = CAP_V4L,
CAP_FIREWIRE = 300,
CAP_FIREWARE = CAP_FIREWIRE,
CAP_IEEE1394 = CAP_FIREWIRE,
CAP_DC1394 = CAP_FIREWIRE,
CAP_CMU1394 = CAP_FIREWIRE,
CAP_QT = 500,
CAP_UNICAP = 600,
CAP_DSHOW = 700,
CAP_PVAPI = 800,
CAP_OPENNI = 900,
CAP_OPENNI_ASUS = 910,
CAP_ANDROID = 1000,
CAP_XIAPI = 1100,
CAP_AVFOUNDATION = 1200,
CAP_GIGANETIX = 1300,
CAP_MSMF = 1400,
CAP_WINRT = 1410,
CAP_INTELPERC = 1500,
CAP_REALSENSE = 1500,
CAP_OPENNI2 = 1600,
CAP_OPENNI2_ASUS = 1610,
CAP_GPHOTO2 = 1700,
CAP_GSTREAMER = 1800,
CAP_FFMPEG = 1900,
CAP_IMAGES = 2000,
CAP_ARAVIS = 2100,
CAP_OPENCV_MJPEG = 2200,
CAP_INTEL_MFX = 2300,
CAP_XINE = 2400;
調用open()方法后，如果加載成功了就會返回true，失敗則返回false。
由于，我只是加載本地視頻能夠實現成功加載。所以下面的介紹也是基于該成功之后進行的。
在Android端中，如果想能夠正確的打開視頻并進行解析。apiPrefreence的值只有：
Videoio.CAP_ANY? 或者 Videoio.CAP_ANDROID才能正確加載視頻
返回的isOpen才是true。示例如下：
boolean isOpen = videoCapture.open(fileUrl, Videoio.CAP_ANY);
boolean isOpen = videoCapture.open(fileUrl, Videoio.CAP_ANDROID);
我有嘗試過使用CAP_FFMPEG當做值，進行加載。
boolean isOpen = videoCapture.open(fileUrl, Videoio.CAP_FFMPEG);
//錯誤輸出如下內容：
com.zinyan.demo E/cv::error(): OpenCV(4.6.0) Error: Requested object was not found (could not open directory: /data/app/com.zinyan.demo-Wr3nLeu2TTtG12e53ogTGw==/base.apk!/lib/arm64-v8a) in glob_rec, file /build/master_pack-android/opencv/modules/core/src/glob.cpp, line 267
應該是默認的OpenCV Android SDK中。并沒有FFmpeg相關庫。
所以想通過https或者rtsp等協議加載在線視頻也失敗。原因在于openCV 預編譯的Android SDK中，并沒有那么多第三方項目。可能是需要我們自己配置吧。
PS：自己配置編譯，有點繁瑣。我也沒有進行過嘗試。
當我們加載成功視頻之后。就可以進行解析操作了。
2.2 解析 read(),grab()和retrieve()方法
這三個方法主要就是用來獲取視頻的每一幀的數據，并將幀數據轉為Mat對象。
請注意哦，它們獲取的Mat對象是BGR格式的。
例如：獲取當前幀：
Mat m = new Mat();
videoCapture.read(m);
//我們就能夠得到當前幀了。
//官方建議我們不要直接操作獲取的Mat對象。我們可以進行拷貝之后再對Mat進行操作
Mat temp =m.clone()
除此之外，還有以下方法也可以獲取當前幀：
boolean isFrame =videoCapture.grab(); //從視頻文件或捕獲設備中抓取下一幀。抓取成功為true，否則為false
Mat tt =new Mat();
boolean isRetrieve =videoCapture.retrieve(tt); //解碼并返回抓取的視頻幀。如果沒有幀返回false。
其實read()? 是grab()+retrieve()方法的合集。
grab()方法只是檢測視頻幀，不會解析視頻幀。所以它速度比較快。
retrieve()?方法會進行視頻幀的解析。會比grab()方法更耗時。這兩個方法通常都是一起使用的。
但是，大部分情況下都是使用read()+循環，遍歷整個視頻的所有幀，并進行處理。
while (videoCapture.read(mat)) {
Mat m = new Mat();
Imgproc.cvtColor(mat, m, Imgproc.COLOR_BGR2HSV_FULL);
}read():方法返回的false時，代表視頻已經沒有下一幀了。也就是解析到最后一幀了。
通過循環的方式，可以快速的解析視頻中的每一幀數據，并轉為Mat進行處理。
注意，VideoCapture 在調用 read()? 獲取視頻幀之后。一直獲取到最后之后。不會回到第一幀獲取。我們只能重新調用open()方法再次加載才行。
2.3 修改 set()和get()方法
我們除了可以遍歷視頻幀數據以外。還可以通過get()方法獲取視頻的相關信息。
示例如下：
double ftp = videoCapture.get(Videoio.CAP_PROP_FPS);
double width = videoCapture.get(Videoio.CAP_PROP_FRAME_WIDTH);
double count = videoCapture.get(Videoio.CAP_PROP_FRAME_COUNT);
double htight = videoCapture.get(Videoio.CAP_PROP_FRAME_HEIGHT);
這個方法要傳入的是 propId 值，該值的取值參數有如下：
Videoio.CAP_PROP_POS_MSEC = 0,
Videoio.CAP_PROP_POS_FRAMES = 1,
Videoio.CAP_PROP_POS_AVI_RATIO = 2,
Videoio.CAP_PROP_FRAME_WIDTH = 3,
Videoio.CAP_PROP_FRAME_HEIGHT = 4,
Videoio.CAP_PROP_FPS = 5,
Videoio.CAP_PROP_FOURCC = 6,
Videoio.CAP_PROP_FRAME_COUNT = 7,
Videoio.CAP_PROP_FORMAT = 8,
Videoio.CAP_PROP_MODE = 9,
Videoio.CAP_PROP_BRIGHTNESS = 10,
Videoio.CAP_PROP_CONTRAST = 11,
Videoio.CAP_PROP_SATURATION = 12,
Videoio.CAP_PROP_HUE = 13,
Videoio.CAP_PROP_GAIN = 14,
Videoio.CAP_PROP_EXPOSURE = 15,
Videoio.CAP_PROP_CONVERT_RGB = 16,
Videoio.CAP_PROP_WHITE_BALANCE_BLUE_U = 17,
Videoio.CAP_PROP_RECTIFICATION = 18,
Videoio.CAP_PROP_MONOCHROME = 19,
Videoio.CAP_PROP_SHARPNESS = 20,
Videoio.CAP_PROP_AUTO_EXPOSURE = 21,
Videoio.CAP_PROP_GAMMA = 22,
Videoio.CAP_PROP_TEMPERATURE = 23,
Videoio.CAP_PROP_TRIGGER = 24,
Videoio.CAP_PROP_TRIGGER_DELAY = 25,
Videoio.CAP_PROP_WHITE_BALANCE_RED_V = 26,
Videoio.CAP_PROP_ZOOM = 27,
Videoio.CAP_PROP_FOCUS = 28,
Videoio.CAP_PROP_GUID = 29,
Videoio.CAP_PROP_ISO_SPEED = 30,
Videoio.CAP_PROP_BACKLIGHT = 32,
Videoio.CAP_PROP_PAN = 33,
Videoio.CAP_PROP_TILT = 34,
Videoio.CAP_PROP_ROLL = 35,
Videoio.CAP_PROP_IRIS = 36,
Videoio.CAP_PROP_SETTINGS = 37,
Videoio.CAP_PROP_BUFFERSIZE = 38,
Videoio.CAP_PROP_AUTOFOCUS = 39,
Videoio.CAP_PROP_SAR_NUM = 40,
Videoio.CAP_PROP_SAR_DEN = 41,
Videoio.CAP_PROP_BACKEND = 42,
Videoio.CAP_PROP_CHANNEL = 43,
Videoio.CAP_PROP_AUTO_WB = 44,
Videoio.CAP_PROP_WB_TEMPERATURE = 45,
Videoio.CAP_PROP_CODEC_PIXEL_FORMAT = 46,
Videoio.CAP_PROP_BITRATE = 47;
但是，我們很多時候使用上面的關鍵字進行獲取的數據，結果值都是0
這是因為 openCV 使用的解析器在獲取視頻時，如果正確獲取了相關配置項參數就會返回具體指。如果沒有正確獲取就會返回0了。
在我的實際使用過程中，大部分都是取不到真實數據。而寬高等數據，還得讀取過一幀數據之后，才能取到值。
videoCapture.set(int propId, double value)
而set()方法，就是將這些配置信息修改到 VideoCapture 中。
如果在open()方法中調用的解碼器支持的話。就可以將這些配置信息添加到解碼器中。進行生效了。
我們如果只是單純調用 openCV 的 API。那么set()方法使用空間不大了。
2.4 關閉 release()
當我們遍歷完畢，可以調用release()方法 關閉文件的加載。釋放內存。
同時底層C++代碼中的相關方法也會進行釋放。
3. 小結
總的來說，我們可以使用VideoCapture進行視頻幀的遍歷，并在遍歷過程中對每一幀數據進行編輯修改操作。
我們如果想使用 openCV 對視頻每一幀進行操作之后，再存儲為視頻。那么就還需要結合VideoWriter 進行存儲。
默認情況下Android下，是可以實現視頻的每一幀獲取，并修改然后存儲為新的視頻文件的。
通過這些方法可以實現，例如視頻添加水印，背景替換，黑白轉換等等。圖片能實現的一些編輯操作都可以通過獲取每一幀，處理完畢后。再將每一幀存儲為視頻來實現。
openCV 官網說明文檔：
https://docs.opencv.org/4.6.0/d4/d15/groupvideoioflags__base.html#ga023786be1ee68a9105bf2e48c700294d
下一篇簡單介紹下VideoWriter的相關使用吧。
