En esta página

Ejemplo de Quick Speech

El ejemplo «Quick Speech» lee en voz alta el texto proporcionado por el usuario.

Captura de pantalla en la que se muestra una herramienta de conversión de texto a voz con opciones para cambiar el motor, la configuración regional, la voz, el volumen, el tono y la velocidad.

El ejemplo «Quick Speech » muestra cómo se puede utilizar el tipo « TextToSpeech » en una Qt Quick aplicación para leer texto en voz alta y controlar la reproducción.

El ejemplo utiliza controles de «Qt Quick » para ajustar el tono, el volumen y la velocidad de la voz. También permite al usuario seleccionar un motor, un idioma y una voz.

Inicialización de un objeto TextToSpeech

En primer lugar, inicializamos el objeto de conversión de texto a voz tts:

    TextToSpeech {
        id: tts
        volume: volumeSlider.value
        pitch: pitchSlider.value
        rate: rateSlider.value

Obtención del estado

Se utilizan casos «switch» para actualizar la etiqueta « statusLabel » en el pie de página.

        onStateChanged: updateStateLabel(state)

        function updateStateLabel(state)
        {
            switch (state) {
                case TextToSpeech.Ready:
                    statusLabel.text = qsTr("Ready")
                    break
                case TextToSpeech.Speaking:
                    statusLabel.text = qsTr("Speaking")
                    break
                case TextToSpeech.Paused:
                    statusLabel.text = qsTr("Paused...")
                    break
                case TextToSpeech.Error:
                    statusLabel.text = qsTr("Error!")
                    break
            }
        }

Resaltar las palabras a medida que se pronuncian

Se utiliza el TextArea input para obtener el texto que se va a introducir y la señal onSayingWord como disparador, así como para conocer la posición en la que resaltar las palabras a medida que se pronuncian.

        onSayingWord: (word, id, start, length)=> {
            input.select(start, start + length)
        }

El TextArea input se declara aquí:

    ColumnLayout {
        anchors.fill: parent
        anchors.margins: 8
        id: inputForm

        TextArea {
            id: input
            wrapMode: TextEdit.WordWrap
            text: qsTr("Hello, world!")
            Layout.fillWidth: true
            Layout.minimumHeight: implicitHeight
            font.pointSize: 24
        }

Control de la voz

Button se organizan mediante un RowLayout y se configuran para controlar el TextToSpeech tts .

El botón «speak»

Se crea un « Button » con la etiqueta «Speak». Se activa si la propiedad de estado de « tts » es « Paused » o « Ready ». Al hacer clic en el botón, se recuperan las voces disponibles en los dispositivos de destino y se establece « tts.voice » en la voz seleccionada actualmente de « voicesComboBox ». A continuación, se llama a « TextToSpeech::say()» y se le pasa el texto de « inputbox ».

        RowLayout {
            Button {
                text: qsTr("Speak")
                enabled: [TextToSpeech.Paused, TextToSpeech.Ready].includes(tts.state)
                onClicked: {
                    let voices = tts.availableVoices()
                    tts.voice = voices[voicesComboBox.currentIndex]
                    tts.say(input.text)
                }
            }

Los botones de pausa, reanudación y parada

Estos botones tienen una implementación similar a la del botón « Speak »:

            Button {
                text: qsTr("Pause")
                enabled: tts.state == TextToSpeech.Speaking
                onClicked: tts.pause()
                visible: tts.engineCapabilities & TextToSpeech.Capabilities.PauseResume
            }
            Button {
                text: qsTr("Resume")
                enabled: tts.state == TextToSpeech.Paused
                onClicked: tts.resume()
                visible: tts.engineCapabilities & TextToSpeech.Capabilities.PauseResume
            }
            Button {
                text: qsTr("Stop")
                enabled: [TextToSpeech.Speaking, TextToSpeech.Paused].includes(tts.state)
                onClicked: tts.stop()
            }

Selección de opciones de conversión de texto a voz

Se utiliza un GridLayout para organizar los controles y las etiquetas que permiten seleccionar las opciones de motor, configuración regional, voz, volumen, tono y velocidad para la síntesis de texto a voz.

Selección del motor, la configuración regional y la voz

Se utiliza un grupo de componentes « ComboBox » para seleccionar estos parámetros.

Para el ComboBox de selección del motor, se utiliza « tts.availableEngines() » como modelo.

onActivated se activa asignando a tts.engine el texto actual en el índice actual del ComboBox.

            Label {
                text: qsTr("Engine:")
            }
            ComboBox {
                id: enginesComboBox
                Layout.fillWidth: true
                model: tts.availableEngines()
                onActivated: {
                    tts.engine = textAt(currentIndex)
                    updateLocales()
                    updateVoices()
                }
            }

Las dos últimas líneas del fragmento de código anterior muestran que las configuraciones regionales y las voces disponibles también se actualizan en este punto, ya que dependen del motor seleccionado. Estas funciones se tratan en una sección posterior.

localesComboBox se implementa de la misma forma que engineComboBox, pero sin actualizar los motores disponibles.

            Label {
                text: qsTr("Locale:")
            }
            ComboBox {
                id: localesComboBox
                Layout.fillWidth: true
                onActivated: {
                    let locales = tts.availableLocales()
                    tts.locale = locales[currentIndex]
                    updateVoices()
                }
            }
            Label {
                text: qsTr("Voice:")
            }
            ComboBox {
                id: voicesComboBox
                Layout.fillWidth: true
            }
Selección del volumen, el tono y la velocidad

Estos controles se implementan con ` Sliders ` de la siguiente manera:

            Label {
                text: qsTr("Volume:")
            }
            Slider {
                id: volumeSlider
                from: 0
                to: 1.0
                stepSize: 0.2
                value: 0.8
                Layout.fillWidth: true
            }
            Label {
                text: qsTr("Pitch:")
            }
            Slider {
                id: pitchSlider
                from: -1.0
                to: 1.0
                stepSize: 0.5
                value: 0
                Layout.fillWidth: true
            }
            Label {
                text: qsTr("Rate:")
            }
            Slider {
                id: rateSlider
                from: -1.0
                to: 1.0
                stepSize: 0.5
                value: 0
                Layout.fillWidth: true
            }
        }
    }

Actualización de las opciones disponibles

Mediante el uso de la señal « Component.onCompleted », se lleva a cabo lo siguiente una vez que se ha instanciado el « ApplicationWindow » raíz.

  • El índice de « enginesComboBox » se establece en el motor de « tts » seleccionado actualmente.
  • Se actualizan las configuraciones regionales y las voces disponibles.
  • Se notifica el estado actual de ` tts `.
    Component.onCompleted: {
        enginesComboBox.currentIndex = tts.availableEngines().indexOf(tts.engine)
        // some engines initialize asynchronously
        if (tts.state == TextToSpeech.Ready) {
            engineReady()

Las funciones updateLocales() y updateVoice(), utilizadas en toda la aplicación, se implementan de la siguiente manera:

        } else {
            tts.stateChanged.connect(root.engineReady)
        }

        tts.updateStateLabel(tts.state)
    }

    function engineReady() {
        tts.stateChanged.disconnect(root.engineReady)
        if (tts.state != TextToSpeech.Ready) {
            tts.updateStateLabel(tts.state)
            return;
        }
        updateLocales()
        updateVoices()
    }

    function updateLocales() {
        let allLocales = tts.availableLocales().map((locale) => locale.nativeLanguageName)
        let currentLocaleIndex = allLocales.indexOf(tts.locale.nativeLanguageName)
        localesComboBox.model = allLocales
        localesComboBox.currentIndex = currentLocaleIndex
    }

    function updateVoices() {
        voicesComboBox.model = tts.availableVoices().map((voice) => voice.name)
        let indexOfVoice = tts.availableVoices().indexOf(tts.voice)
        voicesComboBox.currentIndex = indexOfVoice

Ejecución del ejemplo

Puede ejecutar el ejemplo desde:

Proyecto de ejemplo en code.qt.io

© 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.