Module MediaProvider

Le module MediaProvider optimise les métadonnées indexées (audio, vidéo et images provenant de cartes SD et de périphériques 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é du stockage cloisonné introduit dans Android 10, qui inclut le 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 à 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.

  • Affichage 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 rapprochant les métadonnées disponibles avec les API publiques MediaStore. Les modifications incluent:

    • 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.

    • Ajout d'une colonne "is_trashed" et d'un 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 permettant de détecter rapidement et de manière fiable les modifications survenues 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 au niveau de 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. En d'autres termes, 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é de périphériques de stockage (tels que des emplacements pour cartes SD et des ports USB) 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 ne repose que 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 de média personnalisé, vous devez fournir un mappage entre l'extension de fichier unique et 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 normaliser les métadonnées sur Exif. 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 des limites du module et garantit 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