MediaStore 類別

定義

命名空間:: Android.Provider

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

媒體供應商與應用程式之間的合約。

[Android.Runtime.Register("android/provider/MediaStore", DoNotGenerateAcw=true)]
public sealed class MediaStore : Java.Lang.Object

[<Android.Runtime.Register("android/provider/MediaStore", DoNotGenerateAcw=true)>]
type MediaStore = class
    inherit Object

繼承: Object

JavaObject

Object
MediaStore

屬性: RegisterAttribute

備註

媒體供應商與應用程式之間的合約。包含支援的 URI 與欄位定義。

媒體提供者提供一個索引的常見媒體類型集合，例如Audio、、 VideoImages和，來自任何連接的儲存裝置。每個集合依據底層內容的主要 MIME 類型進行組織;例如， image/* 內容被索引為 Images。該 Files 收藏提供涵蓋所有收藏的廣泛視圖，且不依 MIME 類型進行篩選。

Java 文件 android.provider.MediaStore。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
MediaStore()

欄位

名稱	Description
AccessMediaOwnerPackageNamePermission	授權權限可 `MediaColumns#OWNER_PACKAGE_NAME` 存取所有可存取的媒體檔案。
AccessOemMetadataPermission	授權權限可 `MediaColumns#OEM_METADATA` 存取所有可存取的媒體檔案。
ActionImageCapture	標準意圖動作，可以傳送讓相機應用程式捕捉影像並回傳。
ActionImageCaptureSecure	意圖動作，可以傳送讓相機應用程式捕捉影像，並在裝置安全後回傳（例如：
ActionMotionPhotoCapture	標準的意圖動作，可以傳送讓相機應用程式捕捉動態照片並回傳。
ActionMotionPhotoCaptureSecure	意圖動作可以傳送，讓相機應用程式捕捉動態照片，並在裝置安全後回傳（例如：
ActionPickImages	活動動作：允許使用者選擇系統提供的圖片或影片並返回。
ActionPickImagesSettings	活動動作：啟動設定，控制圖片或影片的選擇。`#ACTION_PICK_IMAGES`
ActionReview	標準操作是用來審查給定媒體檔案的。
ActionReviewSecure	標準動作，當裝置安全時，可以傳送以審查給定媒體檔案（例如：
ActionVideoCapture	標準意圖動作，可以傳送讓攝影機應用程式擷取影片並回傳。
Authority	媒體提供者的權威
ExtraAcceptOriginalMediaFormat	/** 指定呼叫者希望接收原始媒體格式但不轉碼。
ExtraBrightness	定義後，啟動應用程式會被要求設定指定的亮度值`android.view.WindowManager.LayoutParams#screenBrightness`，以確保啟動`#ACTION_REVIEW#ACTION_REVIEW_SECURE`或意圖時的順暢過渡。
ExtraDurationLimit	請指定允許的最大錄影時長（秒數）。
ExtraFinishOnCompletion	Intent-extra 的名稱是用來控制 MovieView onCompletion 行為的名稱。
ExtraFullScreen	一個用於控制 ViewImage 使用者介面的 Intent-extra 名稱。
ExtraMediaAlbum	專輯名稱即為 Intent-extra 所用來定義的
ExtraMediaArtist	用來定義藝術家的意念額外角色名稱
ExtraMediaCapabilities	請指定 `ApplicationMediaCapabilities` 開啟媒體或選擇媒體檔案時應該使用的 that。
ExtraMediaCapabilitiesUid	指定應用程式的 UID，用來判斷開啟媒體時支援的媒體功能。
ExtraMediaFocus	Intent-extra 的名稱用於定義搜尋焦點。
ExtraMediaGenre	Intent-extra 的名稱被用來定義這個類型。
ExtraMediaPlaylist	Intent-extra 的名稱用來定義播放清單。
ExtraMediaRadioChannel	Intent-extra 的名稱曾用來定義該廣播頻道。
ExtraMediaTitle	意念額外曲名的名稱被用來定義歌曲名稱
ExtraOutput	Intent-extra 的名稱用於指示內容解析器 Uri，以儲存所請求的影像或影片。
ExtraPickerPreSelectionUris	一個可選的意向額外名稱，用於在多重選擇模式下開啟，用於指定照片選擇 `MediaStore#ACTION_PICK_IMAGES` 器預選的 URI。
ExtraPickImagesAccentColor	一個可選的意圖額外名稱，用來讓應用程式指定選擇器強調色。
ExtraPickImagesHighlightAlbum	一個可選的意圖附加名稱，用於讓應用程式在 photopicker 介面中根據給定輸入相簿 `MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_ALBUM_ID`，在可行的情況下，選取器相簿的媒體結果。
ExtraPickImagesHighlightSearchResults	一個可選的意圖額外功能名稱，用於讓應用程式在 photopicker UI 中，根據給定的輸入文字查詢，盡可能在 `MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_SEARCH_TEXT_QUERY` 額外部分只能在中 `MediaStore#ACTION_PICK_IMAGES`指定。
ExtraPickImagesInOrder	一個可選的意圖額外裝置名稱，用來允許有序選擇物品。
ExtraPickImagesLaunchTab	一個可選的意圖額外名稱，讓應用程式能指定選擇器應該開啟的分頁。
ExtraPickImagesMax	一個可選的意圖額外名稱用於允許多重選擇項目並限制可返回 `MediaStore#ACTION_PICK_IMAGES`的最大物品數量，若使用者選擇取消，動作可能仍可能返回任何物品（0）。
ExtraPickImagesSelectionParams	一個可選的意圖額外角色名稱，用來傳給 `android.widget.photopicker.PhotoPickerSelectionParams` 照片挑選者。
ExtraPickImagesUiCustomizationParams	這是用來設定 PhotoPicker 介面自訂選項的可選意圖附加功能名稱。
ExtraRequestLocationMetadataAccess	一個可選的意圖附加名稱，用於讓應用程式請求存取使用者選擇並回 `MediaStore#ACTION_PICK_IMAGES`傳的媒體項目的位置元資料。
ExtraScreenOrientation	Intent-extra 的名稱是用來控制 ViewImage 或 MovieView 的方向。
ExtraShowActionIcons	一個用於控制 ViewImage 使用者介面的 Intent-extra 名稱。
ExtraSizeLimit	請指定最大允許的尺寸。
ExtraVideoQuality	Intent-extra 的名稱用於控制錄影影片的品質。
IntentActionMediaPlayFromSearch	意圖進行音樂媒體搜尋，並在可能時自動播放結果內容。
IntentActionMediaSearch	活動動作：搜尋媒體。
IntentActionMusicPlayer	已淘汰. 活動動作：啟動音樂播放器。
IntentActionStillImageCamera	意圖動作的名稱是用來啟動靜態影像模式的攝影機。
IntentActionStillImageCameraSecure	意圖動作的名稱是用來啟動攝影機進入靜態影像模式，當裝置被固定時使用（例如：
IntentActionTextOpenFromSearch	意圖搜尋可讀媒體，並在可能時自動播放結果內容。
IntentActionVideoCamera	意向動作的名稱是用來啟動攝影機進入影像模式的。
IntentActionVideoPlayFromSearch	意圖搜尋影片媒體，並在可能時自動播放結果內容。
KeyPickImagesHighlightAlbumId	`Bundle`指定 photopicker 相簿的鑰匙`MediaStore#EXTRA_PICK_IMAGES_HIGHLIGHT_ALBUM`之一，應用程式可請求顯示高亮媒體，結果在 photopicker 中。
KeyPickImagesHighlightSearchTextQuery	`Bundle`指定應用程式可請求顯示高亮媒體的輸入查詢之一，`MediaStore#EXTRA_PICK_IMAGES_HIGHLIGHT_SEARCH_RESULTS`結果在 photopicker 中。
KeyPickImagesHighlightType	`Bundle`其中一個關鍵鍵`MediaStore#EXTRA_PICK_IMAGES_HIGHLIGHT_SEARCH_RESULTSMediaStore#EXTRA_PICK_IMAGES_HIGHLIGHT_ALBUM`是為了指定高光類型 i。
MatchDefault	已淘汰. 值表示應依照關鍵文件定義的預設匹配行為進行。
MatchExclude	已淘汰. 值表示操作應排除符合此鍵定義條件的項目。
MatchInclude	已淘汰. 值表示操作應包含符合此鍵定義條件的項目。
MatchOnly	已淘汰. 值表示操作只能對明確符合此鍵定義條件的項目進行操作。
MediaIgnoreFilename	該檔案名稱指示媒體掃描器忽略包含目錄及其子目錄中的媒體。
MediaScannerVolume	媒體掃描器掃描目前正在掃描的音量名稱。
MetaDataReviewGalleryPrewarmService	活動處理或`#ACTION_REVIEW`發布其預熱服務名稱的名稱`#ACTION_REVIEW_SECURE`。
MetaDataStillImageCameraPrewarmService	活動處理或`#INTENT_ACTION_STILL_IMAGE_CAMERA`發布其預熱服務名稱的名稱`#INTENT_ACTION_STILL_IMAGE_CAMERA_SECURE`。
PickImagesHighlightAlbumCamera	其中一個可能的相簿高亮值 `MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_ALBUM_ID` ，若應用程式選擇突出某相簿的媒體結果，這裡指的是相機相簿。
PickImagesHighlightAlbumDownloads	其中一種可能是專輯高亮值 `MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_ALBUM_ID` ，若應用程式選擇突出某張專輯的媒體結果，這裡指的是下載相簿。
PickImagesHighlightAlbumFavorites	其中一個可能的專輯亮點值是 `MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_ALBUM_ID` 如果應用程式選擇突出某張專輯的媒體結果，這裡指的是「最愛」專輯。
PickImagesHighlightAlbumScreenshots	其中一個可能的專輯亮點值是 `MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_ALBUM_ID` 如果應用程式選擇從某個相簿中選取媒體結果，這裡指的是截圖相簿。
PickImagesHighlightAlbumVideos	其中一種可能是相簿高亮值 `MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_ALBUM_ID` ，以防應用程式選擇突出某相簿的媒體結果，在此例中是影片相簿。
PickImagesHighlightTypeCollapsed	已淘汰. 允許的值之一為 `MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_TYPE` 根據 MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_ALBUM_ID} 中給定的輸入查詢 `MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_SEARCH_TEXT_QUERY` ，或在 Photopicker 相簿中，將媒體結果作為高亮媒體區塊。
PickImagesHighlightTypeExpanded	已淘汰. 允許的值之一為 `MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_TYPE` 以顯示根據 MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_ALBUM_ID} 中給定輸入查詢 `MediaStore#KEY_PICK_IMAGES_HIGHLIGHT_SEARCH_TEXT_QUERY` 或 Photopicker 相簿中給定輸入查詢的標示媒體結果網格。
PickImagesTabAlbums	已淘汰. 其中一個允許的值 `MediaStore#EXTRA_PICK_IMAGES_LAUNCH_TAB` 是用來開啟 Picker 的專輯標籤。
PickImagesTabImages	已淘汰. 其中一個允許的數值 `MediaStore#EXTRA_PICK_IMAGES_LAUNCH_TAB` 是開啟帶照片的選書機分頁。
QueryArgIncludeRecentlyUnmountedVolumes	標記該請求 `ContentResolver#query` ，要求包含最近卸載的卷內容。
QueryArgLatestSelectionOnly	標記指示是否只回傳 photoPicker 中呼叫應用程式的最新選擇。
QueryArgMatchFavorite	指定執行操作時`MediaColumns#IS_FAVORITE`項目應如何`MediaStore`篩選。
QueryArgMatchPending	指定執行操作時`MediaColumns#IS_PENDING`項目應如何`MediaStore`篩選。
QueryArgMatchTrashed	指定執行操作時`MediaColumns#IS_TRASHED`項目應如何`MediaStore`篩選。
QueryArgMediaStandardSortOrder	標記請求 `ContentResolver#query` 根據排序結果 `MediaColumns#INFERRED_DATE`的。
QueryArgRelatedUri	指定與目前執行操作「相關」的 a `Uri` 。
UnknownString	當媒體屬性未知時所使用的字串。
VolumeExternal	合成磁碟區名稱，提供裝置「外部」儲存中所有內容的檢視。
VolumeExternalPrimary	代表主要外部儲存裝置的特定 `Environment#getExternalStorageDirectory()`磁碟區名稱。
VolumeInternal	合成卷名稱，提供裝置「內部」儲存中所有內容的視圖。

屬性

名稱	Description
AuthorityUri	媒體供應商 content:// 風格的 uri 向權威機構提供
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	媒體供應商與應用程式之間的合約。 (繼承來源 JavaObject)
JniPeerMembers	媒體供應商與應用程式之間的合約。
MediaScannerUri	用 Uri 查詢媒體掃描器的狀態。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
PickImagesMaxLimit	多重選擇模式啟動時，可選擇 `MediaStore#ACTION_PICK_IMAGES` 物品數量的最大上限。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
CanManageMedia(Context)	無論呼叫應用程式是否被授權 `android.Manifest.permission#MANAGE_MEDIA` ，都會回傳。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	媒體供應商與應用程式之間的合約。 (繼承來源 JavaObject)
CreateDeleteRequest(ContentResolver, ICollection<Uri>)	建立 `PendingIntent` 一個會提示使用者永久刪除所要求媒體項目的視窗。
CreateFavoriteRequest(ContentResolver, ICollection<Uri>, Boolean)	建立 `PendingIntent` 一個會提示使用者收藏所請求媒體項目的視窗。
CreateTrashRequest(ContentResolver, ICollection<Uri>, Boolean)	建立 `PendingIntent` 一個會提示使用者丟棄所要求媒體項目的視窗。
CreateWriteRequest(ContentResolver, ICollection<Uri>)	建立 `PendingIntent` 一個會提示使用者授權你應用程式撰寫所需媒體項目的應用程式。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	媒體供應商與應用程式之間的合約。 (繼承來源 JavaObject)
Equals(Object)	媒體供應商與應用程式之間的合約。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetDocumentUri(Context, Uri)	回傳 `DocumentsProvider` 一個與該 `MediaStore` Uri 等價的 Uri。
GetExternalVolumeNames(Context)	回傳所有組成 `#VOLUME_EXTERNAL`的具體卷名清單。
GetGeneration(Context, String)	回傳該體積的最新世代值。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetMediaUri(Context, Uri)	回傳 `MediaStore` 一個與該 `DocumentsProvider` Uri 等價的 Uri。
GetOriginalMediaFormatFileDescriptor(Context, ParcelFileDescriptor)	返回 `ParcelFileDescriptor` 代表原始媒體檔案格式的 `fileDescriptor`。
GetPackageForSearchMediaService(ContentResolver)	會取得該用戶端應用程式用來連接的套件名稱 `SearchMediaService` 。
GetRecentExternalVolumeNames(Context)	所有近期卷 `#VOLUME_EXTERNAL`名的回傳清單。
GetRedactedUri(ContentResolver, IList<Uri>)	回傳經過 EXIF 遮蔽的 i 版本 `uris` 清單。
GetRedactedUri(ContentResolver, Uri)	回傳經過 EXIF 遮蔽的 i 版本 `uri` 。
GetRequireOriginal(Uri)	如果呼叫者在呼叫 `ContentResolver#openFileDescriptor(Uri, String)`時需要原始檔案內容，則回傳。
GetVersion(Context, String)	回傳一個不透明版本的字串，描述該狀態。`MediaStore`
GetVersion(Context)	回傳一個不透明版本的字串，描述該狀態。`MediaStore`
GetVolumeName(Uri)	回傳該所參考 `Uri` 的卷名。
IsCurrentCloudMediaProviderAuthority(ContentResolver, String)	`true`當且僅當以的`authority`呼叫者是目前啟用`CloudMediaProvider`的。
IsCurrentSystemGallery(ContentResolver, Int32, String)	若該應用程式是裝置目前的系統庫，則回傳為真。
IsSupportedCloudMediaProviderAuthority(ContentResolver, String)	當且僅當呼叫者`true`為支援 `authority`時回傳 `CloudMediaProvider` 。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
MarkIsFavoriteStatus(ContentResolver, ICollection<Uri>, Boolean)	如果呼叫應用程式對特定類型的媒體檔案擁有更廣泛的讀取權限，則會設定 media isFavorite 狀態。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
NotifyCloudMediaChangedEvent(ContentResolver, String, String)	通知作業系統有雲端媒體事件需要對目前啟用的雲端供應商 `authority`進行完整或增量媒體收集同步。
OpenAssetFileDescriptor(ContentResolver, Uri, String, CancellationSignal)	與完全相同 `ContentResolver#openAssetFileDescriptor(Uri, String, CancellationSignal)`，但僅適用於 `Uri` 其範疇為 `ContentResolver#SCHEME_CONTENT` 且其權威為 `MediaStore#AUTHORITY`。
OpenFileDescriptor(ContentResolver, Uri, String, CancellationSignal)	與完全相同 `ContentResolver#openFileDescriptor(Uri, String, CancellationSignal)`，但僅適用於 `Uri` 其範疇為 `ContentResolver#SCHEME_CONTENT` 且其權威為 `MediaStore#AUTHORITY`。
OpenTypedAssetFileDescriptor(ContentResolver, Uri, String, Bundle, CancellationSignal)	與完全相同 `ContentResolver#openTypedAssetFileDescriptor(Uri, String, Bundle, CancellationSignal)`，但僅適用於 `Uri` 其範疇為 `ContentResolver#SCHEME_CONTENT` 且其權威為 `MediaStore#AUTHORITY`。
QueryDeletedFiles(ContentResolver, Bundle, CancellationSignal)	回傳一個與給定查詢參數相符的已刪除項目游標。
RestoreFileFromTrash(ContentResolver, String, String)	從丟棄狀態還原檔案或目錄。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetIncludePending(Uri)	更新 given `Uri` 也包含任何來自通話的待處理媒體項目，例如 `ContentResolver#query(Uri, String[], Bundle, CancellationSignal)`。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	媒體供應商與應用程式之間的合約。 (繼承來源 JavaObject)
SetRequireOriginal(Uri)	更新給定 `Uri` 的參數，表示呼叫者在呼叫 `ContentResolver#openFileDescriptor(Uri, String)`時需要原始檔案內容。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
TrashFile(ContentResolver, String)	將檔案或目錄移至廢棄狀態。
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	媒體供應商與應用程式之間的合約。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	媒體供應商與應用程式之間的合約。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	媒體供應商與應用程式之間的合約。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	媒體供應商與應用程式之間的合約。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	媒體供應商與應用程式之間的合約。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	媒體供應商與應用程式之間的合約。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	媒體供應商與應用程式之間的合約。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於