Класс QTextToSpeech
Класс QTextToSpeech предоставляет удобный доступ к движкам преобразования текста в речь Подробнее...
| Заголовок: | #include <QTextToSpeech> |
| qmake: | QT += texttospeech |
| Наследует: | QObject |
Типы публичного доступа
| Перечисление | State { Готов, Произносит, Приостановлен, ОшибкаБэкенда } |
Свойства
- 1 свойство унаследовано от QObject
Открытые функции
| QTextToSpeech(QObject *parent = nullptr) | |
| QTextToSpeech(const QString &engine, QObject *parent = nullptr) | |
| QVector<QLocale> | availableLocales() const |
| QVector<QVoice> | availableVoices() const |
| QLocale | locale() const |
| double | pitch() const |
| double | rate() const |
| State | state() const |
| QVoice | voice() const |
| double | volume() const |
- 32 открытые функции унаследованы от QObject
Открытые слоты
| void | pause() |
| void | resume() |
| void | say(const QString &text) |
| void | setLocale(const QLocale &locale) |
| void | setPitch(double pitch) |
| void | setRate(double rate) |
| void | setVoice(const QVoice &voice) |
| void | setVolume(double volume) |
| void | stop() |
- 1 открытый слот унаследован от QObject
Сигналы
| void | localeChanged(const QLocale &locale) |
| void | pitchChanged(double pitch) |
| void | rateChanged(double rate) |
| void | stateChanged(QTextToSpeech::State state) |
| void | voiceChanged(const QVoice &voice) |
| void | volumeChanged(int volume) |
- 2 сигнала унаследованы от QObject
Статические члены публичного доступа
| QStringList | availableEngines() |
- 11 статических открытых членов унаследованы от QObject
Дополнительные наследуемые члены
- 9 защищенных функций унаследованы от QObject
Подробное описание
Класс QTextToSpeech предоставляет удобный доступ к движкам преобразования текста в речь
Используйте say(), чтобы начать синтез текста. Можно указать язык с помощью setLocale(). Для выбора между доступными голосами используйте setVoice(). Языки и голоса зависят от доступных синтезаторов на каждой платформе. В Linux по умолчанию используется speech-dispatcher.
Документация по типам членов
перечисление QTextToSpeech::State
| Постоянная | Значение | Описание |
|---|---|---|
QTextToSpeech::Ready |
0 |
Синтезатор готов начать новый текст. Это также состояние после завершения текста. |
QTextToSpeech::Speaking |
1 |
Текущий текст произносится. |
QTextToSpeech::Paused |
2 |
Синтез был приостановлен и может быть возобновлен с помощью resume(). |
QTextToSpeech::BackendError |
3 |
Бэкенд не смог произнести текущую строку. |
Документация свойств
locale : QLocale
Это свойство содержит текущий используемый регион. По умолчанию используется системный регион.
Функции доступа:
| QLocale | locale() const |
| void | setLocale(const QLocale &locale) |
Сигнал уведомления:
| void | localeChanged(const QLocale &locale) |
pitch : double
Это свойство содержит высоту тона голоса, изменяющуюся от -1.0 до 1.0. По умолчанию значение 0.0 соответствует нормальной высоте тона голоса.
Функции доступа:
| double | pitch() const |
| void | setPitch(double pitch) |
Сигнал уведомления:
| void | pitchChanged(double pitch) |
rate : double
Это свойство содержит текущую скорость голоса, изменяющуюся от -1.0 до 1.0. Значение по умолчанию 0.0 соответствует нормальной скорости речи.
Функции доступа:
| double | rate() const |
| void | setRate(double rate) |
Сигнал уведомления:
| void | rateChanged(double rate) |
state : const State
Это свойство содержит текущее состояние синтезатора речи. Используйте say() для начала синтеза текста с текущим голосом и регионом.
Функции доступа:
| State | state() const |
Сигнал уведомления:
| void | stateChanged(QTextToSpeech::State state) |
voice : QVoice
Это свойство содержит текущий голос, используемый для речи.
Функции доступа:
| QVoice | voice() const |
| void | setVoice(const QVoice &voice) |
Сигнал уведомления:
| void | voiceChanged(const QVoice &voice) |
volume : int
Это свойство содержит текущий уровень громкости, изменяющийся от 0.0 до 1.0. По умолчанию используется значение по умолчанию для платформы.
Функции доступа:
| double | volume() const |
| void | setVolume(double volume) |
Сигнал уведомления:
| void | volumeChanged(int volume) |
Документация по функциям-членам
QTextToSpeech::QTextToSpeech(QObject *parent = nullptr)
Загружает движок текстового ввода речи из плагина, использующего плагин по умолчанию, и создаёт объект QTextToSpeech как дочерний элемент parent.
Движок по умолчанию может зависеть от платформы.
Если загрузка плагина завершается ошибкой, QTextToSpeech::state() возвращает QTextToSpeech::BackendError.
См. также availableEngines().
QTextToSpeech::QTextToSpeech(const QString &engine, QObject *parent = nullptr)
Загружает движок текстового ввода речи из плагина, соответствующего параметру engine, и создаёт объект QTextToSpeech как дочерний элемент parent.
Если engine пустое, используется плагин движка по умолчанию. Движок по умолчанию может зависеть от платформы.
Если загрузка плагина завершается ошибкой, QTextToSpeech::state() возвращает QTextToSpeech::BackendError.
См. также availableEngines().
[static] QStringList QTextToSpeech::availableEngines()
Получает список поддерживаемых плагинов движков текстового ввода речи.
QVector<QLocale> QTextToSpeech::availableLocales() const
Получает вектор поддерживаемых в настоящее время языковых регионов.
Примечание: На некоторых платформах они могут изменяться, например, при изменении бэкенда синтезаторов.
QVector<QVoice> QTextToSpeech::availableVoices() const
Получает вектор голосов, доступных для текущего региона.
Примечание: Если регион не был задан, используется системный регион.
[slot] void QTextToSpeech::pause()
Приостанавливает текущую речь.
Примечание:
- Функция зависит от платформы и бэкенда. Она может вообще не работать, может потребоваться несколько секунд, прежде чем она начнёт действовать, или она может приостановить работу мгновенно. Некоторые синтезаторы будут искать перерыв, из которого позже можно будет возобновить процесс, например, конец предложения.
- Из-за ограничений платформы Android функция pause() останавливает текущую речь, в то время как resume() запускает предыдущее запрошенное предложение с начала.
См. также resume().
[slot] void QTextToSpeech::resume()
Возобновляет произношение после вызова pause().
См. также pause().
[slot] void QTextToSpeech::say(const QString &text)
Начинает синтез текста text. Эта функция запускает асинхронное чтение текста. Текущее состояние можно получить, используя свойство state. После завершения синтеза вызывается сигнал stateChanged() со статусом Ready.
[slot] void QTextToSpeech::setLocale(const QLocale &locale)
Устанавливает заданный locale, если это возможно. По умолчанию используется системный регион.
Примечание: Функция-установщик для свойства locale.
См. также locale().
[slot] void QTextToSpeech::setVoice(const QVoice &voice)
Устанавливает используемый voice.
Примечание: На некоторых платформах установка голоса изменяет другие атрибуты голоса, такие как регион, высота тона и т. д. Эти изменения вызывают генерацию сигналов.
Примечание: Функция-установщик для свойства voice.
См. также voice().
[slot] void QTextToSpeech::stop()
Останавливает чтение текста.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qtexttospeech.html