Spec-Zone.ru › Qt 5.9

Класс QTextToSpeech

Класс QTextToSpeech предоставляет удобный доступ к движкам преобразования текста в речь Подробнее...

Заголовок: #include <QTextToSpeech>
qmake: QT += texttospeech
Наследует: QObject
  • Список всех членов, включая наследуемые

Типы публичного доступа

Перечисление State { Готов, Произносит, Приостановлен, ОшибкаБэкенда }

Свойства

  • locale : QLocale
  • pitch : double
  • rate : double
  • state : const State
  • voice : QVoice
  • volume : int
  • 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API