QTextToSpeech Class

Dokumentation der Mitgliedsfunktionen

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

Lädt eine Text-to-Speech-Engine aus einem Plug-in, das das Standard-Engine-Plug-in verwendet, und erstellt ein `QTextToSpeech`-Objekt als untergeordnetes Objekt von ` parent`.

Die Standard-Engine ist plattformspezifisch.

Wenn die Engine korrekt initialisiert wird, ändert sich der Wert von ` state ` der Engine auf ` QTextToSpeech::Ready`; beachten Sie, dass dies asynchron geschehen kann. Wenn das Laden des Plug-ins fehlschlägt, wird ` state ` auf ` QTextToSpeech::Error` gesetzt.

Siehe auch availableEngines().

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

Lädt eine Text-to-Speech-Engine aus einem Plug-in, das dem Parameter „ engine “ entspricht, und erstellt ein QTextToSpeech-Objekt als untergeordnetes Element von „ parent “.

Ist „ engine “ leer, wird das Standard-Engine-Plugin verwendet. Die Standard-Engine ist plattformspezifisch.

Wenn die Engine korrekt initialisiert wird, wird der Parameter ` state ` der Engine auf ` QTextToSpeech::Ready` gesetzt. Wenn das Laden des Plug-ins fehlschlägt oder die Engine nicht initialisiert werden kann, wird der Parameter ` state ` der Engine auf ` QTextToSpeech::Error` gesetzt.

Siehe auch availableEngines().

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

Lädt eine Text-to-Speech-Engine aus einem Plug-in, das dem Parameter „ engine “ entspricht, und erstellt ein „QTextToSpeech“-Objekt als untergeordnetes Element von „ parent “, wobei „ params “ an die Engine weitergeleitet wird.

Ist ` engine ` leer, wird das Standard-Engine-Plug-in verwendet. Die Standard-Engine ist plattformspezifisch. Welche Schlüssel-Wert-Paare in ` params ` unterstützt werden, hängt von der Engine ab. Einzelheiten finden Sie in der Dokumentation der jeweiligen Engine. Nicht unterstützte Einträge werden ignoriert.

Wenn die Engine korrekt initialisiert wird, wird die Variable ` state ` der Engine auf ` QTextToSpeech::Ready` gesetzt. Wenn das Laden des Plugins fehlschlägt oder die Initialisierung der Engine fehlschlägt, wird die Variable ` state ` der Engine auf ` QTextToSpeech::Error` gesetzt.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch „ availableEngines()“.

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

Löscht dieses „ QTextToSpeech “-Objekt und beendet damit jegliche Sprachausgabe.

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

Dieses Signal wird unmittelbar vor dem Start des Engines ausgegeben, um die Sprachaudiodaten für „ id “ zu synthetisieren. „ id “ ist der Wert, der durch einen Aufruf von „ enqueue()“ zurückgegeben wird. Anwendungen können dieses Signal nutzen, um in letzter Minute Änderungen an den Attributen von „ voice “ vorzunehmen oder den Verarbeitungsprozess von Text zu verfolgen, der über „ enqueue()“ in die Warteschlange gestellt wurde.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch „ enqueue()“, „ synthesize()“ und „ voice “.

[static invokable] QStringList QTextToSpeech::availableEngines()

Ruft die Liste der unterstützten Plug-ins für Text-to-Speech-Engines ab.

Siehe auch engine.

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

Gibt die Liste der von der aktiven engine unterstützten Locales zurück.

Siehe auch ` availableVoices()` und ` findVoices()`.

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

Gibt die Liste der für das aktuelle locale verfügbaren Stimmen zurück.

Siehe auch ` availableLocales()` und ` findVoices()`.

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

Fügt „ utterance “ zur Warteschlange der vorzusprechenden Texte hinzu und beginnt mit dem Vorlesen. Gibt den Index des Textes in der Warteschlange zurück oder -1 im Falle eines Fehlers.

Wenn das „ state “ der Engine derzeit „ Ready “ lautet, wird „ utterance “ sofort vorgelesen. Andernfalls beginnt die Engine mit dem Vorlesen von „ utterance “, sobald sie den aktuellen Text vorgelesen hat.

Jedes Mal, wenn die Engine zum nächsten Texteintrag in der Warteschlange übergeht, wird das Signal „ aboutToSynthesize()“ ausgesendet. Dies ermöglicht es Anwendungen, den Fortschritt zu verfolgen und in letzter Minute Änderungen an den Sprachattributen vorzunehmen.

Der Aufruf von ` stop()` leert die Warteschlange. Um die Engine am Ende eines Textes anzuhalten, verwenden Sie den Begrenzungshinweis ` Utterance `.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch ` say()`, ` stop()`, ` aboutToSynthesize()` und ` synthesize()`.

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

Dieses Signal wird ausgelöst, nachdem ein Fehler aufgetreten ist und „ state “ auf „ QTextToSpeech::Error “ gesetzt wurde. Der Parameter „ reason “ gibt die Art des Fehlers an, und „ errorString “ liefert eine für Menschen lesbare Fehlerbeschreibung.

