QTextToSpeech Class

Documentación de funciones miembro

[explicit] QTextToSpeech::QTextToSpeech(QObject *parent = nullptr)

Carga un motor de texto a voz de un complemento que utiliza el complemento de motor predeterminado y construye un objeto QTextToSpeech como hijo de parent.

El motor predeterminado es específico de la plataforma.

Si el motor se inicializa correctamente, entonces el state del motor cambiará a QTextToSpeech::Ready; tenga en cuenta que esto puede ocurrir de forma asíncrona. Si el plugin falla al cargarse, entonces state cambiará a QTextToSpeech::Error.

Véase también availableEngines().

[explicit] QTextToSpeech::QTextToSpeech(const QString &engine, QObject *parent = nullptr)

Carga un motor de texto a voz de un plug-in que coincida con el parámetro engine y construye un objeto QTextToSpeech como hijo de parent.

Si engine está vacío, se utiliza el plug-in de motor predeterminado. El motor predeterminado es específico de la plataforma.

Si el motor se inicializa correctamente, el state del motor se establecerá en QTextToSpeech::Ready. Si el complemento no se carga, o si el motor no se inicializa, el state del motor se establecerá en QTextToSpeech::Error.

Véase también availableEngines().

[explicit, since 6.4] QTextToSpeech::QTextToSpeech(const QString &engine, const QVariantMap &params, QObject *parent = nullptr)

Carga un motor de texto a voz desde un plug-in que coincida con el parámetro engine y construye un objeto QTextToSpeech como hijo de parent, pasando params al motor.

Si engine está vacío, se utiliza el plug-in de motor predeterminado. El motor predeterminado es específico de cada plataforma. Los pares clave/valor de params que se admiten dependen del motor. Consulte la documentación del motor para obtener más información. Las entradas no soportadas serán ignoradas.

Si el motor se inicializa correctamente, state del motor se establecerá en QTextToSpeech::Ready. Si el complemento no se carga, o si el motor no se inicializa, state del motor se establecerá en QTextToSpeech::Error.

Esta función se introdujo en Qt 6.4.

Véase también availableEngines().

[override virtual noexcept] QTextToSpeech::~QTextToSpeech()

Destruye este objeto QTextToSpeech, deteniendo cualquier discurso.

[signal, since 6.6] void QTextToSpeech::aboutToSynthesize(qsizetype id)

Esta señal se emite justo antes de que el motor comience a sintetizar el audio de voz para id. id es el valor devuelto por una llamada a enqueue(), Las aplicaciones pueden utilizar esta señal para realizar cambios de última hora en los atributos de voice, o para seguir el proceso del texto en cola a través de enqueue().

Esta función se introdujo en Qt 6.6.

Véase también enqueue(), synthesize(), y voice.

[static invokable] QStringList QTextToSpeech::availableEngines()

Obtiene la lista de plug-ins de motores de texto a voz soportados.

Véase también engine.

[invokable] QList<QLocale> QTextToSpeech::availableLocales() const

Devuelve la lista de configuraciones regionales compatibles con la página engine activa.

Véase también availableVoices() y findVoices().

[invokable] QList<QVoice> QTextToSpeech::availableVoices() const

Devuelve la lista de voces disponibles para la configuración regional actual locale.

Véase también availableLocales() y findVoices().

[slot, since 6.6] qsizetype QTextToSpeech::enqueue(const QString &utterance)

Añade utterance a la cola de textos por pronunciar y comienza a hablar. Devuelve el índice del texto en la cola, o -1 en caso de error.

Si el motor de state es actualmente Ready, utterance se hablará inmediatamente. De lo contrario, el motor comenzará a hablar utterance una vez que haya terminado de hablar el texto actual.

Cada vez que el motor pasa a la siguiente entrada de texto de la cola, se emite la señal aboutToSynthesize(). Esto permite a las aplicaciones seguir el progreso y realizar cambios de última hora en los atributos de voz.

La llamada a stop() borra la cola. Para poner en pausa el motor al final de un texto, utilice la función Utterance boundary hint.

Esta función se introdujo en Qt 6.6.

Véase también say(), stop(), aboutToSynthesize() y synthesize().

[signal] void QTextToSpeech::errorOccurred(QTextToSpeech::ErrorReason reason, const QString &errorString)

Esta señal se emite después de que se haya producido un error y el parámetro state se haya establecido en QTextToSpeech::Error. El parámetro reason especifica el tipo de error, y errorString proporciona una descripción del error legible por humanos.

