QTextToSpeech Class

멤버 함수 설명서

[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()도 참조하십시오 .

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()도 참조하십시오 .