QTextToSpeech Class

Dokumentation der Mitgliedsfunktionen

Synthetisiert die text in rohe Audiodaten.

Diese Funktion synthetisiert die Sprache asynchron in rohe Audiodaten. Wenn Daten verfügbar sind, wird functor 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 auf Synthesizing gesetzt, wenn die Synthese beginnt, und auf Ready, wenn die Synthese beendet ist. Während der Synthese kann die functor mehrfach aufgerufen werden, möglicherweise mit wechselnden Werten für format.

Die functor kann eine Callable sein, wie eine Lambda- oder Free-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 sein:

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

Wenn context zerstört wird, dann wird functor nicht mehr aufgerufen.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch say() und stop().

[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 Kind von parent.

Die Standard-Engine ist plattformspezifisch.

Wenn die Engine korrekt initialisiert wird, ändert sich die state der Engine zu QTextToSpeech::Ready; beachten Sie, dass dies asynchron geschehen kann. Wenn das Plugin nicht geladen werden kann, 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 Kind von parent.

Wenn engine leer ist, wird das Standard-Engine-Plug-in verwendet. Die Standard-Engine ist plattformspezifisch.

Wenn die Engine korrekt initialisiert wird, wird state der Engine auf QTextToSpeech::Ready gesetzt. Wenn das Plugin nicht geladen werden kann oder wenn die Engine nicht initialisiert werden kann, wird 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 mit dem Parameter engine übereinstimmt, und konstruiert ein QTextToSpeech-Objekt als Kind von parent, wobei params an die Engine weitergegeben wird.

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

Wenn die Engine korrekt initialisiert wird, wird die state der Engine auf QTextToSpeech::Ready gesetzt. Wenn das Plugin nicht geladen werden kann oder die Engine nicht initialisiert werden kann, wird die state der Engine auf QTextToSpeech::Error gesetzt.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch availableEngines().

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

Zerstört dieses QTextToSpeech Objekt und unterbricht jede Rede.

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

Dieses Signal wird ausgegeben, kurz bevor die Engine beginnt, das Sprachaudio für id zu synthetisieren. id ist der Wert, der durch einen Aufruf von enqueue() zurückgegeben wird. Anwendungen können dieses Signal verwenden, um in letzter Minute Änderungen an voice Attributen vorzunehmen oder um den Prozess 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 Text-to-Speech-Engine-Plug-ins ab.

Siehe auch engine.

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

Gibt die Liste der Gebietsschemata zurück, die von der aktiven engine unterstützt werden.

Siehe auch availableVoices() und findVoices().

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

Gibt die Liste der für die 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 in die Warteschlange der zu sprechenden Texte ein und beginnt zu sprechen. Gibt den Index des Textes in der Warteschlange zurück, oder -1 im Falle eines Fehlers.

Wenn die Engine state gerade Ready ist, wird utterance sofort gesprochen. Andernfalls beginnt die Maschine, utterance zu sprechen, sobald sie den aktuellen Text beendet hat.

Jedes Mal, wenn die Engine mit dem nächsten Texteintrag in der Warteschlange fortfährt, wird das Signal aboutToSynthesize() ausgegeben. Dies ermöglicht es Anwendungen, den Fortschritt zu verfolgen und Änderungen an den Sprachattributen in letzter Minute vorzunehmen.

Der Aufruf von stop() löscht die Warteschlange. Um die Engine am Ende eines Textes anzuhalten, verwenden Sie den Utterance boundary hint.

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 ausgegeben, wenn ein Fehler aufgetreten ist und der Parameter state auf QTextToSpeech::Error gesetzt wurde. Der Parameter reason gibt die Art des Fehlers an, und errorString liefert eine von Menschen lesbare Fehlerbeschreibung.

QTextToSpeech::ErrorReason ist kein registrierter Metatyp, daher müssen Sie ihn für Warteschlangenverbindungen mit Q_DECLARE_METATYPE() und qRegisterMetaType() registrieren.

Siehe auch errorReason(), errorString(), und Erstellen von benutzerdefinierten 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 in args entsprechen.

Die Argumente in args werden verarbeitet, um die Liste der Stimmen zusammenzustellen, die alle Kriterien erfüllen. 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 möglich und führen zu einem Kompilierfehler.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch availableVoices().

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

Unterbricht die laufende Rede bei boundaryHint.

Ob die boundaryHint beachtet wird, hängt von der engine ab.

Siehe auch resume() und PauseResume.

[slot] void QTextToSpeech::resume()

Setzen Sie das Sprechen fort, nachdem pause() aufgerufen wurde.

Siehe auch pause().

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

Startet das Sprechen der text.

Diese Funktion beginnt mit der asynchronen Sprachsynthese und liest den Text auf dem Standard-Audioausgabegerät vor.

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

Der aktuelle Zustand ist über die Eigenschaft state verfügbar und wird auf Speaking gesetzt, sobald das Lesen beginnt. Wenn das Lesen beendet ist, 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 ausgegeben, wenn der word, d.h. der Textabschnitt, der durch start und length in der Äußerung id angegeben wird, auf dem Audiogerät abgespielt 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())

Setzt die von diesem QTextToSpeech -Objekt verwendete Engine auf engine und übergibt params an den Engine-Konstruktor.

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

Welche Schlüssel/Wertpaare in params unterstützt werden, hängt von der Engine ab. Siehe die Dokumentation der Engine für Details. 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)

Stoppt das aktuelle Lesen unter boundaryHint und löscht die Warteschlange der anstehenden Texte.

Der Lesevorgang kann nicht fortgesetzt werden. Ob boundaryHint beachtet wird, hängt von der Engine ab.

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