En esta página

Reproductor multimedia

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

Aplicación multimedia para reproducir audio

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:

Estructura del proyecto

Estructura de un proyecto de Qt Creator con los módulos Config, MediaControls y MediaPlayer

La arquitectura de esta aplicación se compone de tres módulos QML personalizados:

  • MediaControl
  • MediaPlayer
  • Config

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
    Configplugin

Cada 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 Singleton

A 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.qml

Ahora, 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.mainColor

El 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:

Controles del reproductor multimedia con barra de progreso, botón de reproducción y control deslizante de volumen

  • 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

Proyecto de ejemplo en code.qt.io

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.