MediaStore API : définition, fonctionnalités et travail avec les fichiers multimédias partagés

Qu'est-ce que MediaStore API ?

MediaStore API est un fournisseur de contenu système sur la plateforme Android conçu pour indexer, stocker et fournir l'accès aux fichiers multimédias de l'appareil. L'API fait partie du SDK Android et est disponible depuis le niveau d'API 1.

MediaStore fonctionne via une base de données multimédia unifiée qui analyse automatiquement l'appareil et collecte les métadonnées de tous les fichiers multimédias. La base de données est mise à jour par le système lors de l'ajout, la modification ou la suppression de fichiers, donc les applications reçoivent toujours des informations à jour sans analyse manuelle.

Les principales tables de MediaStore sont : Images (images), Video (vidéos), Audio (fichiers audio) et Files (fichiers généraux). Chaque table contient des colonnes avec des métadonnées : nom, date de création, taille, type MIME, coordonnées GPS et autres attributs.

Évolution de MediaStore dans les versions Android

Avant Android 10, les développeurs utilisaient READ_EXTERNAL_STORAGE pour accéder à tous les fichiers de l'appareil. Android 10 (API 29) a introduit Scoped Storage : les applications ne pouvaient accéder qu'à leurs propres fichiers et via MediaStore. Android 11 a renforcé la politique, bloquant complètement le chemin direct vers les répertoires partagés.

À partir d'Android 13 (API 33), Google a remplacé READ_EXTERNAL_STORAGE par des autorisations granulaires : READ_MEDIA_IMAGES, READ_MEDIA_VIDEO et READ_MEDIA_AUDIO. Cela permet aux utilisateurs d'accorder l'accès uniquement à des types de médias spécifiques sans exposer tout le stockage.

Comment fonctionne MediaStore : architecture et base de données multimédia

MediaStore est construit sur une architecture de fournisseur de contenu : chaque application y accède via ContentResolver et Uri. Le scanner multimédia système — MediaScannerConnection — indexe automatiquement tous les fichiers de l'appareil au démarrage, à la connexion USB ou au redémarrage.

La base de données multimédia est stockée dans la base de données système et contient des enregistrements pour chaque fichier multimédia. Les colonnes diffèrent selon le type : les images ont ORIENTATION et DATE_TAKEN, les vidéos ont DURATION, les fichiers audio ont ARTIST et ALBUM. Les développeurs peuvent exécuter des requêtes de type SQL avec query, projection et selection pour filtrer.

val projection = arrayOf(
    MediaStore.Images.Media._ID,
    MediaStore.Images.Media.DISPLAY_NAME,
    MediaStore.Images.Media.DATE_ADDED
)

val cursor = contentResolver.query(
    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
    projection,
    null,
    null,
    MediaStore.Images.Media.DATE_ADDED + " DESC"
)

cursor?.use {
    while (moveToNext()) {
        val name = getString(getColumnIndexOrThrow(MediaStore.Images.Media.DISPLAY_NAME))
    }
}

Content URI et leur signification

Chaque fichier multimédia est identifié par une Content URI comme content://media/external/images/media/1234. L'URI externe pointe vers le stockage partagé, tandis que l'URI interne pointe vers les fichiers multimédias système. Utiliser des URI au lieu de chemins de fichier est un avantage clé de MediaStore : l'application n'a pas besoin d'accès au système de fichiers et fonctionne via un fournisseur de contenu sécurisé.

Types de fichiers multimédias dans MediaStore

MediaStore prend en charge quatre types principaux de médias, chacun avec sa propre table et son propre ensemble de métadonnées. Les développeurs sélectionnent la table appropriée en fonction du type de contenu avec lequel leur application travaille.

