Vitamio中文API文档（1）

> Vitamio的日记

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

2012-09-04 15:38:02

        本章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 DI RECTORY
媒体上级文件夹名称。
        常量值：_di rectory
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 DI RECTORY
媒体上级文件夹名称。
        常量值：_di rectory
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_DI RECTORY
图片存放目录。
        常量值： 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
                        kind 类别
                        options BitmapFactory.Options
                返回值
                        视频缩略图。