JavaScript:Библиотеки/p5.dom/createAudio(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
 
Нет описания правки
 
Строка 14: Строка 14:
Чтобы воспользоваться этой функцией, необходимо подключить библиотеку p5.dom. Для этого в заголовке своего файла «index.html» впишите следующее:
Чтобы воспользоваться этой функцией, необходимо подключить библиотеку p5.dom. Для этого в заголовке своего файла «index.html» впишите следующее:


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript">
<script language="javascript" type="text/javascript" src="path/to/p5.dom.js"></script>
<script language="javascript" type="text/javascript" src="path/to/p5.dom.js"></script>
</syntaxhighlight>
</syntaxhighlight>
Строка 20: Строка 20:
==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript">
createAudio([src], [callback])
createAudio([src], [callback])
</syntaxhighlight>
</syntaxhighlight>
Строка 26: Строка 26:
==Параметры==
==Параметры==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript">
src      – путь к аудиофайлу или массив путей к аудиофайлам для поддержки разных браузеров. Тип данных – String, String[]
src      – путь к аудиофайлу или массив путей к аудиофайлам для поддержки разных браузеров. Тип данных – String, String[]
callback – функция обратного вызова, вызываемая после срабатывания события canplaythrough, то есть после того, как браузер понял, что загрузил достаточно данных для проигрывания аудиофайла до конца без необходимости останавливаться для дальнейшей буферизации контента. Тип данных – объект
callback – функция обратного вызова, вызываемая после срабатывания события canplaythrough, то есть после того, как браузер понял, что загрузил достаточно данных для проигрывания аудиофайла до конца без необходимости останавливаться для дальнейшей буферизации контента. Тип данных – объект
Строка 33: Строка 33:
==Возвращаемое значение==
==Возвращаемое значение==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript">
Указатель на объект с аудио. Тип данных – p5.MediaElement, p5.Element.
Указатель на объект с аудио. Тип данных – p5.MediaElement, p5.Element.
</syntaxhighlight>
</syntaxhighlight>
Строка 39: Строка 39:
==Пример==
==Пример==


<syntaxhighlight lang="javascript" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
<syntaxhighlight lang="javascript" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS">
var ele;
var ele;
function setup() {
function setup() {

Текущая версия от 18:14, 14 мая 2023

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Черновик


createAudio() [1]

Описание

Создает в DOM элемент <audio> для проигрывания аудио. Если указан узел контейнера, присоединяется к нему, если нет – присоединяется к «телу» (<body>). Первый параметр может быть либо одним строковым путем к аудиофайлу, либо массивом строковых путей к разным форматам одного и того же аудиофайла. Это может пригодиться для того, чтобы ваше аудио проигрывалось во всех возможных браузерах, т.к. каждый из них поддерживает разные форматы. Более подробно о поддерживаемых форматах аудио читайте тут.

Чтобы воспользоваться этой функцией, необходимо подключить библиотеку p5.dom. Для этого в заголовке своего файла «index.html» впишите следующее:

<script language="javascript" type="text/javascript" src="path/to/p5.dom.js"></script>

Синтаксис

createAudio([src], [callback])

Параметры

src       путь к аудиофайлу или массив путей к аудиофайлам для поддержки разных браузеров. Тип данных  String, String[]
callback  функция обратного вызова, вызываемая после срабатывания события canplaythrough, то есть после того, как браузер понял, что загрузил достаточно данных для проигрывания аудиофайла до конца без необходимости останавливаться для дальнейшей буферизации контента. Тип данных  объект

Возвращаемое значение

Указатель на объект с аудио. Тип данных  p5.MediaElement, p5.Element.

Пример

var ele;
function setup() {
  ele = createAudio('assets/beat.mp3');

  // здесь мы задаем автоматическое проигрывание элемента;
  // элемент начнет проигрываться сразу же, как будет готов:
  ele.autoplay(true);
}

См.также

Внешние ссылки