• MediaStore.Images — photos, captures d'écran et images. Colonnes : BUCKET_DISPLAY_NAME, IS_PRIVATE, LATITUDE, LONGITUDE.
• MediaStore.Video — enregistrements vidéo et films. Colonnes : DURATION, RESOLUTION, IS_DRM.
• MediaStore.Audio — pistes musicales et fichiers sonores. Colonnes : ARTIST, ALBUM, COMPOSER, TRACK.
• MediaStore.Files — documents et autres fichiers. Disponible depuis Android 10 pour l'accès partagé.

En plus des colonnes standard, chaque table contient des champs système : _ID, DATA (obsolète), SIZE, MIME_TYPE, DATE_ADDED, DATE_MODIFIED. Depuis Android 10, le champ DATA est marqué comme obsolète, et les développeurs doivent travailler en ouvrant un InputStream via URI.

Autorisations pour travailler avec MediaStore

MediaStore nécessite des autorisations explicites, qui diffèrent selon la version d'Android. Avant Android 13, l'autorisation unique READ_EXTERNAL_STORAGE était utilisée. À partir d'Android 13 (API 33), Google a introduit des autorisations granulaires pour chaque type de média.

L'écriture dans MediaStore nécessite également WRITE_EXTERNAL_STORAGE pour Android 9 et inférieur. À partir d'Android 10, une application peut écrire ses propres fichiers dans MediaStore sans autorisations supplémentaires — le système accorde automatiquement l'accès lors de l'insertion d'un enregistrement via ContentResolver.insert.

Demander des autorisations au moment de l'exécution

Les autorisations MediaStore sont demandées via le mécanisme standard ActivityResultContracts.RequestMultiplePermissions. L'utilisateur peut refuser la demande, et l'application doit gérer correctement ce scénario. Il est recommandé de vérifier l'autorisation via ContextCompat.checkSelfPermission avant chaque accès à MediaStore.

Exemples de code : lecture et écriture via MediaStore

MediaStore permet non seulement de lire mais aussi d'écrire des fichiers multimédia. Pour écrire une image ou une vidéo, le développeur utilise ContentResolver.insert et ouvre un OutputStream pour l'URI retourné. Le système ajoute automatiquement le fichier à la base de données multimédia et l'indexe.

val values = ContentValues().apply {
    put(MediaStore.Images.Media.DISPLAY_NAME, "photo_2025.jpg")
    put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg")
    put(MediaStore.Images.Media.RELATIVE_PATH, "Pictures/MyApp")
}

val uri = contentResolver?.insert(
    MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values
)

uri?.let {
    val outputStream = contentResolver?.openOutputStream(it)
    outputStream?.use { stream ->
        // écrire des octets dans le flux
    }
}

Suppression de fichiers multimédia via MediaStore

La suppression est effectuée via ContentResolver.delete avec l'URI du fichier. Le système vérifie les droits d'accès : si le fichier appartient à l'application actuelle, la suppression se produit sans autorisations supplémentaires. Pour les fichiers d'autres applications sur Android 10+, une confirmation de l'utilisateur via une boîte de dialogue système est requise.

MediaStore vs accès direct aux fichiers

MediaStore API diffère fondamentalement de l'accès direct aux fichiers via l'API File. Au lieu de chemins de fichier, des Content URI sont utilisés, et au lieu d'opérations sur les fichiers, des méthodes ContentResolver sont utilisées. Cela offre trois avantages clés : sécurité, indexation automatique et interface unifiée.

L'accès direct aux fichiers est restreint sur Android 10+ pour les répertoires partagés. MediaStore reste le seul moyen de lire les médias depuis Pictures, DCIM, Movies, Music et Download. Pour les fichiers spécifiques à l'application (app-specific storage), l'accès direct est préservé — ce sont les dossiers dans Android/data et Android/media.

Le choix entre MediaStore et l'accès direct dépend du type de contenu. MediaStore est obligatoire pour les fichiers multimédias partagés accessibles par d'autres applications. L'API File directe convient aux fichiers internes de l'application et au cache. Le Storage Access Framework est utilisé pour sélectionner des documents arbitraires via le sélecteur système.