JavaScript:Библиотеки/p5.sound/Класс p5.SoundFile/loadSound(): различия между версиями
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Myagkij (обсуждение | вклад) Нет описания правки |
Нет описания правки |
||
| Строка 14: | Строка 14: | ||
Чтобы использовать эту функцию, нужно подключить библиотеку p5.sound. Для этого в заголовок своего файла «index.html» впишите следующее: | Чтобы использовать эту функцию, нужно подключить библиотеку p5.sound. Для этого в заголовок своего файла «index.html» впишите следующее: | ||
<syntaxhighlight lang="javascript | <syntaxhighlight lang="javascript"> | ||
<script language="javascript" type="text/javascript" src="path/to/p5.sound.js"></script> | <script language="javascript" type="text/javascript" src="path/to/p5.sound.js"></script> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Строка 20: | Строка 20: | ||
==Синтаксис== | ==Синтаксис== | ||
<syntaxhighlight lang="javascript | <syntaxhighlight lang="javascript"> | ||
loadSound(path, [successCallback], [errorCallback], [whileLoading]) | loadSound(path, [successCallback], [errorCallback], [whileLoading]) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Строка 26: | Строка 26: | ||
==Параметры== | ==Параметры== | ||
<syntaxhighlight lang="javascript | <syntaxhighlight lang="javascript"> | ||
path – путь к звуковому файлу или массив путей к нескольким звуковым файлам в разных форматах (например, 'sound.ogg', 'sound.mp3' и т.д.). Кроме того, в этом параметре можно задать объект – либо из HTML5 File API, либо объект p5.File. Тип данных – String, массив | path – путь к звуковому файлу или массив путей к нескольким звуковым файлам в разных форматах (например, 'sound.ogg', 'sound.mp3' и т.д.). Кроме того, в этом параметре можно задать объект – либо из HTML5 File API, либо объект p5.File. Тип данных – String, массив | ||
successCallback – название функции, которую нужно запустить после загрузки файла. Тип данных – функция | successCallback – название функции, которую нужно запустить после загрузки файла. Тип данных – функция | ||
| Строка 35: | Строка 35: | ||
==Возвращаемое значение== | ==Возвращаемое значение== | ||
<syntaxhighlight lang="javascript | <syntaxhighlight lang="javascript"> | ||
Тип данных – объект p5.SoundFile. | Тип данных – объект p5.SoundFile. | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Строка 41: | Строка 41: | ||
==Пример== | ==Пример== | ||
<syntaxhighlight lang="javascript" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS | <syntaxhighlight lang="javascript" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS"> | ||
function preload() { | function preload() { | ||
mySound = loadSound('assets/doorbell.mp3'); | mySound = loadSound('assets/doorbell.mp3'); | ||
Текущая версия от 18:16, 14 мая 2023
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
|
Черновик |
loadSound() [1]
Описание
Возвращает новый объект p5.SoundFile, находящийся по заданному пути. Если вызвать ее в блоке preload(), объект p5.SoundFile уже будет готов к проигрыванию в момент, когда в скетче начнут обрабатываться блоки setup() и draw(). Если вызвать ее за пределами preload(), объект p5.SoundFile будет готов не сразу, но на этот случай loadSound() можно «скормить» в качестве второго параметра функцию обратного вызова, которая будет запущена сразу после того, как завершится загрузка файла. При загрузке внешних файлов рекомендуем использовать локальный сервер.
Чтобы использовать эту функцию, нужно подключить библиотеку p5.sound. Для этого в заголовок своего файла «index.html» впишите следующее:
<script language="javascript" type="text/javascript" src="path/to/p5.sound.js"></script>
Синтаксис
loadSound(path, [successCallback], [errorCallback], [whileLoading])
Параметры
path – путь к звуковому файлу или массив путей к нескольким звуковым файлам в разных форматах (например, 'sound.ogg', 'sound.mp3' и т.д.). Кроме того, в этом параметре можно задать объект – либо из HTML5 File API, либо объект p5.File. Тип данных – String, массив
successCallback – название функции, которую нужно запустить после загрузки файла. Тип данных – функция
errorCallback – название функции, которую нужно запустить, если во время загрузки файла произошла ошибка. Тип данных – функция
whileLoading – название функции, которую нужно запустить во время загрузки файла. Эта функция будет получать информацию о прогрессе загрузки файла (значения в диапазоне от «0.0» до «1.0»). Тип данных – функция
Возвращаемое значение
Тип данных – объект p5.SoundFile.
Пример
function preload() {
mySound = loadSound('assets/doorbell.mp3');
}
function setup() {
mySound.setVolume(0.1);
mySound.play();
}
