Bibliotecas stub de FFmpeg en Linux y Android
Descripción general
Para permitir el enlace dinámico de FFmpeg de conformidad con la licencia LGPL, Qt Multimedia utiliza bibliotecas stub para gestionar las dependencias externas opcionales en las plataformas Linux y Android.
En estas plataformas, FFmpeg puede requerir bibliotecas compartidas adicionales que no se incluyen con Qt:
- OpenSSL: necesario para la transmisión segura por red.
- VAAPI (solo en Linux): permite la decodificación y codificación de vídeo aceleradas por hardware.
A menudo, estas bibliotecas no están disponibles o no pueden incluirse debido a restricciones de licencia. Para garantizar que las funciones basadas en FFmpeg sigan siendo operativas (excluyendo las partes no compatibles), Qt proporciona bibliotecas de relleno como alternativa.
Por qué se necesitan los stubs
Si estas dependencias no están presentes en tiempo de ejecución, FFmpeg no se cargará o no funcionará correctamente. El mecanismo de bibliotecas «stub» permite:
- La carga correcta de FFmpeg incluso cuando faltan OpenSSL o VAAPI.
- Una degradación gradual de la funcionalidad (por ejemplo, la ausencia de VAAPI implica que no hay aceleración por hardware, pero la reproducción sigue funcionando).
- A los usuarios a optar por utilizar sus propias versiones de estas bibliotecas proporcionadas por el sistema, si están disponibles.
Qué son los stubs
Las bibliotecas «stub» imitan las interfaces de las bibliotecas reales (p. ej., libssl.so, libva.so), pero no implementan toda la funcionalidad. En su lugar:
- Proporcionan implementaciones ficticias que devuelven valores de reserva seguros u operaciones nulas.
- Intentan resolver dinámicamente los símbolos reales a través de
QLibrary::load/QLibrary::resolve. - Fallen de forma controlada si no se encuentran las bibliotecas reales.
Qt incluye estos stubs con los siguientes nombres:
libQt6FFmpegStub-ssl.so.xlibQt6FFmpegStub-crypto.so.xlibQt6FFmpegStub-va.so.xlibQt6FFmpegStub-va-drm.so.xlibQt6FFmpegStub-va-x11.so.x- (pueden añadirse más en el futuro)
Cómo funcionan los stubs en Qt
Cuando FFmpeg se enlaza dinámicamente:
- Normalmente espera vincularse con bibliotecas del sistema como
libssl.so.3olibva.so.2. - Qt modifica los binarios de FFmpeg utilizando la herramienta
patchelfpara sustituir estas dependencias reales por equivalentes ficticios.
Ejemplo:
# Original linkage
libffmpegmediaplugin.so: needs libavcodec.so (depends on the FFmpeg libs)
libavcodec.so: needs libssl.so.3
# After patching
libffmpegmediaplugin.so: needs libavcodec.so (no changes)
libavcodec.so: needs libQt6FFmpegStub-ssl.so.3
libQt6FFmpegStub-ssl.so.3: optionally needs libssl.so.3 (no explicit linkage)Este parcheo se realiza automáticamente como parte del proceso de compilación y distribución.
Comportamiento en tiempo de ejecución y notas de seguridad
- Los complementos de FFmpeg se cargan con
dlopen(..., RTLD_LOCAL), por lo que los símbolos ficticios no se filtran a la tabla de símbolos global. - Si la aplicación ya utiliza OpenSSL o VAAPI, las bibliotecas del sistema pueden obtenerse del ámbito global y deben ser compatibles a nivel binario.
- Los binarios de QtMultimedia y FFmpeg incluidos son compatibles con:
- OpenSSL 3.x.x (con versionado de símbolos
@OPENSSL_3.0.0) - VAAPI ABI 0.33 (la versión anterior, ABI 0.32, no es compatible de forma explícita)
- OpenSSL 3.x.x (con versionado de símbolos
Para eliminar por completo el uso de bibliotecas de relleno, hay dos opciones:
- Utilizar
patchelfpara restablecer las dependencias de FFmpeg a las bibliotecas del sistema (por ejemplo, sustituirlibQt6FFmpegStub-ssl.so.3porlibssl.so.3). Esto debe hacerse para todas las bibliotecas de FFmpeg:libavcodec,libavformat,libavutil,libswresampleylibswscale. - Sustituye las bibliotecas FFmpeg incluidas por otras compiladas manualmente por el usuario. Consulta «Compilar FFmpeg desde el código fuente».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.