Context.GetExternalMediaDirs Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne des chemins absolus vers des répertoires spécifiques à l’application sur tous les appareils de stockage partagé/externe où l’application peut placer des fichiers multimédias.
[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[]Retours
chemins absolus vers des répertoires spécifiques à l’application. Certains chemins d’accès individuels peuvent être null si ce stockage partagé n’est pas disponible actuellement.
- Attributs
Remarques
Retourne des chemins absolus vers des répertoires spécifiques à l’application sur tous les appareils de stockage partagé/externe où l’application peut placer des fichiers multimédias. Ces fichiers sont analysés et mis à la disposition d’autres applications via MediaStore.
C’est comme #getExternalFilesDirs si ces fichiers seront supprimés lorsque l’application est désinstallée, mais il existe certaines différences importantes : <le stockage partagé ul><li>peut ne pas toujours être disponible, car le support amovible peut être éjecté par l’utilisateur. L’état du média peut être vérifié à l’aide Environment#getExternalStorageState(File)de .
<li>Il n’existe aucune sécurité appliquée avec ces fichiers. Par exemple, toute application contenant android.Manifest.permission#WRITE_EXTERNAL_STORAGE peut écrire dans ces fichiers.
</ul>
Les appareils de stockage partagé retournés ici sont considérés comme une partie stable de l’appareil, y compris les emplacements multimédias physiques sous une couverture de protection. Les chemins retournés n’incluent pas d’appareils temporaires, tels que les lecteurs flash USB connectés aux appareils portables.
Une application peut stocker des données sur l’un ou l’ensemble des appareils retournés. Par exemple, une application peut choisir de stocker des fichiers volumineux sur l’appareil avec l’espace le plus disponible, comme mesuré par StatFs.
Aucune autorisation supplémentaire n’est requise pour que l’application appelante lit ou écrit des fichiers sous le chemin d’accès retourné. L’accès en écriture en dehors de ces chemins d’accès sur les périphériques de stockage externes secondaires n’est pas disponible.
Les chemins retournés peuvent changer au fil du temps si différents supports de stockage partagé sont insérés, de sorte que seuls les chemins relatifs doivent être conservés.
Ce membre est déconseillé. Ces répertoires existent toujours et sont analysés, mais les développeurs sont encouragés à migrer vers l’insertion de contenu dans une collection directement, car n’importe quelle application peut contribuer à MediaStore un MediaStore nouveau média sans autorisations requises, en commençant par android.os.Build.VERSION_CODES#Q.
Java documentation pour android.content.Context.getExternalMediaDirs().
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.