TextToSpeech QML Type

用于合成文本到语音的引擎。

更改引擎会停止任何正在进行的语音。

在大多数平台上，更改引擎将更新available locales 和available voices 的列表。

该属性包含当前引擎实现的功能。

该属性在 Qt 6.6 中引入。

另请参阅 engine 和QTextToSpeech::Capability 。

该属性包含特定于引擎的参数。

另请参阅 engine 。

该属性保存当前使用的本地语言。

默认情况下，使用系统语言。

另请参见 voice 。

该属性包含语音音高，范围从 -1.0 到 1.0。

默认值 0.0 为正常语音音高。

该属性用于保存当前的语音速率，范围从-1.0 到 1.0。

默认值 0.0 为正常语速。

该属性表示语音合成器的当前状态。

        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
            }
        }

另请参阅 QTextToSpeech::State,say(),stop() 和pause()。

该属性用于保存将用于语音的声音。

该语音必须是voices available 引擎的语音之一。

在某些平台上，设置语音会改变其他语音属性，如locale,pitch 等。这些更改会触发信号发射。

该属性保存当前音量，范围从 0.0 到 1.0。

默认值是平台的默认音量。

该信号在引擎开始合成id 的语音音频之前发出。应用程序可使用此信号对voice 属性进行最后修改，或跟踪通过enqueue() 查询文本的进程。

此信号在 Qt 6.6 中引入。

另请参阅 enqueue() 和voice 。

该信号在发生错误且state 已设置为TextToSpeech.Error 后发出。reason 参数指定了错误类型，errorString 提供了人类可读的错误描述。

另请参阅 state,errorReason() 和errorString()。

当word （即语句id 中start 和length 所指示的文本片段）被播放到音频设备时，就会发出该信号。

下面的代码突出显示了TextArea input 中所说的单词：

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

该信号在 Qt 6.6 中引入。

另请参阅 QTextToSpeech::Capability 和say()。

持有支持的文本到语音引擎插件列表。

持有活动engine 支持的本地语言列表。

持有当前locale 可用的语音列表。

将utterance 添加到要发言的文本队列中，并开始发言。

如果引擎的state 当前是Ready ，则utterance 将立即被说出。否则，引擎将在说完当前文本后开始说utterance 。

每次引擎进入队列中的下一个文本条目时，都会发出aboutToSynthesize() 信号。这样，应用程序就可以跟踪进度，并在最后一刻更改语音属性。

调用stop() 会清除队列。

该方法在 Qt 6.6 中引入。

另请参阅 say()、stop() 和aboutToSynthesize()。

返回引擎报错的原因。

另请参阅 QTextToSpeech::ErrorReason 。

返回当前引擎的错误信息。

返回与所有指定criteria 匹配的声音列表。

criteria 是一个从声音属性名称到属性值的映射，支持搜索条件的组合，如

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

此方法在 Qt 6.6 中引入。

另请参阅 VoiceSelector 。

在boundaryHint 处暂停当前语音。

是否尊重boundaryHint 取决于engine 。

另请参阅 resume(),QTextToSpeech::BoundaryHint, 和PauseResume 。

调用pause() 后继续发言。

另请参阅 pause()。

开始合成text 。

该函数以异步方式开始合成语音，并将文本读到默认的音频输出设备上。

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

当前状态可通过state 属性获得，一旦开始朗读，该属性将被设置为QTextToSpeech::Speaking 。阅读完成后，state 将被设置为QTextToSpeech::Ready 。

另请参阅 stop()、pause() 和resume()。

在boundaryHint 停止当前读取，并清除队列中的待读文本。

阅读无法恢复。是否尊重boundaryHint 取决于引擎。

另请参阅 say(),enqueue(),pause() 和QTextToSpeech::BoundaryHint 。