Module MediaProvider

Le module MediaProvider optimise les métadonnées indexées (audio, vidéo et images à partir de cartes SD et d'appareils USB) et met ces données à la disposition des applications via les API publiques MediaStore. Pour préserver la confidentialité des utilisateurs, le module MediaProvider applique le modèle de sécurité de stockage avec portée introduit dans Android 10, qui inclut la masquage des métadonnées de localisation sensibles. Ce module peut être mis à jour, ce qui permet à Android de répondre plus rapidement aux problèmes de sécurité (en protégeant les données utilisateur sensibles) et d'ajouter plus rapidement de nouveaux formats multimédias (ce qui assure la cohérence aux utilisateurs et aux développeurs).

Modifications apportées dans Android 10

Android 10 a introduit plusieurs améliorations liées à l'identification et à l'extraction de données à partir de fichiers multimédias, en particulier :

  • Déterminer le type de contenu d'un fichier à l'aide de la première partie du type MIME d'un fichier. Par exemple, le système d'exploitation sait que image/png et image/x-newly-invented-format sont des images, et peut donc décrire avec précision les autorisations pertinentes à l'utilisateur final.

  • Déterminer le type MIME à l'aide de l'extension de fichier uniquement (et sans reniflage de contenu pour éviter les problèmes de sécurité)

  • Déterminer le type MIME d'un fichier arbitraire à l'aide d'une combinaison de mappages Debian Linux et Android en amont.

  • Renvoie des données pertinentes à partir des fichiers video/* et audio/* (via MediaMetadataRetriever) et des fichiers image/* (via ExifInterface).

Modifications apportées à Android 11

Dans Android 11, le module MediaProvider s'appuie sur les modifications apportées dans Android 10 avec les améliorations suivantes:

  • Améliorations de l'indexation. Le module MediaProvider indexe désormais les métadonnées en les rapprochant des API publiques MediaStore. Voici quelques-unes des modifications apportées :

    • Nouvelle colonne is_favorite et argument QUERY_ARG_MATCH_FAVORITE pour permettre aux applications de style galerie de filtrer rapidement les contenus multimédias en fonction de cette colonne.

    • Indexation des métadonnées de l'espace colorimétrique.

    • Nouvelle colonne "is_trashed" et argument QUERY_ARG_MATCH_TRASHED pour permettre aux applications de style galerie de filtrer en fonction de cette colonne.

    • Nouvelles API permettant la modification groupée de plusieurs éléments à l'aide d'une seule invite de boîte de dialogue, y compris createDeleteRequest(), createFavoriteRequest(), createTrashRequest() et createWriteRequest().

    • Nouvelles colonnes GENERATION_ADDED et GENERATION_MODIFIED à utiliser pour détecter rapidement et de manière fiable les modifications qui ont eu lieu depuis un point de synchronisation précédent.

    • Nouvelle API publique GROUP BY à utiliser avec des colonnes de métadonnées supplémentaires non mentionnées ci-dessus.

  • Amélioration de ExifInterface pour extraire les métadonnées des conteneurs PNG et WebP.

  • Améliorations de SystemUI pour l'écriture des métadonnées DateTimeOriginal dans les captures d'écran.

En outre, vous pouvez à présent personnaliser MediaProvider en ajoutant de nouveaux formats multimédias, en indiquant les périphériques de stockage à indexer et même en remplaçant la pile MTP. Pour en savoir plus, consultez Personnalisation.

Limite du module

Android 11 migre tout le code de packages/providers/MediaProvider vers un nouvel emplacement, à l'exception notable de la logique liée à MTP. De plus, frameworks/base/core/java/android/provider/MediaStore.java se trouve désormais à l'intérieur de la limite du module à packages/providers/MediaProvider.

Format du package

Le module MediaProvider est au format APK-in-APEX.

Dépendances

Les dépendances MediaProvider sont liées aux personnalisations (c'est-à-dire que si vous personnalisez MediaProvider, vous devez vous assurer que votre implémentation répond à la dépendance associée à votre personnalisation).

  • Lorsque vous utilisez des formats de fichiers multimédias personnalisés ou non standards (par exemple, un format généré par une application Appareil photo propre à un fournisseur), vous devez enregistrer chaque format personnalisé avec MimeUtils et le module Media Extractor pour permettre l'indexation par MediaProvider.

  • Pour vous assurer que MediaProvider indexe un ensemble personnalisé d'appareils de stockage (emplacements de carte SD et ports USB, par exemple) utilisés dans une implémentation StorageManagerService, définissez l'indicateur VolumeInfo.MOUNT_FLAG_INDEXABLE.

  • Lorsque vous utilisez une implémentation MTP personnalisée (non AOSP), assurez-vous qu'elle repose uniquement sur des API publiques et système pour permettre à l'implémentation d'interagir avec MediaStore.

Personnalisation

Vous pouvez désormais ajouter de nouveaux formats multimédias, influer sur les périphériques de stockage indexés et remplacer la pile MTP.

  • Formats multimédias personnalisés. Pour chaque nouveau format multimédia personnalisé, vous devez fournir un mappage de l'extension de fichier unique à un type MIME. Nous vous encourageons vivement à suivre le processus d'enregistrement de l'IANA.

    • Vous ne pouvez pas redéfinir une extension ou un type MIME déjà définis dans AOSP.

    • Pour les fichiers video/* et audio/*, MediaProvider continue de consulter MediaMetadataRetriever. Utilisez les extracteurs multimédias Android 10 pour renvoyer des métadonnées pour les formats personnalisés.

    • Pour les fichiers image/*, MediaProvider continue de standardiser Exif pour les métadonnées. Vous pouvez étendre android.media.ExifInterface afin d'extraire et de renvoyer les métadonnées Exif pour tous les formats d'image personnalisés.

  • Indicateur d'indexation des périphériques de stockage. MediaProvider indexe tous les volumes renvoyés par StorageManager.getStorageVolumes(), où StorageVolume.getMediaStoreVolumeName() n'est pas nul. Vous pouvez personnaliser la liste des volumes renvoyés pour influencer ce qui est indexé, mais nous vous déconseillons d'inclure des volumes temporaires (tels que des clés USB OTG).

  • Remplacement de la pile MTP. Android 11 place la pile MTP entièrement en dehors de la limite du module et s'assure qu'elle fonctionne avec les API publiques.

Tests

Vous pouvez vérifier le fonctionnement de MediaProvider à l'aide des tests suivants:

  • Pour vérifier le fonctionnement des API publiques MediaStore, utilisez les tests du package CtsProviderTestCases de la suite de tests de compatibilité Android (CTS).

  • Pour vérifier le fonctionnement des composants internes de MediaProvider, utilisez des tests dans MediaProviderTests.

Pour exécuter les deux ensembles de tests en même temps, utilisez la commande atest suivante:

atest --test-mapping packages/providers/MediaProvider