В случае обнаружения багов или недочетов в плагинах, воспользуйтесь разделом 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 |