Módulo MediaProvider

El módulo MediaProvider optimiza los metadatos indexados (audio, video e imágenes de tarjetas SD y dispositivos USB) y pone esos datos a disposición de las apps a través de las APIs públicas de MediaStore. Para mantener la privacidad del usuario, el módulo MediaProvider aplica el modelo de seguridad de almacenamiento centrado que se introdujo en Android 10, que incluye la ocultación de metadatos de ubicación sensibles. Este módulo se puede actualizar, lo que permite que Android responda más rápido a los problemas de seguridad (manteniendo protegidos los datos sensibles del usuario) y agregue nuevos formatos de contenido multimedia más rápido (lo que proporciona coherencia a los usuarios y desarrolladores).

Cambios en Android 10

En Android 10, se incluyeron varias mejoras relacionadas con la identificación y extracción de datos de archivos multimedia, en particular:

  • Determina el tipo de contenido del archivo con la primera parte del tipo de MIME de un archivo. Por ejemplo, el SO sabe que image/png y image/x-newly-invented-format son imágenes y, por lo tanto, puede describir con precisión los permisos relevantes al usuario final.

  • Determinar el tipo de MIME solo con la extensión del archivo (y sin usar detección de contenido para evitar problemas de seguridad)

  • Determinar el tipo MIME de un archivo arbitrario con una combinación de asignaciones de Android y Debian Linux upstream

  • Devuelve datos relevantes de los archivos video/* y audio/* (a través de MediaMetadataRetriever) y de los archivos image/* (a través de ExifInterface).

Cambios en Android 11

En Android 11, el módulo MediaProvider se basa en los cambios realizados en Android 10 con las siguientes mejoras:

  • Se realizaron mejoras en la indexación. El módulo MediaProvider ahora indexa los metadatos a través de la conciliación de los metadatos disponibles con las APIs públicas de MediaStore. Entre los cambios, se incluyen los siguientes:

    • Nueva columna is_favorite y argumento QUERY_ARG_MATCH_FAVORITE para permitir que las apps de estilo de galería filtren rápidamente el contenido multimedia en función de esta columna.

    • Indexación de metadatos de espacio de color

    • Nueva columna "is_trashed" y argumento QUERY_ARG_MATCH_TRASHED para permitir que las apps de estilo de galería filtren según esta columna.

    • Nuevas APIs que permiten la modificación masiva de varios elementos con una sola instrucción de diálogo del usuario, incluidas createDeleteRequest(), createFavoriteRequest(), createTrashRequest() y createWriteRequest().

    • Nuevas columnas GENERATION_ADDED y GENERATION_MODIFIED para detectar de forma rápida y confiable los cambios que se produjeron desde un punto de sincronización anterior.

    • Nueva API pública de GROUP BY para usar con columnas de metadatos adicionales que no se mencionaron anteriormente.

  • Se realizaron mejoras en ExifInterface para extraer metadatos de contenedores PNG y WebP.

  • Se realizaron mejoras en SystemUI para escribir metadatos DateTimeOriginal en capturas de pantalla.

Además, ahora puedes personalizar MediaProvider agregando nuevos formatos de contenido multimedia, marcando qué dispositivos de almacenamiento se deben indexar y hasta reemplazando la pila de MTP. Para obtener más información, consulta Personalización.

Límite del módulo

Android 11 migra todo el código de packages/providers/MediaProvider a una ubicación nueva, con la excepción notable de la lógica relacionada con MTP. Además, frameworks/base/core/java/android/provider/MediaStore.java ahora está dentro del límite del módulo en packages/providers/MediaProvider.

Formato del paquete

El módulo MediaProvider está en formato APK-in-APEX.

Dependencias

Las dependencias de MediaProvider se relacionan con las personalizaciones (es decir, si personalizas MediaProvider, debes asegurarte de que tu implementación cumpla con la dependencia asociada con tu personalización).

  • Cuando uses formatos de archivos multimedia personalizados o no estándar (por ejemplo, un formato que genera una app de cámara específica del fabricante), debes registrar cada formato personalizado con MimeUtils y el módulo Media Extractor para habilitar la indexación por MediaProvider.

  • Para garantizar que MediaProvider indexe un conjunto personalizado de dispositivos de almacenamiento (como ranuras para tarjetas SD y puertos USB) que se usan en una implementación de StorageManagerService, establece la marca VolumeInfo.MOUNT_FLAG_INDEXABLE.

  • Cuando uses una implementación de MTP personalizada (no AOSP), asegúrate de que esta dependa únicamente de las APIs públicas y del sistema para permitir que interactúe con MediaStore.

Personalización

Ahora puedes agregar nuevos formatos multimedia, influir en qué dispositivos de almacenamiento se indexan y reemplazar la pila de MTP.

  • Formatos multimedia personalizados. Para cada formato multimedia personalizado nuevo, debes proporcionar una asignación de la extensión de archivo única a un tipo de MIME. Te recomendamos que sigas el proceso de registro de la IANA.

    • No puedes redefinir una extensión o un tipo MIME que ya esté definido en AOSP.

    • En el caso de los archivos video/* y audio/*, MediaProvider continúa consultando MediaMetadataRetriever. Usa los extractores de contenido multimedia de Android 10 para mostrar metadatos de formatos personalizados.

    • En el caso de los archivos image/*, MediaProvider continúa estandarizando en Exif para los metadatos. Puedes extender android.media.ExifInterface para extraer y mostrar metadatos Exif para cualquier formato de imagen personalizado.

  • Marca de indexación de dispositivos de almacenamiento MediaProvider indexa todos los volúmenes que muestra StorageManager.getStorageVolumes(), en los que StorageVolume.getMediaStoreVolumeName() no es nulo. Puedes personalizar la lista de volúmenes que se muestran para influir en lo que se indexa, pero te recomendamos que no incluyas volúmenes transitorios (como unidades USB OTG).

  • Reemplazo de la pila de MTP: Android 11 coloca la pila de MTP completamente fuera del límite del módulo y se asegura de que funcione con las APIs públicas.

Prueba

Puedes verificar la funcionalidad de MediaProvider con las siguientes pruebas:

  • Para verificar la funcionalidad de las APIs públicas de MediaStore, usa pruebas en el paquete CtsProviderTestCases del conjunto de pruebas de compatibilidad de Android (CTS).

  • Para verificar la funcionalidad de los elementos internos de MediaProvider, usa pruebas en MediaProviderTests.

Para ejecutar ambos conjuntos de pruebas, usa el siguiente comando atest:

atest --test-mapping packages/providers/MediaProvider