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()도 참조하세요 .

이 신호는 id 발화에서 start 및 length 로 표시된 텍스트 조각인 word 이 오디오 장치에 재생될 때 방출됩니다.

다음 코드는 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도 참조하세요 .