СредстваМультимедиа.ВоспроизвестиТекст (MultimediaTools.PlayText)

СредстваМультимедиа (MultimediaTools)

ВоспроизвестиТекст (PlayText)

Доступен, начиная с версии 8.3.9.

Синтаксис:

ВоспроизвестиТекст(<Текст>, <Язык>, <Скорость>, <Тембр>, <ОбработчикОстановкиВоспроизведения>, <РазрешитьФоновое>)

Параметры:

<Текст> (обязательный)

Тип: Строка.
Текст, который требуется воспроизвести.

<Язык> (необязательный)

Тип: Строка, ОбъектМетаданных: Язык.
Идентификатор языка согласно стандарту BCP 47 (например, "en-US" для английского или "ru-RU" для русского). Если не указан, то проверяется возможность произнести текст на текущем языке операционной системы. Если идентификатор указан с ошибкой, либо выбранный язык не поддерживается в системе, будет сгенерировано исключение.

<Скорость> (необязательный)

Тип: Число.
Скорость воспроизведения текста в интервале от 0.5 до 2.0.
Значение по умолчанию: 1.0.

<Тембр> (необязательный)

Тип: Число.
Смещение тембра голоса в интервале от 0.5 до 2.0.
Значение по умолчанию: 1.0.

<ОбработчикОстановкиВоспроизведения> (необязательный)

Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана при остановке или прерывании воспроизведения текста со следующими параметрами:

<Дополнительно> - значение, которое было указано при создании объекта ОписаниеОповещения.

<РазрешитьФоновое> (необязательный)

Тип: Булево.
Разрешает воспроизведение текста в фоне.
Значение по умолчанию: Ложь.

Описание:

Воспроизвести заданный текст с помощью синтезатора речи на устройстве.
Если стороннее приложение воспроизводит звук или выполняется метод ВоспроизвестиАудио, воспроизведение звука будет остановлено, после чего будет воспроизведен текст.
Если во время произношения текста на мобильное приложение приходит системное уведомление, или с помощью метода ВоспроизвестиЗвуковоеОповещение инициируется звуковое оповещение, то мобильная платформа должна приостановить воспроизведение текста и продолжить его после завершения звука уведомления, с позиции, на которой воспроизведение было остановлено.
Данный метод поддерживается не на всех устройствах. Для проверки совместимости устройства, перед вызовом метода следует использовать метод ПоддерживаетсяАудиозапись.

Доступность:

Мобильный клиент, мобильное приложение (клиент).

Примечание:

Если в момент вызова метода, уже воспроизводится текст, воспроизведение будет прервано и начнется воспроизведение нового текста. Обработчик завершения для предыдущего воспроизведения текста вызван не будет.

См. также:

СредстваМультимедиа, метод ПоддерживаетсяАудиозапись

Использование в версии:

Доступен, начиная с версии 8.3.9.

Методическая информация