[源碼探究]ThumbnailUtils.createVideoThumbnail 獲取到的幀不是視頻第一個關鍵幀

最近項目中遇到一個獲取視頻首幀圖片的問題。
網上通常給出的答案是用ThumbnailUtils.createVideoThumbnail(String filePath, int kind) 獲取視頻首幀。
我也是這麼作的，但後來遇到一個ThumbnailUtils.createVideoThumbnail獲取的視頻幀並不是視頻首幀的bug。
通過對ThumbnailUtils.createVideoThumbnail方法的瞭解，得出如下結論。

結論：

ThumbnailUtils.createVideoThumbnail(String filePath, int kind) 與 MediaMetadataRetriever.getFrameAtTime(-1, MediaMetadataRetriever.OPTION_CLOSEST_SYNC) 獲取到的爲視頻的最大關鍵幀；
MediaMetadataRetriever.getFrameAtTime(0, MediaMetadataRetriever.OPTION_CLOSEST_SYNC) 獲取的爲視頻第一個關鍵幀。

舉例說明：

視頻第一個關鍵幀

001.png

視頻最大關鍵幀

002.png

獲取「最大關鍵幀」和「第一個關鍵幀」

// 獲取最大關鍵幀
Bitmap bmp = ThumbnailUtils.createVideoThumbnail("/sdcard/0001.mp4", MediaStore.Images.Thumbnails.MINI_KIND);
mTextView01.setBackground(new BitmapDrawable(bmp));

// 獲取第一個關鍵幀
MediaMetadataRetriever retriever = new MediaMetadataRetriever();
retriever.setDataSource("/sdcard/0001.mp4");
Bitmap bmp = retriever.getFrameAtTime(0, MediaMetadataRetriever.OPTION_CLOSEST_SYNC);
mTextView02.setBackground(new BitmapDrawable(bmp));
複製代碼

案例運行效果圖

003.png

瞭解ThumbnailUtils.createVideoThumbnail(String filePath, int kind)方法實現

android.media.ThumbnailUtils

public static Bitmap createVideoThumbnail(String filePath, int kind) {
    Bitmap bitmap = null;
    MediaMetadataRetriever retriever = new MediaMetadataRetriever();
    try {
        retriever.setDataSource(filePath);
        bitmap = retriever.getFrameAtTime(-1);
    } catch (IllegalArgumentException ex) {
        // Assume this is a corrupt video file
    } catch (RuntimeException ex) {
        // Assume this is a corrupt video file.
    } finally {
        try {
            retriever.release();
        } catch (RuntimeException ex) {
            // Ignore failures while cleaning up.
        }
    }
    ...
    return bitmap;
}
複製代碼

從以上代碼能夠看出createVideoThumbnail調用的是MediaMetadataRetriever.getFrameAtTime(-1)獲取視頻關鍵幀

android.media.MediaMetadataRetriever

public Bitmap getFrameAtTime(long timeUs) {
    return getFrameAtTime(timeUs, OPTION_CLOSEST_SYNC);
}
複製代碼

• OPTION_CLOSEST 在給定的時間，檢索最近一個幀，這個幀不必定是關鍵幀。
• OPTION_CLOSEST_SYNC 在給定的時間，檢索最近一個關鍵幀。
• OPTION_NEXT_SYNC 在給定時間以後，檢索一個關鍵幀。
• OPTION_PREVIOUS_SYNC 在給定時間以前，檢索一個關鍵幀。

android.media.MediaMetadataRetriever

public Bitmap getFrameAtTime(long timeUs, int option) {
    if (option < OPTION_PREVIOUS_SYNC ||
        option > OPTION_CLOSEST) {
        throw new IllegalArgumentException("Unsupported option: " + option);
    }
    return _getFrameAtTime(timeUs, option);
}
複製代碼

_getFrameAtTime爲Native方法

int64_t thumbNailTime;  
if (frameTimeUs < 0) { ／／若是傳入的時間爲負數  
    if (!trackMeta->findInt64(kKeyThumbnailTime, &thumbNailTime)|| thumbNailTime < 0) { ／／查看kKeyThumbnailTime是否存在  
        thumbNailTime = 0; ／／如不存在取第0幀  
    }  
    options.setSeekTo(thumbNailTime, mode);  
} else {  
    thumbNailTime = -1;  
    options.setSeekTo(frameTimeUs, mode);  
}  
複製代碼

frameTimeUs爲咱們傳入的時間參數；
thumbNailTime爲最大關鍵幀的時間參數；

代碼下載：
https://github.com/AndroidAppCodeDemo/Android_ThumbnailUtilsCreateVideoThumbnail_Demo

參考：http://blog.csdn.net/cloudwu007/article/details/18959567http://www.codeweblog.com/camera%E5%BD%95%E5%88%B6%E8%A7%86%E9%A2%91%E7%9A%84%E7%BC%A9%E7%95%A5%E5%9B%BE%E8%8E%B7%E5%8F%96%E5%8E%9F%E7%90%86%E5%BF%83%E5%BE%97%E5%88%86%E4%BA%AB/