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 フラッシュ ドライブなどの一時的なデバイスは含まれません。 アプリケーションは、返されたデバイスの一部または全部にデータを格納できます。 たとえば、アプリでは、StatFs によって測定される、使用可能な領域が最も多いデバイスに大きなファイルを格納することを選択できます。 呼び出し元のアプリが、返されたパスの下のファイルを読み書きするために、追加のアクセス許可は必要ありません。 セカンダリ外部ストレージ デバイスでは、これらのパス以外の書き込みアクセスは使用できません。 異なる共有ストレージ メディアが挿入されると、返されるパスが時間の経過と同時に変化する可能性があるため、相対パスのみを保持する必要があります。 アプリケーション固有のディレクトリへの絶対パスである File[] を返します。 共有ストレージが現在使用できない場合、一部の個々のパスは null になる可能性があります。

属性

RegisterAttribute ObsoleteAttribute

注釈

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Javaドキュメント。