QTextToSpeech::ErrorReason ist kein registrierter Metatyp, daher müssen Sie ihn für Verbindungen in der Warteschlange mit den Funktionen „ Q_DECLARE_METATYPE()“ und „ qRegisterMetaType()“ registrieren.

Siehe auch errorReason(), errorString() und „Erstellen benutzerdefinierter Qt-Typen“.

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

Gibt den Grund zurück, warum die Engine einen Fehler gemeldet hat.

Siehe auch state und errorOccurred().

[invokable] QString QTextToSpeech::errorString() const

Gibt die aktuelle Fehlermeldung der Engine zurück.

Siehe auch errorOccurred().

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

Gibt die Liste der Stimmen zurück, die den Kriterien unter args entsprechen.

Die Argumente in „ args “ werden der Reihe nach verarbeitet, um die Liste der Stimmen zusammenzustellen, die allen Kriterien entsprechen. Ein Argument vom Typ „ QString “ wird mit dem „ name “ der Stimme abgeglichen, ein Argument vom Typ „ QLocale “ mit dem „ locale “ der Stimme usw. Es ist möglich, nur die „ Language “ oder „ Territory “ der gewünschten Stimmen anzugeben, und der Name kann mit einem „ regular expression “ abgeglichen werden.

Diese Funktion gibt alle Stimmen zurück, wenn die Liste der Kriterien leer ist. Mehrere Kriterien desselben Typs sind nicht zulässig und führen zu einem Kompilierungsfehler.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch „ availableVoices()“.

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

Hält die aktuelle Sprachausgabe unter boundaryHint an.

Ob der Wert „ boundaryHint “ berücksichtigt wird, hängt von „ engine “ ab.

Siehe auch resume() und PauseResume.

[slot] void QTextToSpeech::resume()

Die Sprachausgabe wird fortgesetzt, nachdem „ pause()“ aufgerufen wurde.

Siehe auch ` pause()`.

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

Beginnt mit der Wiedergabe von „ text “.

Diese Funktion beginnt asynchron mit der Sprachsynthese und liest den Text über das Standard-Audioausgabegerät vor.

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

Der aktuelle Status ist über die Eigenschaft „ state “ abrufbar und wird auf „ Speaking “ gesetzt, sobald das Vorlesen beginnt. Nach Abschluss des Vorlesens wird „ state “ auf „ Ready “ gesetzt.

Siehe auch „ enqueue()“, „ stop()“, „ pause()“, „ resume()“ und „ synthesize()“.

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

Dieses Signal wird ausgelöst, wenn das „ word “ – also der Textabschnitt, auf den in der Äußerung „ id “ durch „ start “ und „ length “ verwiesen wird – auf dem Audiogerät wiedergegeben wird.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch „ Capability “ und „ say()“.

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

Legt die von diesem „ QTextToSpeech “-Objekt verwendete Engine auf „ engine “ fest und übergibt dabei „ params “ an den Konstruktor der Engine.

Gibt zurück, ob „ engine “ erfolgreich gesetzt werden konnte.

Welche Schlüssel-Wert-Paare in ` params ` unterstützt werden, hängt von der Engine ab. Einzelheiten finden Sie in der Dokumentation der jeweiligen Engine. Nicht unterstützte Einträge werden ignoriert.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch „ engine()“.

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

Hält den aktuellen Lesevorgang bei „ boundaryHint “ an und löscht die Warteschlange mit ausstehenden Texten.

Das Lesen kann nicht fortgesetzt werden. Ob der Wert ` boundaryHint ` berücksichtigt wird, hängt von der Engine ab.

Siehe auch „ say()“, „ enqueue()“ und „ pause()“.

Synthetisiert die „ text “ in Roh-Audiodaten.

Diese Funktion synthetisiert die Sprache asynchron in Roh-Audiodaten. Sobald Daten verfügbar sind, wird die „ functor “ entweder als „ functor(QAudioFormat format, QByteArray bytes) “ aufgerufen, wobei „ format “ die „ format “ der Daten in „ bytes “ beschreibt, oder als „ functor(QAudioBuffer &buffer) “.

Die Eigenschaft „ state “ wird zu Beginn der Synthese auf „ Synthesizing “ gesetzt und nach Abschluss der Synthese auf „ Ready “. Während der Synthese kann die Funktion „ functor “ mehrfach aufgerufen werden, möglicherweise mit wechselnden Werten für „ format “.

Die ` functor ` kann ein aufrufbares Objekt sein, wie beispielsweise ein Lambda oder eine freie Funktion, mit einem optionalen ` context `-Objekt:

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

oder eine Mitgliedsfunktion des ` context `-Objekts:

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

Wird „ context “ zerstört, wird „ functor “ nicht mehr aufgerufen.

Diese Funktionen wurden in Qt 6.6 eingeführt.

Siehe auch „ say()“ und „ stop()“.