QTextToSpeech Class

멤버 함수 문서

text 을 원시 오디오 데이터로 합성합니다.

이 함수는 음성을 비동기적으로 원시 오디오 데이터로 합성합니다. 데이터를 사용할 수 있는 경우 functor 은 functor(QAudioFormat format, QByteArray bytes) 으로 호출되며 format 은 bytes 에서 데이터의 format 을 설명하거나 functor(QAudioBuffer &buffer) 으로 호출됩니다.

합성이 시작되면 state 속성은 Synthesizing 으로 설정되고 합성이 완료되면 Ready 으로 설정됩니다. 합성이 진행되는 동안 functor 은 format 의 값을 변경하여 여러 번 호출될 수 있습니다.

functor 은 람다나 자유 함수처럼 호출 가능하거나 context 객체(선택 사항)를 사용할 수 있습니다:

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

또는 context 객체의 멤버 함수가 될 수 있습니다:

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

context 이 파괴되면 functor 은 더 이상 호출되지 않습니다.

이 함수는 Qt 6.6에 도입되었습니다.

say() 및 stop()도 참조하세요 .

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

기본 엔진 플러그인을 사용하는 플러그인에서 텍스트 음성 변환 엔진을 로드하고 parent 의 자식으로 QTextToSpeech 객체를 구성합니다.

기본 엔진은 플랫폼에 따라 다릅니다.

엔진이 올바르게 초기화되면 엔진의 state 이 QTextToSpeech::Ready 으로 변경되며, 이는 비동기적으로 발생할 수 있습니다. 플러그인이 로드되지 않으면 state 은 QTextToSpeech::Error 으로 설정됩니다.

availableEngines()도 참조하세요 .

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

매개변수 engine 와 일치하는 플러그인에서 텍스트 음성 변환 엔진을 로드하고 parent 의 자식으로 QTextToSpeech 객체를 구성합니다.

engine 이 비어 있으면 기본 엔진 플러그인이 사용됩니다. 기본 엔진은 플랫폼별로 다릅니다.

엔진이 올바르게 초기화되면 엔진의 state 은 QTextToSpeech::Ready 으로 설정됩니다. 플러그인이 로드되지 않거나 엔진이 초기화에 실패하면 엔진의 state 은 QTextToSpeech::Error 으로 설정됩니다.

availableEngines()도 참조하세요 .

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

매개변수 engine 와 일치하는 플러그인에서 텍스트 음성 변환 엔진을 로드하고 parent 의 자식으로 QTextToSpeech 객체를 구성하여 params 을 엔진에 전달합니다.

engine 이 비어 있으면 기본 엔진 플러그인이 사용됩니다. 기본 엔진은 플랫폼별로 다릅니다. params 에서 지원되는 키/값 쌍은 엔진에 따라 다릅니다. 자세한 내용은 엔진 설명서를 참조하세요. 지원되지 않는 항목은 무시됩니다.

엔진이 올바르게 초기화되면 엔진의 state 은 QTextToSpeech::Ready 으로 설정됩니다. 플러그인이 로드되지 않거나 엔진이 초기화에 실패하면 엔진의 state 은 QTextToSpeech::Error 으로 설정됩니다.

이 함수는 Qt 6.4에 도입되었습니다.

availableEngines()도 참조하십시오 .

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

이 QTextToSpeech 객체를 파괴하여 모든 발언을 중지합니다.

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

이 신호는 엔진이 id 에 대한 음성 오디오 합성을 시작하기 직전에 방출됩니다. id 은 enqueue() 호출에 의해 반환되는 값이며, 애플리케이션은 이 신호를 사용하여 voice 속성을 마지막으로 변경하거나 enqueue()을 통해 대기열에 추가된 텍스트의 프로세스를 추적할 수 있습니다.

이 함수는 Qt 6.6에 도입되었습니다.

enqueue(), synthesize() 및 voice 를참조하십시오 .

[static invokable] QStringList QTextToSpeech::availableEngines()

지원되는 텍스트 음성 변환 엔진 플러그인 목록을 가져옵니다.

engine도 참조하세요 .

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

활성 engine 에서 지원되는 로캘 목록을 반환합니다.

availableVoices() 및 findVoices()도 참조하세요 .

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

현재 locale 에 사용할 수 있는 음성 목록을 반환합니다.

availableLocales() 및 findVoices()도 참조하세요 .

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

