
В случае обнаружения багов или недочетов в плагинах, воспользуйтесь разделом Issues в репозитории на GitHub
Сегодня веб-сайты переполнены событиями (новое письмо, новое сообщение в чат, обновление контента и т.п.). Часто не достаточно одной визуальной индикации этих событий, что бы привлечь внимание пользователя. Необходимы звуки! В этом деле вам поможет этот плагин.
Так же новая версия Ion.Sound теперь отлично подходит для создания звукового сопровождения браузерных игр. Контроль загрузки аудио ресурсов, поддержка аудио-спрайтов и пр. помогут вам в этом.
Попробуйте:
Can i use Web Audio API and HTML5 Audio?
Помимо MP3-файла, нужно так же подготовить OGG и AAC-файл, так как не все браузеры поддерживают MP3.
Конвертировать MP3 в OGG и AAC можно на Media.io или на CloudConvert.org.
Поддержка формата AAC была добавлена для улучшения совместимости с iOS 8.x устройствами (iPhone, iPad)
Подключаем плагин
ion.sound({
sounds: [
{
name: "my_cool_sound"
},
{
name: "notify_sound",
volume: 0.2
},
{
name: "alert_sound",
volume: 0.3,
preload: false
}
],
volume: 0.5,
path: "sounds/",
preload: true
});
Играем звук:
// Самый простой вызов
ion.sound.play("my_cool_sound");
Если вы новичок в веб разработке и не уверены
как правильно подключить этот плагин на вашу страницу, то скачайте вот
этот демо пример
| Атрибут | По умолчанию | Тип | Описание |
|---|---|---|---|
| sounds | - | array | Коллекция звуковых объектов. Каждый из объектов содержит информацию о подключаемом звуковом файле и (опционально) индивидуальные настройки. |
| path | - | string | Путь к файлу |
| preload | false | boolean | Предзагрузка звуков |
| multiplay | false | boolean | Множественное воспроизведение. Если включен, то звук можно будет воспроизводить неограниченно часто. |
| loop | false | boolean/number | Можно установить как в true, для бесконечного повтора, либо задать числом желаемое кол-во повторов. |
| volume | 1.0 | number | Громкость звука от 0 до 1 |
| scope | null | object | Объект, в контексте которого нужно вызывать коллбэки |
| ready_callback | null | function | Вызывается после завершения загрузки аудио файла (или готовности к воспроизведению у HTML5 audio) |
| ended_callback | null | function | Вызывается каждый раз, когда воспроизведение аудио файла подошло к концу |
| Атрибут | По умолчанию | Тип | Описание |
|---|---|---|---|
| name | - | string | Имя файла в директории. Плагин сам выберет поддерживаемое расширение файла (.mp3, .ogg, .aac, .mp4 и т.д.) |
| alias | - | string | Синоним для вызова звука, не обязателен, нужен для краткости вызовов. |
| sprite | - | object |
Указатель на то, что звук является аудио-спрайтом.
Представляет из себя объект вида {"part_name_1": [0, 2], "part_name_2": [2, 2]}Где part_name - это имя кусочка спрайта (по этому имени его можно будет вызывать в дальнейшем) и массив с временными указателями: [начало, длина] в секундах. |
| А так же свои собственные: path, preload, multiplay, loop, volume, scope and callbacks | |||