Context.GetExternalMediaDirs 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
回傳所有共享/外部儲存裝置上應用程式專屬目錄的絕對路徑,應用程式可在此放置媒體檔案。
[Android.Runtime.Register("getExternalMediaDirs", "()[Ljava/io/File;", "GetGetExternalMediaDirsHandler")]
public abstract Java.IO.File[]? GetExternalMediaDirs();
[<Android.Runtime.Register("getExternalMediaDirs", "()[Ljava/io/File;", "GetGetExternalMediaDirsHandler")>]
abstract member GetExternalMediaDirs : unit -> Java.IO.File[]
傳回
絕對路徑指向特定應用程式目錄。 有些個別路徑可能是 null 因為該共享儲存目前無法使用。
- 屬性
備註
回傳所有共享/外部儲存裝置上應用程式專屬目錄的絕對路徑,應用程式可在此放置媒體檔案。 這些檔案會被掃描並透過 S 提供給其他應用程式 MediaStore。
這類似 #getExternalFilesDirs 於這些檔案在應用程式卸載時會被刪除,但兩者有一些重要差異: <ul><li>共享儲存空間可能不一定隨時可用,因為使用者可以彈出可移除的媒體。 媒體狀態可用 檢查 Environment#getExternalStorageState(File)。
<李>:這些檔案沒有執行任何安全措施。 例如,任何持有的 android.Manifest.permission#WRITE_EXTERNAL_STORAGE 應用程式都可以寫入這些檔案。
</ul>
此處歸還的共享儲存裝置被視為裝置的穩定部分,包括保護蓋下的實體媒體槽。 回傳路徑不包含暫時性裝置,例如連接於手持裝置的 USB 隨身碟。
應用程式可能會將資料儲存在任何或所有退回的裝置上。 例如,應用程式可能會選擇將較大檔案儲存在空間最大(以 StatFs為單位)的裝置上。
呼叫應用程式在回傳路徑下讀寫檔案不需要額外權限。 在這些路徑之外,次級外部儲存裝置無法寫入存取。
若插入不同的共享儲存媒介,回傳路徑可能會隨時間改變,因此應僅保留相對路徑。
此會員已被棄用。 這些目錄仍然存在並可掃描,但開發者被鼓勵遷移到直接將內容插入MediaStore收藏,因為任何應用程式都能在 從 開始MediaStore無需權限的情況下貢獻新媒體。android.os.Build.VERSION_CODES#Q
Java 文件 android.content.Context.getExternalMediaDirs()。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。