QTextToSpeech Class

Fonction membre Documentation

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

Charge un moteur de synthèse vocale à partir d'un plug-in qui utilise le moteur par défaut et construit un objet QTextToSpeech en tant qu'enfant de parent.

Le moteur par défaut est spécifique à la plate-forme.

Si le moteur s'initialise correctement, l'adresse state du moteur devient QTextToSpeech::Ready; notez que cela peut se produire de manière asynchrone. Si le plugin ne parvient pas à se charger, alors state sera remplacé par QTextToSpeech::Error.

Voir aussi availableEngines().

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

Charge un moteur de synthèse vocale à partir d'un plug-in correspondant au paramètre engine et construit un objet QTextToSpeech en tant qu'enfant de parent.

Si engine est vide, le moteur par défaut du plug-in est utilisé. Le moteur par défaut est spécifique à la plate-forme.

Si le moteur s'initialise correctement, l'adresse state du moteur sera fixée à QTextToSpeech::Ready. Si le plugin ne se charge pas ou si le moteur ne s'initialise pas, l'adresse state du moteur sera fixée à QTextToSpeech::Error.

Voir aussi availableEngines().

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

Charge un moteur de synthèse vocale à partir d'un plug-in correspondant au paramètre engine et construit un objet QTextToSpeech en tant qu'enfant de parent, en transmettant params au moteur.

Si engine est vide, le moteur par défaut est utilisé. Le moteur par défaut est spécifique à la plate-forme. Les paires clé/valeur de params qui sont prises en charge dépendent du moteur. Voir la documentation du moteur pour plus de détails. Les entrées non prises en charge sont ignorées.

Si le moteur s'initialise correctement, la valeur state du moteur est fixée à QTextToSpeech::Ready. Si le plugin ne se charge pas ou si le moteur ne s'initialise pas, la valeur state du moteur est fixée à QTextToSpeech::Error.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi availableEngines().

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

Détruit l'objet QTextToSpeech, interrompant toute parole.

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

Ce signal est émis juste avant que le moteur ne commence à synthétiser le son de la parole pour id. id est la valeur renvoyée par un appel à enqueue(). Les applications peuvent utiliser ce signal pour apporter des modifications de dernière minute aux attributs de voice, ou pour suivre le processus du texte mis en file d'attente via enqueue().

Cette fonction a été introduite dans Qt 6.6.

Voir également enqueue(), synthesize() et voice.

[static invokable] QStringList QTextToSpeech::availableEngines()

Obtient la liste des modules d'extension de moteur de synthèse vocale pris en charge.

Voir également engine.

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

Renvoie la liste des locales prises en charge par le site engine actif.

Voir également availableVoices() et findVoices().

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

Renvoie la liste des voix disponibles pour la langue actuelle locale.

Voir également availableLocales() et findVoices().

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

Ajoute utterance à la file d'attente des textes à prononcer, et commence à prononcer. Renvoie l'index du texte dans la file d'attente, ou -1 en cas d'erreur.

Si l'adresse state du moteur est actuellement Ready, utterance sera prononcé immédiatement. Sinon, le moteur commencera à prononcer utterance une fois qu'il aura fini de prononcer le texte en cours.

Chaque fois que le moteur passe à l'entrée de texte suivante dans la file d'attente, le signal aboutToSynthesize() est émis. Cela permet aux applications de suivre la progression et d'apporter des modifications de dernière minute aux attributs vocaux.

L'appel à stop() efface la file d'attente. Pour mettre le moteur en pause à la fin d'un texte, utilisez l'indice de limite Utterance.

Cette fonction a été introduite dans Qt 6.6.

Voir aussi say(), stop(), aboutToSynthesize() et synthesize().

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

Ce signal est émis lorsqu'une erreur s'est produite et que le paramètre state a été défini sur QTextToSpeech::Error. Le paramètre reason spécifie le type d'erreur et le paramètre errorString fournit une description de l'erreur lisible par l'homme.

QTextToSpeech::ErrorReason n'est pas un métatype enregistré, donc pour les connexions en file d'attente, vous devrez l'enregistrer avec Q_DECLARE_METATYPE() et qRegisterMetaType().

Voir aussi errorReason(), errorString(), et Créer des types Qt personnalisés.

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

Renvoie la raison pour laquelle le moteur a signalé une erreur.

Voir également state et errorOccurred().

[invokable] QString QTextToSpeech::errorString() const

Renvoie le message d'erreur actuel du moteur.

Voir également errorOccurred().

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

Renvoie la liste des voix qui correspondent aux critères de args.

Les arguments de args sont traités afin d'assembler la liste des voix qui correspondent à tous les arguments. Un argument de type QString est confronté au name de la voix, un argument de type QLocale est confronté au locale de la voix, etc. Il est possible de ne spécifier que les Language ou Territory des voix souhaitées, et le nom peut être comparé à un regular expression.

Cette fonction renvoie toutes les voix si la liste des critères est vide. Il n'est pas possible d'utiliser plusieurs critères du même type, ce qui entraînera une erreur de compilation.

Cette fonction a été introduite dans Qt 6.6.

Voir aussi availableVoices().

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

Interrompt le discours en cours à l'adresse boundaryHint.

Le respect de boundaryHint dépend de engine.

Voir également resume() et PauseResume.

[slot] void QTextToSpeech::resume()

Reprendre la parole après l'appel de pause().

Voir également pause().

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

Commence à prononcer le texte text.

Cette fonction commence à synthétiser la parole de manière asynchrone et lit le texte sur le périphérique de sortie audio par défaut.

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

L'état actuel est disponible à l'aide de la propriété state et prend la valeur Speaking lorsque la lecture commence. Lorsque la lecture est terminée, state est remplacé par Ready.

Voir aussi enqueue(), stop(), pause(), resume() et synthesize().

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

Ce signal est émis lorsque la tranche de texte word, indiquée par start et length dans l'énoncé id, est jouée sur le périphérique audio.

Cette fonction a été introduite dans Qt 6.6.

Voir aussi Capability et say().

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

Définit le moteur utilisé par cet objet QTextToSpeech à engine, en passant params au constructeur du moteur.

Retourne si engine a pu être défini avec succès.

Les paires clé/valeur prises en charge dans params dépendent du moteur. Voir la documentation du moteur pour plus de détails. Les entrées non prises en charge seront ignorées.

Cette fonction a été introduite dans Qt 6.4.

Voir également engine().

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

Arrête la lecture en cours à l'adresse boundaryHint, et vide la file d'attente des textes en attente.

La lecture ne peut pas être reprise. Le respect de boundaryHint dépend du moteur.

Voir aussi say(), enqueue() et pause().

Synthétise le site text en données audio brutes.

Cette fonction synthétise la parole de manière asynchrone en données audio brutes. Lorsque les données sont disponibles, la fonction functor sera appelée en tant que functor(QAudioFormat format, QByteArray bytes), avec format décrivant la format des données dans bytes; ou en tant que functor(QAudioBuffer &buffer).

La propriété state est définie sur Synthesizing lorsque la synthèse commence, et sur Ready lorsque la synthèse est terminée. Au cours de la synthèse, la propriété functor peut être appelée plusieurs fois, éventuellement avec des valeurs changeantes pour format.

Le functor peut être un appelable, comme une fonction lambda ou libre, avec un objet context optionnel :

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

ou une fonction membre de l'objet 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 est détruit, la fonction functor ne sera plus appelée.

Ces fonctions ont été introduites dans Qt 6.6.

Voir aussi say() et stop().