En esta página

Cambios en Qt TextToSpeech

Qt 6 son el resultado de un esfuerzo deliberado por hacer que el marco sea más eficiente y fácil de usar.

Intentamos mantener la compatibilidad binaria y de código fuente para todas las API públicas en cada versión. Sin embargo, algunos cambios eran inevitables con el fin de mejorar Qt como marco de trabajo.

En este tema resumimos dichos cambios Qt TextToSpeechy ofrecemos orientación para gestionarlos.

Motores disponibles

Todos los motores que estaban disponibles en Qt 5 también lo están en Qt 6.4. Para obtener una lista completa de los motores disponibles en Qt 6.4, consulta «Qt TextToSpeech Engines».

Los motores ahora pueden recibir parámetros de configuración adicionales. Al crear una instancia de ` QTextToSpeech `, pasa un objeto ` QVariantMap ` con pares clave/valor específicos del motor.

Cambios en la API

El Qt TextToSpeech módulo ha sido objeto de una consolidación y limpieza básicas. El esfuerzo de portabilidad para poder cambiar a Qt 6 debería ser mínimo.

La clase QTextToSpeech

El valor de la enumeración ` QTextToSpeech::State ` ` BackendError ` ha pasado a llamarse ` Error`. Se puede obtener información detallada sobre los errores mediante ` QTextToSpeech::errorReason()` y ` QTextToSpeech::errorString()`.

La nueva propiedad « engine » permite cambiar el motor en un objeto « QTextToSpeech » ya inicializado.

Las ranuras ` pause ` y ` QTextToSpeech::stop ` admiten un valor de la enumeración ` QTextToSpeech::BoundaryHint `. Esto provocará un error de compilación en las conexiones de señal/ranura que utilicen la sintaxis PMF si la señal tiene parámetros que antes se ignoraban:

connect(stopButton, &QPushButton, tts, &QTextToSpeech::stop);

O bien conéctate a una señal sin parámetros, o bien utiliza una lambda y llama explícitamente al método de slot correspondiente:

connect(stopButton, &QPushButton, tts, [tts]{ tts->stop(); });

La clase QVoice

El código existente que utiliza la clase ` QVoice ` sigue funcionando como antes. Los objetos ` QVoice ` ahora se pueden serializar mediante ` QDataStream`.

Las clases QTextToSpeechEngine y QTextToSpeechPlugin

Estas clases se han eliminado de la API pública. Siguen existiendo y son utilizadas por las implementaciones de motores disponibles, pero no forman parte de la API documentada y soportada, y es probable que cambien en futuras versiones.

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