media.helper

类 MediaStoreHelper

java.lang.Object

media.helper.MediaStoreHelper

public final class MediaStoreHelper
extends java.lang.Object

用于帮助扫描本地的音频、视频和图片媒体。

注意！扫描本地媒体文件必须申请存储器访问权限："android.permission.READ_EXTERNAL_STORAGE"。

使用以下静态方法来扫描对应的媒体库：

• scanAudio(ContentResolver, Decoder)：扫描音频文件
• scanVideo(ContentResolver, Decoder)：扫描视频文件
• scanImages(ContentResolver, Decoder)：扫描图片文件

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	MediaStoreHelper.BaseScanner<T> 扫描器基类，该类实现了扫描器的基本功能。
static class	MediaStoreHelper.Decoder<T> 解码器，用于将 Cursor 中扫描到的媒体文件转换成对应的实体对象。
static interface	MediaStoreHelper.OnScanCallback<T> 扫描器回调接口。
static interface	MediaStoreHelper.Scanner<T> 扫描器。

方法概要

限定符和类型	方法和说明
static <T> MediaStoreHelper.Scanner<T>	scanAudio(android.content.ContentResolver resolver, MediaStoreHelper.Decoder<T> decoder) 扫描本地的音频文件。
static <T> MediaStoreHelper.Scanner<T>	scanImages(android.content.ContentResolver resolver, MediaStoreHelper.Decoder<T> decoder) 扫描本地的图片文件。
static <T> MediaStoreHelper.Scanner<T>	scanVideo(android.content.ContentResolver resolver, MediaStoreHelper.Decoder<T> decoder) 扫描本地的视频文件。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

scanAudio

public static <T> MediaStoreHelper.Scanner<T> scanAudio(@NonNull
                                                        android.content.ContentResolver resolver,
                                                        @NonNull
                                                        MediaStoreHelper.Decoder<T> decoder)

扫描本地的音频文件。

类型参数:

T - 媒体文件对应的实体类型

参数:

resolver - ContentResolver 对象，不能为 null

decoder - MediaStoreHelper.Decoder 对象，不能为 null

返回:

MediaStoreHelper.Scanner 对象，调用该对象的 scan() 方法即可开始扫描本地媒体文件

scanVideo

public static <T> MediaStoreHelper.Scanner<T> scanVideo(@NonNull
                                                        android.content.ContentResolver resolver,
                                                        @NonNull
                                                        MediaStoreHelper.Decoder<T> decoder)

扫描本地的视频文件。

类型参数:

T - 媒体文件对应的实体类型

参数:

resolver - ContentResolver 对象，不能为 null

decoder - MediaStoreHelper.Decoder 对象，不能为 null

返回:

MediaStoreHelper.Scanner 对象，调用该对象的 scan() 方法即可开始扫描本地媒体文件

scanImages

public static <T> MediaStoreHelper.Scanner<T> scanImages(@NonNull
                                                         android.content.ContentResolver resolver,
                                                         @NonNull
                                                         MediaStoreHelper.Decoder<T> decoder)

扫描本地的图片文件。

类型参数:

T - 媒体文件对应的实体类型

参数:

resolver - ContentResolver 对象，不能为 null

decoder - MediaStoreHelper.Decoder 对象，不能为 null

返回:

MediaStoreHelper.Scanner 对象，调用该对象的 scan() 方法即可开始扫描本地媒体文件