TextToSpeech QML Type

Die zur Synthetisierung von Text in Sprache verwendete Engine.

Wenn Sie die Engine ändern, wird die laufende Sprachausgabe gestoppt.

Auf den meisten Plattformen wird durch die Änderung der Engine die Liste von available locales und available voices aktualisiert.

Diese Eigenschaft enthält die von der aktuellen Engine implementierten Fähigkeiten.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Siehe auch engine und QTextToSpeech::Capability.

Diese Eigenschaft enthält engine-spezifische Parameter.

Siehe auch engine.

Diese Eigenschaft enthält das aktuell verwendete Gebietsschema.

Standardmäßig wird das Systemgebietsschema verwendet.

Siehe auch voice.

Diese Eigenschaft enthält die Tonhöhe der Stimme, die von -1,0 bis 1,0 reicht.

Der Standardwert von 0,0 ist die normale Tonhöhe.

Diese Eigenschaft enthält die aktuelle Sprechgeschwindigkeit, die zwischen -1,0 und 1,0 liegt.

Der Standardwert von 0,0 ist der normale Sprachfluss.

Diese Eigenschaft enthält den aktuellen Status des Sprachsynthesizers.

        onStateChanged: updateStateLabel(state)

        function updateStateLabel(state)
        {
            switch (state) {
                case TextToSpeech.Ready:
                    statusLabel.text = qsTr("Ready")
                    break
                case TextToSpeech.Speaking:
                    statusLabel.text = qsTr("Speaking")
                    break
                case TextToSpeech.Paused:
                    statusLabel.text = qsTr("Paused...")
                    break
                case TextToSpeech.Error:
                    statusLabel.text = qsTr("Error!")
                    break
            }
        }

Siehe auch QTextToSpeech::State, say(), stop(), und pause().

Diese Eigenschaft enthält die Stimme, die für die Sprachausgabe verwendet werden soll.

Die Stimme muss eine der voices available für die Engine sein.

Auf einigen Plattformen werden durch das Einstellen der Stimme andere Stimmattribute wie locale, pitch usw. geändert. Diese Änderungen lösen die Ausgabe von Signalen aus.

Diese Eigenschaft enthält die aktuelle Lautstärke, die von 0,0 bis 1,0 reicht.

Der Standardwert ist die Standardlautstärke der Plattform.

Dieses Signal wird ausgegeben, kurz bevor die Engine beginnt, das Sprachaudio für id zu synthetisieren. 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.

Dieses Signal wurde in Qt 6.6 eingeführt.

Siehe auch enqueue() und voice.

Dieses Signal wird ausgegeben, nachdem ein Fehler aufgetreten ist und state auf TextToSpeech.Error gesetzt wurde. Der Parameter reason spezifiziert den Fehlertyp, und errorString liefert eine menschenlesbare Fehlerbeschreibung.

Siehe auch state, errorReason(), und errorString().

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.

Der folgende Code hebt das Wort hervor, das in einem TextArea input gesprochen wird:

        onSayingWord: (word, id, start, length)=> {
            input.select(start, start + length)
        }

Dieses Signal wurde in Qt 6.6 eingeführt.

Siehe auch QTextToSpeech::Capability und say().

Enthält die Liste der unterstützten Text-to-Speech-Engine-Plug-ins.

Enthält die Liste der Sprachumgebungen, die von der aktiven engine unterstützt werden.

Enthält die Liste der Stimmen, die für die aktuelle locale verfügbar sind.

Fügt utterance in die Warteschlange der zu sprechenden Texte ein und beginnt zu sprechen.

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

Jedes Mal, wenn die Engine mit dem nächsten Texteintrag in der Warteschlange fortfährt, wird das Signal aboutToSynthesize() ausgesendet. 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.

Diese Methode wurde in Qt 6.6 eingeführt.

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

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

Siehe auch QTextToSpeech::ErrorReason.

Gibt die aktuelle Fehlermeldung der Engine zurück.

Gibt die Liste der Stimmen zurück, die allen angegebenen criteria entsprechen.

criteria ist eine Zuordnung von Stimmeneigenschaftsnamen zu Eigenschaftswerten und unterstützt Kombinationen von Suchkriterien wie z.B.:

let daniel = tts.findVoices({
    "name": "Daniel"
})
let maleEnglish = tts.findVoices({
    "gender": Voice.Male,
    "language": Qt.locale('en')
})

Diese Methode wurde in Qt 6.6 eingeführt.

Siehe auch VoiceSelector.

Hält die aktuelle Sprache bei boundaryHint an.

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

Siehe auch resume(), QTextToSpeech::BoundaryHint, und PauseResume.

Setzt das Sprechen fort, nachdem pause() aufgerufen wurde.

Siehe auch pause().

Startet die Synthese der text.

Diese Funktion startet die Sprachsynthese asynchron und liest den Text auf dem Standard-Audioausgabegerät vor.

        RowLayout {
            Button {
                text: qsTr("Speak")
                enabled: [TextToSpeech.Paused, TextToSpeech.Ready].includes(tts.state)
                onClicked: {
                    tts.say(input.text)
                }
            }

Der aktuelle Status ist über die Eigenschaft state verfügbar und wird auf QTextToSpeech::Speaking gesetzt, sobald das Lesen beginnt. Wenn das Lesen beendet ist, wird state auf QTextToSpeech::Ready gesetzt.

Siehe auch stop(), pause(), und resume().

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

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

Siehe auch say(), enqueue(), pause(), und QTextToSpeech::BoundaryHint.