Vitamio中文API文档（1）—— MediaStore

前言

Vitamio新版SDK发布在即，文档一直欠缺，接下来的一段时间将陆续补上，后续还会推出开发者指南等系列文章，官网也在改版，帮助开发者更好的使用Vitamio。本章MediaStore主要用于读取本地视频、音频信息、缩略图用，请参加Vitamio万能播放器系列文章第10篇，这里。

声明

欢迎转载，但请保留文章原始出处:) 

Vitamio：http://www.vitamio.org

农民伯伯： http://www.cnblogs.com/over140/

正文

MediaStore

整理：农民伯伯

类概述

public final class MediaStore

媒体存储辅助类。

常量

public static final String AUTHORITY

常量值：me.abitno.vplayer.mediaprovider

public static final Uri CONTENT_URI

常量值：content://me.abitno.vplayer.mediaprovider/

public static final String MEDIA_SCANNER_VOLUME

常量值：volume

公共方法

public static Uri getMediaScannerUri ()

     获取扫描视频的Uri。

public static Uri getVolumeUri ()

获取正在扫描的SD卡的Uri。

MediaStore.MediaColumns

整理：农民伯伯

类概述

public interface MediaColumns extends BaseColumns

媒体（视频、音频）字段

常量

public static final String DATA

媒体路径。

常量值：_data

public static final String DIRECTORY

媒体上级文件夹名称。

常量值：_directory

public static final String SIZE

媒体文件大小，单位字节。

常量值：_size

public static final String DISPLAY_NAME

媒体文件名称。例如：“Moon1.mp4”

常量值：_display_name

public static final String TITLE

媒体标题。

常量值：title

public static final String TITLE_KEY

媒体标题拼音。

常量值：title_key

public static final String DATE_ADDED

媒体添加时间

常量值：date_added

public static final String DATE_MODIFIED

媒体修改时间

常量值：date_modified

public static final String MIME_TYPE

媒体MIME类型。例如：“video/mp4”

常量值：mime_type

MediaStore.Audio.Media

整理：农民伯伯

类概述

音频相关字段信息。（注意：Audio有两个子类AudioColumns和Media，后者继承前者，这里合并文档）

常量

public static final String CONTENT_URI

常量值： content://me.abitno.vplayer.mediaprovider/audios/media

public static final String CONTENT_TYPE

常量值： vnd.android.cursor.dir/audio

public static final String DURATION

音频时长。

常量值： duration

public static final String ARTIST

音频艺术家。

常量值： artist

public static final String COMPOSER

音频作曲。

常量值： composer

public static final String ALBUM

音频专辑。

常量值： album

public static final String TRACK

音频音轨。

常量值： track

public static final String YEAR

发行时间（一般是CD、音乐）

常量值： year

MediaStore.MediaColumns

整理：农民伯伯

类概述

public interface MediaColumns extends BaseColumns

媒体（视频、音频）字段

常量

public static final String DATA

媒体路径。

常量值：_data

public static final String DIRECTORY

媒体上级文件夹名称。

常量值：_directory

public static final String SIZE

媒体文件大小，单位字节。

常量值：_size

public static final String DISPLAY_NAME

媒体文件名称。例如：“Moon1.mp4”

常量值：_display_name

public static final String TITLE

媒体标题。

常量值：title

public static final String TITLE_KEY

媒体标题拼音。

常量值：title_key

public static final String DATE_ADDED

媒体添加时间

常量值：date_added

public static final String DATE_MODIFIED

媒体修改时间

常量值：date_modified

public static final String MIME_TYPE

媒体MIME类型。例如：“video/mp4”

常量值：mime_type

MediaStore.Video.Media

整理：农民伯伯

类概述

public interface VideoColumns extends MediaColumns

public static final class Media implements VideoColumns

视频相关字段信息。

常量

public static final String CONTENT_URI

常量值： content://me.abitno.vplayer.mediaprovider/videos/media

public static final String CONTENT_TYPE

常量值： vnd.android.cursor.dir/video

public static final String DURATION

视频时长。

常量值： duration

public static final String ARTIST

视频艺术家。

常量值： artist

public static final String ALBUM

音频专辑。

常量值： album

public static final String WIDTH

视频画面宽度。

常量值： width

public static final String HEIGHT

视频画面高度。

常量值： height

public static final String DESCRIPTION

视频备注。

常量值： description

public static final String LANGUAGE

视频语言。

常量值： language

public static final String LATITUDE

视频位置信息纬度

常量值： latitude

public static final String LONGITUDE

视频位置信息经度

常量值： longitude

public static final String DATE_TAKEN

视频拍摄的时间

常量值： datetaken

public static final String BOOKMARK

视频标签。

常量值： bookmark

public static final String MINI_THUMB_MAGIC

视频缩略图文件位置。（多缩略图存在一个文件中，该字段标记在文件中的位置）

常量值： mini_thumb_magic

public static final String HIDDEN

视频是否隐藏。0显示1隐藏。

常量值： hidden

public static final String SUBTRACK

视频字幕。

常量值： sub_track

public static final String AUDIO_TRACK

视频音轨。

常量值： audio_track

MediaStore.Thumbnails

整理：农民伯伯

类概述

public static class Thumbnails implements BaseColumns

视频缩略图辅助类。

常量

public static final String CONTENT_URI

常量值： content://me.abitno.vplayer.mediaprovider/videos/thumbnails

public static final String THUMBNAILS_DIRECTORY

图片存放目录。

常量值： Android/data/com.yixia.vplayer/thumbnails

public static final String DATA

图片存放路径。

常量值： _data

public static final String VIDEO_ID

视频ID。

常量值： video_id

public static final String KIND

图片类型。

常量值： kind

public static final String WIDTH

图片宽度。

常量值： width

public static final String HEIGHT

图片高度。

常量值： height

public static final int MINI_KIND

视频缩略图。（尺寸：426 x 320）

常量值： 1

public static final int MICRO_KIND

视频更小缩略图。（尺寸：106 x 80）

常量值： 3

公共方法

public static void cancelThumbnailRequest(ContentResolver cr, long origId)

取消正在处理的视频截图。

public static void cancelThumbnailRequest(ContentResolver cr, long origId, long groupId)

取消正在处理的视频截图。

public static Bitmap getThumbnail(Context ctx, ContentResolver cr, long origId, int kind, BitmapFactory.Options options)

获取视频缩略图。

参数

ctx Context

cr ContentResolver

origId 视频ID

kind 类别

options BitmapFactory.Options

返回值

视频缩略图。

public static Bitmap getThumbnail(Context ctx, ContentResolver cr, long origId, long groupId, int kind, BitmapFactory.Options options)

获取视频缩略图。

参数

ctx Context

cr ContentResolver

origId 视频ID

groupId 视频ID 

kind 类别

options BitmapFactory.Options

返回值

视频缩略图。