Reproductor multimedia
Reproducción de audio y vídeo con Qt Quick.

Este ejemplo muestra una aplicación QML capaz de reproducir archivos de audio y vídeo utilizando diversos códecs.
Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecuta el comando « Qt: Open Qt examples » desde Command Palette y selecciona el ejemplo de la lista. Para obtener más información, consulta Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Estructura del proyecto

La arquitectura de esta aplicación se compone de tres módulos QML personalizados:
MediaControlMediaPlayerConfig
Esto también se refleja en el archivo ` CMakeLists.txt ` de nivel superior:
add_subdirectory(MediaPlayer)
target_link_libraries(MediaPlayerApp PRIVATE
Qt6::Core
Qt6::Svg
Qt6::Quick
Qt6::Multimedia
MediaControlsplugin
MediaPlayerplugin
ConfigpluginCada módulo QML se crea utilizando la macro ` qt_add_qml_module `; por ejemplo, vea cómo se crea el módulo `Config`.
qt_add_library(Config STATIC)
set_source_files_properties(Config.qml
PROPERTIES
QT_QML_SINGLETON_TYPE true
)
qt_add_qml_module(Config
URI "Config"
OUTPUT_DIRECTORY Config
QML_FILES
"Config.qml"
)Qt Quick Aplicación
En esencia, se trata de una aplicación QML; consulta «Introducción a la programación con Qt Quick: una aplicación de alarma » para obtener información específica al respecto. Esta documentación se centra en cómo este ejemplo utiliza el Qt Multimedia QML Types.
El módulo QML «Config» personalizado
Este tipo controla los temas y los diseños de una aplicación, en función del sistema operativo de destino.
En primer lugar, lo declaramos como un singleton, ya que solo necesitamos que se instancie una vez y crear copias supondría un desperdicio de recursos.
Para ello, añadimos lo siguiente al principio de Config.qml
pragma SingletonA continuación, creamos un archivo qmldir en el directorio Config con el nombre qmldir que contiene lo siguiente:
module Config
singleton Config 1.0 Config.qmlAhora, para utilizarlo en nuestra aplicación, fíjate en cómo se hace referencia a él en el archivo Main.qml de MediaPlayer:
color: Config.mainColorEl módulo QML personalizado «MediaControls»
Este módulo contiene todos los tipos utilizados para definir los controles de la aplicación, entre los que se incluyen:

- AudioControl.qml
- ControlImages.qml
- CustomButton.qml
- CustomRadioButton.qml
- CustomSlider.qml
- ControlDeReproducción.qml
- ControlDeVelocidadDeReproducción.qml
- Control de búsqueda de reproducción.qml
Consulta el archivo de definición de cada tipo específico para obtener más detalles sobre cómo se implementan estos controles. Son una evolución de los controles del ejemplo de reproductor multimedia de QML.
El módulo QML personalizado « MediaPlayer »
Este módulo contiene el archivo Main.qml, en el que se declaran la mayoría de los tipos de nivel superior de la aplicación y, lo que es más importante, los tipos QML Qt Multimedia, MediaPlayer y VideoOutput.
MediaPlayer {
id: mediaPlayer
playbackRate: playbackControl.playbackRate
videoOutput: videoOutput
audioOutput: AudioOutput {
id: audio
volume: playbackControl.volume
}
source: new URL("https://download.qt.io/learning/videos/media-player-example/Qt_LogoMergeEffect.mp4")
function updateMetadata() {
root.metadataInfo.clear()
root.metadataInfo.read(mediaPlayer.metaData)
}
onMetaDataChanged: updateMetadata()
onActiveTracksChanged: updateMetadata()
onErrorOccurred: {
errorPopup.errorMsg = mediaPlayer.errorString
errorPopup.open()
}
onTracksChanged: {
settingsInfo.tracksInfo.selectedAudioTrack = mediaPlayer.activeAudioTrack
settingsInfo.tracksInfo.selectedVideoTrack = mediaPlayer.activeVideoTrack
settingsInfo.tracksInfo.selectedSubtitleTrack = mediaPlayer.activeSubtitleTrack
updateMetadata()
}
onMediaStatusChanged: {
if ((MediaPlayer.EndOfMedia === mediaStatus && mediaPlayer.loops !== MediaPlayer.Infinite) &&
((root.currentFile < playlistInfo.mediaCount - 1) || playlistInfo.isShuffled)) {
if (!playlistInfo.isShuffled) {
++root.currentFile
}
root.playMedia()
} else if (MediaPlayer.EndOfMedia === mediaStatus && root.playlistLooped && playlistInfo.mediaCount) {
root.currentFile = 0
root.playMedia()
}
}
}
VideoOutput {
id: videoOutput
anchors.top: fullScreen || Config.isMobileTarget ? parent.top : menuBar.bottom
anchors.bottom: fullScreen ? parent.bottom : playbackControl.top
anchors.left: parent.left
anchors.right: parent.right
anchors.leftMargin: fullScreen ? 0 : 20
anchors.rightMargin: fullScreen ? 0 : 20
visible: mediaPlayer.hasVideo
property bool fullScreen: false
TapHandler {
onDoubleTapped: {
if (parent.fullScreen) {
root.showNormal()
} else {
root.showFullScreen()
}
parent.fullScreen = !parent.fullScreen
}
onTapped: {
root.closeOverlays()
}
}
}El módulo contiene los demás tipos personalizados que se utilizan para recuperar y mostrar información de los archivos, así como para llamar al selector de archivos.
- ErrorPopup.qml
- Images.qml
- MetadataInfo.qml
- PlayerMenuBar.qml
- PlaylistInfo.qml
- Información de configuración.qml
- Información sobre el tema.qml
- Menú táctil.qml
- Información de pistas.qml
- Opciones de pistas.qml
- UrlPopup.qml
Consulta el archivo de definición de cada tipo específico para obtener más detalles sobre cómo se implementan los tipos. Algunos son una evolución de los que se encuentran en el ejemplo del reproductor multimedia QML.
Nuevas funcionalidades
Esta aplicación de ejemplo cuenta con algunas funcionalidades nuevas implementadas mediante tipos, como PlaylistInfo y ThemeInfo. Consulte los respectivos archivos .qml para obtener más detalles sobre cómo se implementan.
Archivos fuente
Véase también Todos los ejemplos de Qt XML, Ejemplos y tutoriales de «Qt Quick » y Ejemplos de «Qt Multimedia ».
© 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.