이 페이지에서

변경 사항 Qt TextToSpeech

Qt 6의 변경 사항은 프레임워크를 더 효율적이고 사용하기 쉽게 만들기 위한 의도적인 노력의 결과입니다.

저희는 각 릴리스에서 모든 공개 API에 대해 바이너리 및 소스 호환성을 유지하기 위해 노력하고 있습니다. 하지만 Qt를 더 나은 프레임워크로 만들기 위한 과정에서 일부 변경 사항은 불가피했습니다.

이 항목에서는 그러한 변경 사항을 요약하고 Qt TextToSpeech요약하고, 이를 처리하는 방법에 대한 지침을 제공합니다.

사용 가능한 엔진

Qt 5에서 사용할 수 있었던 모든 엔진은 Qt 6.4에서도 사용할 수 있습니다. Qt 6.4에서 사용할 수 있는 엔진의 전체 목록은 Qt TextToSpeech Engines를 참조하십시오.

이제 엔진에 추가 구성 매개변수를 전달할 수 있습니다. QTextToSpeech 인스턴스를 생성할 때, 엔진별 키/값 쌍이 포함된 QVariantMap 를 전달하십시오.

API 변경 사항

Qt TextToSpeech 모듈은 기본적인 통합 및 정리가 이루어졌습니다. Qt 6으로 전환하는 데 필요한 포팅 작업은 최소한으로 줄어들 것입니다.

QTextToSpeech 클래스

QTextToSpeech::State 열거형 값인 BackendError 이 Error 로 이름이 변경되었습니다. 자세한 오류 정보는 QTextToSpeech::errorReason() 및 QTextToSpeech::errorString()을 통해 확인할 수 있습니다.

새로운 engine 속성을 사용하면 초기화된 QTextToSpeech 객체에서 엔진을 변경할 수 있습니다.

pause 및 QTextToSpeech::stop 슬롯은 QTextToSpeech::BoundaryHint 열거형 값을 매개변수로 받습니다. 이로 인해 신호에 이전에 무시되었던 매개변수가 포함된 경우, PMF 구문을 사용하는 신호/슬롯 연결에서 컴파일 오류가 발생합니다:

connect(stopButton, &QPushButton, tts, &QTextToSpeech::stop);

매개변수가 없는 신호에 연결하거나, 람다를 사용하여 해당 슬롯 메서드를 명시적으로 호출하십시오:

connect(stopButton, &QPushButton, tts, [tts]{ tts->stop(); });

QVoice 클래스

QVoice 클래스를 사용하는 기존 코드는 이전과 동일하게 작동합니다. 이제 QVoice 객체는 QDataStream 를 통해 직렬화할 수 있습니다.

QTextToSpeechEngine 및 QTextToSpeechPlugin 클래스

이 클래스들은 공개 API에서 제거되었습니다. 이 클래스들은 여전히 존재하며 사용 가능한 엔진 구현체에서 사용되지만, 문서화되고 지원되는 API의 일부는 아니며 향후 릴리스에서 변경될 가능성이 높습니다.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.