public final class MediaStore
extends Object
| java.lang.Object | |
| ↳ | android.provider.MediaStore |
媒体提供商包含内部和外部存储设备上所有可用媒体的元数据。
Nested classes |
|
|---|---|
class |
MediaStore.Audio 所有音频内容的容器。 |
class |
MediaStore.Files 媒体提供商表格，其中包含媒体存储器中所有文件的索引，包括非媒体文件。 |
class |
MediaStore.Images 包含所有可用图像的元数据。 |
interface |
MediaStore.MediaColumns 大多数MediaProvider表的通用字段 |
class |
MediaStore.Video
|
Public constructors |
|
|---|---|
MediaStore() |
|
Public methods |
|
|---|---|
static Uri |
getMediaScannerUri() Uri查询媒体扫描器的状态。 |
static String |
getVersion(Context context) 获取媒体提供商的版本。 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
String ACTION_IMAGE_CAPTURE
标准意图动作，可以发送给相机应用程序捕捉图像并将其返回。
调用者可以传递额外的EXTRA_OUTPUT来控制这个图像将被写入的位置。 如果EXTRA_OUTPUT不存在，则在额外字段中将小图像作为位图对象返回。 这对于只需要小图像的应用程序很有用。 如果EXTRA_OUTPUT存在，则全尺寸图像将被写入EXTRA_OUTPUT的Uri值。 从LOLLIPOP ，此uri也可以通过setClipData(ClipData)提供。 如果使用这种方法，您仍然必须通过EXTRA_OUTPUT字段提供uri，以便与旧应用程序兼容。 如果您未设置ClipData，则在拨打startActivity(Intent)时会将其复制到您的startActivity(Intent) 。
注意：如果您的应用目标 M及以上，并声明使用未授予的 CAMERA权限，则尝试使用此操作将导致 SecurityException 。
也可以看看：
常量值：“android.media.action.IMAGE_CAPTURE”
String ACTION_IMAGE_CAPTURE_SECURE
可以发送的意图动作使摄像机应用程序捕获图像并在设备受到保护时返回（例如使用PIN，密码，图案或面部解锁）。 响应此意图的应用程序不得暴露设备上现有照片或视频等任何个人内容。 应用程序应该小心，不要与其他应用程序或互联网共享任何照片或视频。 该活动应使用FLAG_SHOW_WHEN_LOCKED在锁定屏幕的顶部显示，并保证安全。 使用此标志时没有活动堆栈，因此强烈建议启动多个活动。
调用者可以传递额外的EXTRA_OUTPUT来控制这个图像将被写入的位置。 如果EXTRA_OUTPUT不存在，则在额外字段中将小图像作为位图对象返回。 这对于只需要小图像的应用程序很有用。 如果EXTRA_OUTPUT存在，则全尺寸图像将被写入EXTRA_OUTPUT的Uri值。 从LOLLIPOP ，此uri也可以通过setClipData(ClipData)提供。 如果使用这种方法，您仍然必须通过EXTRA_OUTPUT字段提供uri，以便与旧应用程序兼容。 如果您没有设置ClipData，则在拨打startActivity(Intent)时会将其复制到您的startActivity(Intent) 。
也可以看看：
常量值：“android.media.action.IMAGE_CAPTURE_SECURE”
String ACTION_VIDEO_CAPTURE
可以发送标准意图操作以让相机应用程序捕捉视频并将其返回。
来电者可以传递额外的EXTRA_VIDEO_QUALITY来控制视频质量。
调用者可以传入额外的EXTRA_OUTPUT来控制视频的写入位置。 如果EXTRA_OUTPUT不存在，则视频将被写入视频的标准位置，并且该位置的Uri将在Uri的数据字段中返回。 从LOLLIPOP ，此uri也可以通过setClipData(ClipData)提供。 如果使用这种方法，您仍然必须通过EXTRA_OUTPUT字段提供uri，以便与旧应用程序兼容。 如果您未设置ClipData，则在拨打startActivity(Intent)时会将其复制到您的startActivity(Intent) 。
注意：如果您的应用目标 M及以上，并声明使用未授予的 CAMERA权限，则试图使用此操作将导致 SecurityException 。
常量值：“android.media.action.VIDEO_CAPTURE”
String EXTRA_DURATION_LIMIT
指定允许的最长录制时间，以秒为单位。
常量值：“android.intent.extra.durationLimit”
String EXTRA_FINISH_ON_COMPLETION
Intent-extra的名称，用于控制MovieView的onCompletion行为。 这是一个布尔属性，用于指定在影片完成播放时是否完成MovieView活动。 默认值为true，这意味着在电影完成播放时自动退出电影播放器活动。
常量值：“android.intent.extra.finishOnCompletion”
String EXTRA_FULL_SCREEN
用于控制ViewImage的UI的Intent-extra的名称。 这是覆盖活动的默认全屏状态的布尔属性。
常量值：“android.intent.extra.fullScreen”
String EXTRA_MEDIA_ALBUM
用于定义专辑的Intent-extra的名称
常量值：“android.intent.extra.album”
String EXTRA_MEDIA_ARTIST
用于定义艺术家的Intent-extra的名称
常量值：“android.intent.extra.artist”
String EXTRA_MEDIA_FOCUS
用于定义搜索焦点的Intent-extra的名称。 搜索焦点指示搜索是否应该用于与其他演员识别的艺术家，专辑或歌曲相关的内容。
常量值：“android.intent.extra.focus”
String EXTRA_MEDIA_GENRE
用于定义流派的Intent-extra的名称。
常量值：“android.intent.extra.genre”
String EXTRA_MEDIA_PLAYLIST
用于定义播放列表的Intent-extra的名称。
常量值：“android.intent.extra.playlist”
String EXTRA_MEDIA_RADIO_CHANNEL
用于定义无线电频道的Intent-extra的名称。
常量值：“android.intent.extra.radio_channel”
String EXTRA_MEDIA_TITLE
用于定义歌曲标题的Intent-extra的名称
常量值：“android.intent.extra.title”
String EXTRA_OUTPUT
用于指示内容解析器Uri用于存储请求的图像或视频的Intent-extra的名称。
常量值：“输出”
String EXTRA_SCREEN_ORIENTATION
用于控制ViewImage或MovieView方向的Intent-extra的名称。 这是一个覆盖活动的requestedOrientation的int属性。
常量值：“android.intent.extra.screenOrientation”
String EXTRA_SHOW_ACTION_ICONS
用于控制ViewImage的UI的Intent-extra的名称。 这是一个布尔属性，指定是否显示动作图标。
常量值：“android.intent.extra.showActionIcons”
String EXTRA_SIZE_LIMIT
指定允许的最大尺寸。
常量值：“android.intent.extra.sizeLimit”
String EXTRA_VIDEO_QUALITY
用于控制录制视频质量的Intent-extra的名称。 这是一个整数属性。 当前值0表示低质量，适用于MMS消息，值1表示高质量。 未来可能会添加其他质量水平。
常量值：“android.intent.extra.videoQuality”
String INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH
意图执行音乐媒体搜索并在可能的情况下自动播放结果中的内容。 例如，这可以通过语音识别命令的结果来触发以听音乐。
此意图始终包括EXTRA_MEDIA_FOCUS和QUERY临时演员。 EXTRA_MEDIA_FOCUS额外值决定了搜索模式，而QUERY额外值取决于搜索模式。 有关此意图的搜索模式的更多信息，请参阅Common Intents中的Play music based on a search query 。
这种意图对于可以支持大规模音乐搜索的应用程序最为合理，如连接到可在设备上流式传输和播放的在线音乐数据库的服务。
常量值：“android.media.action.MEDIA_PLAY_FROM_SEARCH”
String INTENT_ACTION_MEDIA_SEARCH
活动操作：执行媒体搜索。 至少包含QUERY额外。 还可能包含以下额外内容的任意组合：EXTRA_MEDIA_ARTIST，EXTRA_MEDIA_ALBUM，EXTRA_MEDIA_TITLE，EXTRA_MEDIA_FOCUS
常量值：“android.intent.action.MEDIA_SEARCH”
String INTENT_ACTION_MUSIC_PLAYER
此常数在API级别15中已弃用。
改为使用CATEGORY_APP_MUSIC 。
活动行动：启动音乐播放器。 该活动应该能够播放，浏览或操作设备上存储的音乐文件。
常量值：“android.intent.action.MUSIC_PLAYER”
String INTENT_ACTION_STILL_IMAGE_CAMERA
用于在静态图像模式下启动相机的意图操作的名称。
常量值：“android.media.action.STILL_IMAGE_CAMERA”
String INTENT_ACTION_STILL_IMAGE_CAMERA_SECURE
Intent动作的名称，用于在静止图像模式下启动相机，以便在设备被固定时使用（例如，使用PIN，密码，图案或面部解锁）。 响应此意图的应用程序不得暴露设备上现有照片或视频等任何个人内容。 应用程序应该小心，不要与其他应用程序或互联网共享任何照片或视频。 该活动应使用FLAG_SHOW_WHEN_LOCKED在锁定屏幕的顶部显示，并保证安全。 使用此标志时没有活动堆栈，因此强烈建议启动多个活动。
常量值：“android.media.action.STILL_IMAGE_CAMERA_SECURE”
String INTENT_ACTION_TEXT_OPEN_FROM_SEARCH
意图执行可读媒体搜索并在可能的情况下自动播放结果中的内容。 例如，这可以通过语音识别命令的结果来读取书籍或杂志。
包含 QUERY额外字符，该字符串可以包含任何类型的非结构化文本搜索，例如书籍或杂志的名称，作者风格，发布者或这些的任意组合。
由于此意图包含开放式非结构化搜索字符串，因此对于可支持文本媒体大规模搜索的应用程序最为合理，如连接到可在图书馆和/或杂志上阅读的在线数据库的服务设备。
常量值：“android.media.action.TEXT_OPEN_FROM_SEARCH”
String INTENT_ACTION_VIDEO_CAMERA
用于在视频模式下启动摄像头的Intent操作的名称。
常量值：“android.media.action.VIDEO_CAMERA”
String INTENT_ACTION_VIDEO_PLAY_FROM_SEARCH
意图对视频媒体执行搜索，并在可能的情况下自动播放结果中的内容。 例如，这可以通过语音识别命令的结果来播放电影。
包含 QUERY额外字符，该字符串可以包含任何类型的非结构化视频搜索，如电影的名称，一个或多个演员，流派或这些的任意组合。
由于此意图包含开放式非结构化搜索字符串，因此对于支持大规模视频搜索的应用程序最为合理，例如将服务连接到可在设备上流式传输和播放的视频的在线数据库。
常量值：“android.media.action.VIDEO_PLAY_FROM_SEARCH”
String MEDIA_IGNORE_FILENAME
指示媒体扫描器忽略包含目录及其子目录中的媒体的文件的名称。 开发人员应该使用它来避免在图库中显示应用程序图形，并同样阻止应用程序声音和音乐出现在音乐应用程序中。
常量值：“.nomedia”
String META_DATA_STILL_IMAGE_CAMERA_PREWARM_SERVICE
名称，其下的活动处理 INTENT_ACTION_STILL_IMAGE_CAMERA或 INTENT_ACTION_STILL_IMAGE_CAMERA_SECURE发布其预热服务的服务名称。
这个元数据应该引用延伸 CameraPrewarmService的预热服务的全限定类名。
预热服务将受到约束并收到预热信号onPrewarm() ，此时相机发射意图可能即将起火。 实现预热服务的应用程序应该尽可能地减少初始化摄像机的工作量，以便在发送摄像机发射意图后立即减少启动时间。
常量值：“android.media.still_image_camera_preview_service”
String UNKNOWN_STRING
媒体属性未知时使用的字符串。 例如，如果音频文件没有任何元数据，艺术家和专辑列将被设置为该值。
常数值：“
String getVersion (Context context)
获取媒体提供商的版本。 将数据从媒体提供商导入到自己的缓存中的应用程序可以使用它来检测媒体提供商是否已更改，并根据需要重新导入数据。 没有其他假设应该对版本的含义作出。
| Parameters | |
|---|---|
context |
Context: Context to use for performing the query. |
| Returns | |
|---|---|
String |
A version string, or null if the version could not be determined. |
Android开发手册