Оглавление | Родительский раздел

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

СредстваМультимедиа (MultimediaTools)
ВоспроизвестиАудио (PlayAudio)

Синтаксис:

ВоспроизвестиАудио(<Аудио>, <НачальнаяПозиция>, <ОбработчикОстановкиВоспроизведения>, <РазрешитьФоновое>)

Параметры:

<Аудио> (обязательный)

Тип: ДанныеМультимедиа; ДвоичныеДанные; Строка.
Данные аудиозаписи в памяти в виде объекта ДанныеМультимедиа, ДвоичныеДанные, либо путь к аудиофайлу в файловой системе.
На iOS и Android в качестве пути может принимать ссылку со схемой "content:" на аудиофайл в мультимедиа библиотеке.
Если двоичные данные не содержат аудиозапись в поддерживаемом формате или указан путь не к аудиофайлу, будет сгенерировано исключение "Указанный тип данных не поддерживается".

<НачальнаяПозиция> (необязательный)

Тип: Число.
Секунда, с которой требуется начать воспроизведение. Если указанное число является отрицательным или секунда находится за пределом длительности аудио, то будет вызвано исключение.

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

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

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

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

Описание:

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

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

Мобильный клиент, мобильное приложение(клиент).
Оглавление | Родительский раздел Платформа 8.3.13.1809