Puedes extender los componentes del extractor y el códec de medios con extensiones del proveedor. Las APIs de MediaSession2 y MediaParser no se pueden personalizar (pero puedes enviar cambios para las APIs heredadas de MediaPlayer
y MediaSession
).
Para admitir tipos de contenido multimedia adicionales en el marco de trabajo de contenido multimedia de Android, debes crear un extractor y un decodificador personalizados. Por ejemplo, para agregar compatibilidad con videos de Windows Media en archivos AVI, debes crear un Extractor de AVI y un Decoder de video de Windows Media.
Acerca de las extensiones
Si los extractores de medios predeterminados no cumplen con tus requisitos, puedes colocar complementos de extractores personalizados en /system/lib[64]/extractors/
. El proceso del extractor carga automáticamente los complementos del extractor desde el paquete APEX proporcionado por Google y desde /system/lib[64]/extractors/
.
De manera similar, puedes configurar servicios de códec de medios personalizados que usen la interfaz de Codec 2.0 definida en frameworks/av/media/codec2/core/
. Para una implementación básica, consulta frameworks/av/media/codec2/hidl/services/
. El punto de entrada de la biblioteca es la interfaz C2ComponentStore
. Para ver un ejemplo, consulta la implementación predeterminada del almacén de códecs de software en frameworks/av/media/codec2/vndk/C2Store.cpp
.
Cuando uses tu propio APEX, estructura el servicio de códec y carga el archivo APEX con los mismos procesos que el servicio mediaswcodec
. Para ello, define una biblioteca compartida de nivel superior responsable de registrar todos los componentes de C2 y, luego, crea un paquete APEX (con dependencias transitivas) que resida en la partición del proveedor. Cuando se inicia el proceso del servicio de códec del proveedor, se puede cargar este punto de entrada de nivel superior.
Crea un extractor
Cuando agregues un extractor para un formato nuevo, asegúrate de que dependa solo de las APIs estables del NDK y no de ninguna API privada. Los extractores deben implementar la API definida por frameworks/av/include/media/MediaExtractorPluginApi.h
y pueden usar los wrappers de conveniencia de C++ en frameworks/av/include/media/MediaExtractorPluginHelper.h
. Dado que Android 10 o versiones posteriores solo admiten la versión más reciente de la API del extractor, asegúrate de modelar tu extractor según el extractor con el número de versión de API más alto.
Coloca extractores personalizados en /system/lib/64/extractors
o en un APEX del proveedor, que se abre junto con el APEX de Google que contiene los extractores de Google. Para verificar que el framework cargó tu extractor, ejecuta el siguiente comando.
adb shell dumpsys media.extractor
Deberías obtener una lista de extractores disponibles similar a la siguiente.
Available extractors:
AAC Extractor: plugin\_version(2), uuid(4fd80eae03d24d729eb948fa6bb54613), version(1), path(/system/lib64/extractors/libaacextractor.so)
AMR Extractor: plugin\_version(2), uuid(c86639c92f3140aca715fa01b4493aaf), version(1), path(/system/lib64/extractors/libamrextractor.so)
FLAC Extractor: plugin\_version(2), uuid(1364b048cc454fda9934327d0ebf9829), version(1), path(/system/lib64/extractors/libflacextractor.so)
MIDI Extractor: plugin\_version(2), uuid(ef6cca0af8a243e6ba5fdfcd7c9a7ef2), version(1), path(/system/lib64/extractors/libmidiextractor.so)
MP3 Extractor: plugin\_version(2), uuid(812a3f6cc8cf46deb5293774b14103d4), version(1), path(/system/lib64/extractors/libmp3extractor.so)
MP4 Extractor: plugin\_version(2), uuid(27575c6744174c548d3d8e626985a164), version(2), path(/system/lib64/extractors/libmp4extractor.so)
MPEG2-PS/TS Extractor: plugin\_version(1), uuid(3d1dcfebe40a436da574c2438a555e5f), version(1), path(/system/lib64/extractors/libmpeg2extractor.so)
Matroska Extractor: plugin\_version(2), uuid(abbedd9238c44904a4c1b3f45f899980), version(1), path(/system/lib64/extractors/libmkvextractor.so)
Ogg Extractor: plugin\_version(2), uuid(8cc5cd06f772495e8a62cba9649374e9), version(1), path(/system/lib64/extractors/liboggextractor.so)
WAV Extractor: plugin\_version(3), uuid(7d61385858374a3884c5332d1cddee27), version(1), path(/system/lib64/extractors/libwavextractor.so)
Si tu extractor personalizado admite un formato que ya admite un extractor proporcionado por Google, puedes forzar el framework para que use tu extractor con la función Sniff()
para devolver un nivel de confianza más alto que el proporcionado por Google.
Cuando el framework de medios carga tu extractor (desde /system/lib/64/extractors
o desde un APEX del proveedor), reconoce el archivo y obtiene información sobre su contenido. El siguiente paso es agregar un decodificador para el formato, de modo que el framework pueda comprender cómo analizar el contenido del archivo.
Cómo crear un decodificador personalizado
Necesitas un decodificador personalizado para cualquier formato que no sea compatible con un decodificador proporcionado por Google. Por ejemplo:
Para agregar compatibilidad con el framework de medios para archivos AVI que contienen MP3, necesitas un extractor de AVI, pero no un decodificador de MP3 porque ya existe uno.
Para agregar compatibilidad con el framework de medios para los archivos AVI que contienen Windows Media, necesitas un extractor de AVI y un decodificador de Windows Media.
Agregar un nuevo decodificador es similar a agregar tus propios decodificadores de hardware para AVC o HEVC.
Si bien el extractor publica el tipo de MIME de los segmentos de medios que contiene, los códecs que admiten estos tipos de MIME deben estar presentes para que el archivo sea totalmente compatible. La cadena de tipo de MIME real que se usa es estrictamente un acuerdo entre el extractor y el códec (no es necesario agregar la cadena al archivo MediaDefs.h
).
Integración con el escáner de medios
El escáner multimedia busca nuevos tipos de archivos y los agrega a la base de datos multimedia.
Para que el escáner de medios controle tu tipo de archivo personalizado, debe conocerlo. En Android 10 o versiones posteriores, MimeUtils
(en libcore
) mantiene la asignación de MIME a extensión. Anteriormente, esta asignación se controlaba en el archivo MediaFile.java
, que sigue conteniendo una asignación del tipo MIME a las constantes de formato de MTP.
Un extractor puede exportar una lista de las extensiones de nombre de archivo que admite (como MP3 o MP4). Sin embargo, solo LegacyMediaScanner
usa ese valor, y no tiene efecto en ModernMediaScanner
, que se usa de forma predeterminada.