QTextToSpeech::ErrorReason no es un metatipo registrado, por lo que para conexiones en cola, tendrás que registrarlo con Q_DECLARE_METATYPE() y qRegisterMetaType().

Véase también errorReason(), errorString(), y Creación de tipos Qt personalizados.

[invokable] QTextToSpeech::ErrorReason QTextToSpeech::errorReason() const

Devuelve la razón por la que el motor ha informado de un error.

Véase también state y errorOccurred().

[invokable] QString QTextToSpeech::errorString() const

Devuelve el mensaje de error actual del motor.

Véase también errorOccurred().

[since 6.6] template <typename... Args> QList<QVoice> QTextToSpeech::findVoices(Args &&... args) const

Devuelve la lista de voces que coinciden con los criterios de args.

Los argumentos de args se procesan para confeccionar la lista de voces que coinciden con todos ellos. Un argumento de tipo QString se compara con el name, de la voz, un argumento de tipo QLocale se compara con el locale, de la voz, etc. Es posible especificar sólo el Language o Territory de las voces deseadas, y el nombre puede compararse con un regular expression.

Esta función devuelve todas las voces si la lista de criterios está vacía. No es posible utilizar varios criterios del mismo tipo, lo que provocará un error de compilación.

Esta función se introdujo en Qt 6.6.

Véase también availableVoices().

[slot] void QTextToSpeech::pause(QTextToSpeech::BoundaryHint boundaryHint = QTextToSpeech::BoundaryHint::Default)

Pausa el discurso actual en boundaryHint.

El respeto de boundaryHint depende de engine.

Véase también resume() y PauseResume.

[slot] void QTextToSpeech::resume()

Reanudar el habla después de llamar a pause().

Véase también pause().

[slot] void QTextToSpeech::say(const QString &text)

Inicia el habla en text.

Esta función comienza a sintetizar el habla de forma asíncrona y lee el texto en el dispositivo de salida de audio predeterminado.

    connect(ui.speakButton, &QPushButton::clicked, m_speech, [this]{
        m_speech->say(ui.plainTextEdit->toPlainText());
    });

El estado actual está disponible utilizando la propiedad state, y se establece en Speaking una vez que comienza la lectura. Cuando finalice la lectura, state se establecerá en Ready.

Véase también enqueue(), stop(), pause(), resume(), y synthesize().

[signal, since 6.6] void QTextToSpeech::sayingWord(const QString &word, qsizetype id, qsizetype start, qsizetype length)

Esta señal se emite cuando el word, que es el fragmento de texto indicado por start y length en el enunciado id, se reproduce en el dispositivo de audio.

Esta función se introdujo en Qt 6.6.

Véase también Capability y say().

[invokable, since 6.4] bool QTextToSpeech::setEngine(const QString &engine, const QVariantMap &params = QVariantMap())

Establece el motor utilizado por este objeto QTextToSpeech a engine, pasando params al constructor del motor.

Devuelve si engine pudo ser configurado con éxito.

Los pares clave/valor soportados en params dependen del motor. Consulte la documentación del motor para más detalles. Las entradas no soportadas serán ignoradas.

Esta función se introdujo en Qt 6.4.

Véase también engine().

[slot] void QTextToSpeech::stop(QTextToSpeech::BoundaryHint boundaryHint = QTextToSpeech::BoundaryHint::Default)

Detiene la lectura en curso en boundaryHint, y borra la cola de textos pendientes.

La lectura no puede reanudarse. El respeto de boundaryHint depende del motor.

Véase también say(), enqueue() y pause().

Sintetiza la text en datos de audio sin procesar.

Esta función sintetiza el habla de forma asíncrona en datos de audio sin procesar. Cuando haya datos disponibles, se llamará a functor como functor(QAudioFormat format, QByteArray bytes), con format describiendo la format de los datos en bytes; o como functor(QAudioBuffer &buffer).

La propiedad state se establece en Synthesizing cuando comienza la síntesis, y en Ready una vez finalizada. Durante la síntesis, el functor puede ser llamado varias veces, posiblemente con valores cambiantes para format.

El functor puede ser un callable, como una función lambda o free, con un objeto context opcional:

tts.synthesize("Hello world", [](const QAudioFormat &format, const QByteArray &bytes){
    // process data according to format
});

o una función miembro del objeto context:

struct PCMProcessor : QObject
{
    void processData(const QAudioFormat &format, const QByteArray &bytes)
    {
        // process data according to format
    }
} processor;
tts.synthesize("Hello world", &processor, &PCMProcessor::processData);

Si context es destruido, entonces functor ya no será llamado.

Estas funciones se introdujeron en Qt 6.6.

Véase también say() y stop().