ContextWrapper.GetExternalMediaDirs 方法

[Android.Runtime.Register("getExternalMediaDirs", "()[Ljava/io/File;", "GetGetExternalMediaDirsHandler")]
[System.Obsolete("deprecated")]
public override Java.IO.File[]? GetExternalMediaDirs();

[<Android.Runtime.Register("getExternalMediaDirs", "()[Ljava/io/File;", "GetGetExternalMediaDirsHandler")>]
[<System.Obsolete("deprecated")>]
override this.GetExternalMediaDirs : unit -> Java.IO.File[]

傳回

此方法已被取代。 這些目錄仍然存在並可掃描，但開發者被鼓勵直接將內容插入 MediaStore 集合，因為任何應用程式自 Build.VERSION_CODES 年起都能無需授權地向 MediaStore 貢獻新媒體。Q . 回傳所有共享/外部儲存裝置上應用程式專屬目錄的絕對路徑，應用程式可在此放置媒體檔案。 這些檔案會被掃描後，透過 MediaStore 提供給其他應用程式。 這類似於 getExternalFilesDirs（String），這些檔案在應用程式卸載時會被刪除，但兩者有一些重要差異：共享儲存空間不一定隨時可用，因為使用者可以彈出可移除的媒體。 媒體狀態可透過 Environment.getExternalStorageState（File） 檢查。 這些檔案並未執行任何安全措施。 例如，任何持有Manifest.permission.WRITE_EXTERNAL_STORAGE的應用程式都能寫入這些檔案。 此處歸還的共享儲存裝置被視為裝置的穩定部分，包括保護蓋下的實體媒體槽。 回傳路徑不包含暫時性裝置，例如連接於手持裝置的 USB 隨身碟。 應用程式可能會將資料儲存在任何或所有退回的裝置上。 例如，應用程式可能會選擇將大型檔案儲存在可用空間最多的裝置上，該裝置以 StatF 衡量。 呼叫應用程式在回傳路徑下讀寫檔案不需要額外權限。 在這些路徑之外，次級外部儲存裝置無法寫入存取。 若插入不同的共享儲存媒介，回傳路徑可能會隨時間改變，因此應僅保留相對路徑。 回傳檔案[]，提供應用程式專屬目錄的絕對路徑。 若該共享儲存目前無法使用，某些個別路徑可能會為空。

屬性

RegisterAttribute ObsoleteAttribute

備註

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

Java 文件 android.content.ContextWrapper.getExternalMediaDirs()。