말할 텍스트 대기열에 utterance 을 추가하고 말하기 시작합니다. 대기열에 있는 텍스트의 인덱스를 반환하거나 오류가 있는 경우 -1을 반환합니다.

엔진의 state 이 현재 Ready 인 경우 utterance 이 즉시 발화됩니다. 그렇지 않으면 엔진은 현재 텍스트의 말하기를 마친 후 utterance 를 말하기 시작합니다.

엔진이 대기열의 다음 텍스트 항목으로 넘어갈 때마다 aboutToSynthesize() 신호가 전송됩니다. 이를 통해 애플리케이션은 진행 상황을 추적하고 음성 속성을 마지막 순간에 변경할 수 있습니다.

stop()를 호출하면 대기열이 지워집니다. 텍스트 끝에서 엔진을 일시 중지하려면 Utterance 경계 힌트를 사용하세요.

이 기능은 Qt 6.6에 도입되었습니다.

say(), stop(), aboutToSynthesize() 및 synthesize()도 참조하세요 .

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

이 신호는 오류가 발생하고 state 가 QTextToSpeech::Error 로 설정된 후에 전송됩니다. reason 매개 변수는 오류 유형을 지정하고 errorString 은 사람이 읽을 수 있는 오류 설명을 제공합니다.

QTextToSpeech::ErrorReason 는 등록된 메타타입이 아니므로 대기 중인 연결의 경우 Q_DECLARE_METATYPE() 및 qRegisterMetaType()로 등록해야 합니다.

errorReason(), errorString() 및 사용자 정의 Qt 유형 만들기를참조하십시오 .

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

엔진이 오류를 보고한 이유를 반환합니다.

state 및 errorOccurred()도 참조하세요 .

[invokable] QString QTextToSpeech::errorString() const

현재 엔진 오류 메시지를 반환합니다.

errorOccurred()도 참조하세요 .

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

args 의 조건과 일치하는 보이스 목록을 반환합니다.

args 의 인수는 모두 일치하는 음성 목록을 조합하는 순서로 처리됩니다. QString 유형의 인수는 음성의 name 과 일치하고, QLocale 유형의 인수는 음성의 locale 과 다시 일치하는 식입니다. 원하는 보이스의 Language 또는 Territory 만 지정할 수 있으며, 이름은 regular expression 과 일치시킬 수 있습니다.

이 함수는 기준 목록이 비어 있으면 모든 음성을 반환합니다. 같은 유형의 기준을 여러 개 지정할 수 없으며 컴파일 시 오류가 발생합니다.

이 함수는 Qt 6.6에 도입되었습니다.

availableVoices()도 참조하세요 .

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

boundaryHint 에서 현재 연설을 일시 중지합니다.

boundaryHint 이 존중되는지 여부는 engine 에 따라 다릅니다.

resume() 및 PauseResume 을참조하세요 .

[slot] void QTextToSpeech::resume()

pause()를 호출한 후 다시 말하기 시작합니다.

pause()도 참조하세요 .

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

text 을 말하기 시작합니다.

이 기능은 비동기적으로 음성 합성을 시작하고 기본 오디오 출력 장치로 텍스트를 읽습니다.

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

현재 상태는 state 속성을 사용하여 확인할 수 있으며, 읽기가 시작되면 Speaking 으로 설정됩니다. 읽기가 완료되면 state 은 Ready 으로 설정됩니다.

enqueue(), stop(), pause(), resume() 및 synthesize()도 참조하세요 .

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

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

이 기능은 Qt 6.6에 도입되었습니다.

Capability 및 say()도 참조하세요 .

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

이 QTextToSpeech 객체가 사용하는 엔진을 engine 으로 설정하고 params 을 엔진 생성자에게 전달합니다.

engine 을 성공적으로 설정할 수 있는지 여부를 반환합니다.

params 에서 지원되는 키/값 쌍은 엔진에 따라 다릅니다. 자세한 내용은 엔진 설명서를 참조하세요. 지원되지 않는 항목은 무시됩니다.

이 함수는 Qt 6.4에 도입되었습니다.

engine()도 참조하십시오 .

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

boundaryHint 에서 현재 읽기를 중지하고 대기 중인 텍스트의 대기열을 지웁니다.

읽기를 다시 시작할 수 없습니다. boundaryHint 이 존중되는지 여부는 엔진에 따라 다릅니다.

say(), enqueue() 및 pause()도 참조하세요 .