Android中获取视频的缩略图

前言:
在项目中,通常我们有获取视频的缩略图来显示的需求。这里所说的视频的缩略图,一般是视频的第一帧画面,当然也可能我们需要获取视频中指定位置的一帧画面。

我们通过MediaMetadataRetriever来获取视频的缩略图。

关于MediaMetadataRetriever:
在API Level 10添加的;
位于android.media包下;
官方定义:MediaMetadataRetriever class provides a unified interface for retrieving frame and meta data from an input media file.(MediaMetadataRetriever 类提供一个统一的接口,用于从输入媒体文件中检索帧和元数据。)

下面我们来看MediaMetadataRetriever 的构造方法、常量、公共方法:
一、构造方法:
MediaMetadataRetriever 只有一个构造方法,即MediaMetadataRetriever()。
我们得到一个MediaMetadataRetriever的实例,代码如下:

MediaMetadataRetriever mediaMetadataRetriever = new MediaMetadataRetriever();

二、常量,我们这里挑选四个常量进行讲解。(更多内容可以在此处https://developer.android.com/reference/android/media/MediaMetadataRetriever进行查看)
1、OPTION_CLOSEST
官方定义:This option is used with getFrameAtTime(long, int) to retrieve a frame (not necessarily a key frame) associated with a data source that is located closest to or at the given time.
简单来说就是,在给定的时间,检索最近的一帧,这个帧不一定是关键帧。我们将其作为参数传入getFrameAtTime方法的第二个参数位置。
在源码中的定义如下:

public static final int OPTION_CLOSEST          = 0x03;

2、OPTION_CLOSEST_SYNC
官方定义:This option is used with getFrameAtTime(long, int) to retrieve a sync (or key) frame associated with a data source that is located closest to (in time) or at the given time.
简单来说就是,在给定的时间,检索最近一个同步与数据源相关联的帧(关键帧)。我们将其作为参数传入getFrameAtTime方法的第二个参数位置。
在源码中的定义如下:

public static final int OPTION_CLOSEST_SYNC     = 0x02;

3、OPTION_NEXT_SYNC
官方定义:This option is used with getFrameAtTime(long, int) to retrieve a sync (or key) frame associated with a data source that is located right after or at the given time.
简单来说就是,在给定的时间之后,检索最近一个同步与数据源相关联的帧(关键帧)。我们将其作为参数传入getFrameAtTime方法的第二个参数位置。
在源码中的定义如下:

public static final int OPTION_NEXT_SYNC        = 0x01;

4、OPTION_PREVIOUS_SYNC
官方定义:This option is used with getFrameAtTime(long, int) to retrieve a sync (or key) frame associated with a data source that is located right before or at the given time.
简单来说就是,在给定的时间之前,检索最近一个同步与数据源相关联的帧(关键帧)。我们将其作为参数传入getFrameAtTime方法的第二个参数位置。
在源码中的定义如下:

public static final int OPTION_PREVIOUS_SYNC    = 0x00;

三、公共方法,我们挑选四个方法进行讲解。(更多内容可以在此处https://developer.android.com/reference/android/media/MediaMetadataRetriever进行查看)
1、public void setDataSource (String path)
官方定义:Sets the data source (file pathname) to use. Call this method before the rest of the methods in this class. This method may be time-consuming.
理解:这个方法必须在其他方法之前调用;这个方法可能是耗时的;这个方法用于设置本地视频的路径。
总结:如果是要获取本地视频的缩略图,我们可以使用这个方法设置本地视频的路径,并且该方法的调用需要在其他方法(比如getFrameAtTime(long, int)方法)之前,另外,该方法的调用不应该放在UI线程中。

2、public void setDataSource(String uri, Map<String, String> headers)
官方定义:Sets the data source (URI) to use. Call this method before the rest of the methods in this class. This method may be time-consuming.
理解:这个方法必须在其他方法之前调用;这个方法可能是耗时的;这个方法可以用于设置网络视频的路径。
总结:如果是要获取网络视频的缩略图,我们可以使用这个方法设置网络视频的路径,并且该方法的调用需要在其他方法(比如getFrameAtTime(long, int)方法)之前,另外,该方法的调用不应该放在UI线程中。

3、public Bitmap getFrameAtTime ()
官方定义:Call this method after setDataSource(). This method finds a representative frame at any time position if possible, and returns it as a bitmap. Call this method if one does not care about where the frame is located; otherwise, please call getFrameAtTime(long) or getFrameAtTime(long, int)
理解:如果我们只是要获取任何时间位置的一帧,那么我们可以调用这个方法。
总结:当我们对帧的时间位置没有要求的时候,我们可以调用这个方法,得到表示该帧的Bitmap对象。

4、public Bitmap getFrameAtTime (long timeUs, int option)
官方定义:Call this method after setDataSource(). This method finds a representative frame close to the given time position by considering the given option if possible, and returns it as a bitmap.
理解:根据指定时间位置以及选项设置(比如OPTION_CLOSEST_SYNC)得到一帧的Bitmap表示。
总结:当我们需要得到指定时间位置的一帧画面时,我们可以使用该方法,得到表示该帧的Bitmap对象。

下面我们来看一个例子:
获取网络视频的第一帧画面

                final MediaMetadataRetriever mediaMetadataRetriever = new MediaMetadataRetriever();
                new Thread() {
                    @Override
                    public void run() {
                        mediaMetadataRetriever.setDataSource(resourceUrls[0], new HashMap());
                        runOnUiThread(new Runnable() {
                            @Override
                            public void run() {
                                iv_video_thumbnail.setImageBitmap(mediaMetadataRetriever.getFrameAtTime(0, OPTION_CLOSEST_SYNC));
                            }
                        });
                    }
                }.start();

注意:setDataSource方法必须放在工作线程中,不能放在UI线程中。任何可能耗时的操作必须不能放在UI线程中。

猜你喜欢

转载自blog.csdn.net/zdj_Develop/article/details/87946134