Changements apportés à Qt TextToSpeech

Qt 6 est le résultat d'un effort conscient pour rendre le cadre plus efficace et plus facile à utiliser.

Nous essayons de maintenir la compatibilité binaire et source pour toutes les API publiques dans chaque version. Mais certains changements étaient inévitables dans un effort pour faire de Qt un meilleur framework.

Dans cette rubrique, nous résumons ces changements dans Qt TextToSpeechet fournissons des conseils pour les gérer.

Moteurs disponibles

Tous les moteurs qui étaient disponibles dans Qt 5 le sont également dans Qt 6.4. Pour une liste complète des moteurs disponibles dans Qt 6.4, voir Qt TextToSpeech Engines.

Les moteurs peuvent désormais recevoir des paramètres de configuration supplémentaires. Lors de la construction d'une instance QTextToSpeech, passez un QVariantMap avec des paires clé/valeur spécifiques au moteur.

Changements dans l'API

Le module Qt TextToSpeech a fait l'objet d'une consolidation et d'un nettoyage de base. L'effort de portage devrait être minimal pour pouvoir passer à Qt 6.

La classe QTextToSpeech

La valeur de l'enum QTextToSpeech::State BackendError a été renommée en Error. Des informations détaillées sur les erreurs sont disponibles via QTextToSpeech::errorReason() et QTextToSpeech::errorString().

La nouvelle propriété engine permet de modifier le moteur d'un objet QTextToSpeech initialisé.

Les emplacements pause et QTextToSpeech::stop prennent une valeur enum QTextToSpeech::BoundaryHint. Cela interrompra la compilation des connexions signal/emplacement qui utilisent la syntaxe PMF si le signal a des paramètres qui étaient auparavant ignorés :

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

Il faut soit se connecter à un signal sans paramètres, soit utiliser un lambda et appeler explicitement la méthode du slot correspondant :

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

La classe QVoice

Le code existant utilisant la classe QVoice continue de fonctionner comme auparavant. Les objets QVoice peuvent maintenant être sérialisés via QDataStream.

Les classes QTextToSpeechEngine et QTextToSpeechPlugin

Ces classes ont été retirées de l'API publique. Elles existent toujours et sont utilisées par les implémentations de moteurs disponibles, mais elles ne font pas partie de l'API documentée et supportée, et sont susceptibles d'être modifiées dans les prochaines versions.