JavaScript:Библиотеки/p5.sound/Класс p5.SoundFile/loadSound()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

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


Черновик


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();
}

См.также

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