En esta página

Qt TextToSpeech Los motores

Qt TextToSpeech admite varias implementaciones de motores para distintas plataformas, cada una con diferentes compensaciones entre capacidades, disponibilidad y coste de ejecución.

Se puede seleccionar un motor al crear una instancia de ` QTextToSpeech `, o en un objeto ya instanciado estableciendo la propiedad ` engine `. Si no se especifica ningún motor, se utilizará el motor preferido para la plataforma actual. Llama a availableEngines() para obtener la lista de motores que se pueden utilizar en el sistema actual. Esta incluirá un motor «simulado» que se utiliza para pruebas y que no debe implementarse en los sistemas de destino.

Al configurar el motor, las aplicaciones pueden pasarle un objeto ` QVariantMap ` con pares clave/valor de parámetros específicos del motor. En las secciones siguientes se enumeran los parámetros de configuración admitidos para cada motor. Los parámetros que no sean compatibles con el motor se ignorarán sin aviso.

WinRT

El motor «winrt» utiliza las API del espacio de nombres Windows.Media.SpeechSynthesis. Requiere un SDK de Windows reciente y no está disponible cuando se utiliza el compilador MinGW. El motor proporciona acceso a todas las voces disponibles para su instalación en las versiones actuales de Windows.

La implementación utiliza QAudioSink de Qt Multimedia para reproducir el flujo de datos PCM generado por el sintetizador en un dispositivo de audio.

NombreTipoObservaciones
audioDeviceQAudioDevice

SAPI

El motor «sapi» utiliza el marco SAPI 5.3 incluido en el SDK de Windows. Ofrece una selección limitada de voces, con una calidad inferior en comparación con el motor «winrt».

El motor SAPI no admite ningún parámetro específico del motor.

Darwin

El motor «darwin» utiliza el marco AVFoundation, disponible en dispositivos iOS y en macOS 10.15. La documentación del marco indica que también es compatible con macOS 10.14, pero, de forma predeterminada, no hay voces disponibles en esa plataforma.

El motor Darwin no admite ningún parámetro específico del motor.

Android

El motor «android» es el único disponible en la plataforma Android. Utiliza el paquete TextToSpeech, que a su vez admite múltiples motores en segundo plano.

Nota: El motor «android» no dispone de la función « PauseResume ».

NombreTipoObservaciones
androidEngineQStringNo existe ninguna API en Qt para obtener la lista de motores instalados.

HarmonyOS

El motor de HarmonyOS utiliza las API de conversión de texto a voz de Core Speech Kit. El motor del sistema sintetiza y reproduce la voz.

El motor Core Speech Kit se crea para un idioma fijo, que el complemento establece en « zh-CN ». Tal y como se indica en la documentación de createEngine(), solo se admiten el chino y el inglés, recomendándose « zh-CN » para el chino y « en-US » para el inglés.

Nota: El motor de HarmonyOS solo admite la capacidad Speak. No es compatible con PauseResume, WordByWordProgress ni Synthesize.

Flite

El motor «flite» utiliza el sintetizador flite. Su reducido tamaño lo hace especialmente útil para entornos embebidos. El complemento requiere como mínimo Flite 2.2 y utiliza « QAudioSink » de Qt Multimedia para reproducir el flujo de datos PCM generado.

El complemento del motor busca bibliotecas de voces en los directorios indicados en la variable de entorno LD_LIBRARY_PATH y, en su defecto, recurre a ubicaciones habituales de bibliotecas como /usr/lib, /usr/lib64 y /usr/lib/x86_64-linux-gnu.

Si se utiliza Flite como biblioteca estática, las bibliotecas de voz deseadas también deben enlazarse estáticamente al complemento del motor. Actualmente no hay ninguna API del sistema de compilación implementada para seleccionar dichas bibliotecas de voz al configurar Qt.

NombreTipoObservaciones
audioDeviceQAudioDevice

speech-dispatcher

El motor «speechd» se comunica con el demonio speech-dispatcher y requiere, como mínimo, libspeechd 0.9.

Nota: El motor speech-dispatcher no dispone de las capacidades « WordByWordProgress » ni « Synthesize ».

El motor «speech-dispatcher» no admite ningún parámetro específico del motor.

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