変更点Qt TextToSpeech

Qt 6 は、フレームワークをより効率的で使いやすくするための意識的な努力の結果です。

私たちは各リリースにおいて、すべてのパブリックAPIのバイナリとソースの互換性を維持しようと努めています。しかし、Qt をより良いフレームワークにするために避けられない変更もあります。

このトピックでは Qt TextToSpeechを要約し、それらを扱うためのガイダンスを提供します。

利用可能なエンジン

Qt 5 で利用可能だったすべてのエンジンは、Qt 6.4 でも利用可能です。Qt 6.4 で利用可能なエンジンの完全なリストについては、Qt TextToSpeech Engines を参照してください。

エンジンは追加の設定パラメーターを受け取ることができるようになりました。QTextToSpeech インスタンスを作成する際に、エンジン固有のキーと値のペアを持つQVariantMap を渡してください。

API の変更

APIの Qt TextToSpeechモジュールの基本的な統合と整理が行われました。Qt 6 への移植は最小限で済むはずです。

QTextToSpeech クラス

QTextToSpeech::State の列挙値BackendError の名前がError に変更されました。詳細なエラー情報はQTextToSpeech::errorReason() とQTextToSpeech::errorString() から入手できます。

新しいengine プロパティでは、初期化されたQTextToSpeech オブジェクトのエンジンを変更できます。

pause およびQTextToSpeech::stop スロットはQTextToSpeech::BoundaryHint enum 値を取ります。これにより、PMF構文を使用するシグナル/スロット接続において、シグナルが以前は無視されていたパラメータを持つ場合、コンパイルが中断されます:

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

パラメータを持たないシグナルに接続するか、ラムダを使用してそれぞれのスロット・メソッドを明示的に呼び出してください:

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

QVoiceクラス

QVoice クラスを使用する既存のコードは、以前と同様に動作します。QVoice オブジェクトは、QDataStream を介してシリアライズできるようになりました。

QTextToSpeechEngine および QTextToSpeechPlugin クラス

これらのクラスはパブリック API から削除されました。これらのクラスはまだ存在し、利用可能なエンジン実装によって使用されていますが、ドキュメント化されサポートされている API の一部ではなく、将来のリリースで変更される可能性があります。

© 2025 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.