Ion.Sound 3.0.7
JavaScript Web Audio плагин для воспроизведения звуков или музыки в браузерах

Обратная связь и поддержка

В случае обнаружения багов или недочетов в плагинах, воспользуйтесь разделом Issues в репозитории на GitHub

Поддержать

Поддержите разработку ion.RangeSlider «Патреон»
Bitcoin 13vdgT6EoAVupdGuLhE4ABW245NTixAj1G

Реклама

Описание

  • Ion.Sound — JavaScript-плагин для воспроизведения звуков, основанный на Web Audio API.
  • Плагин отлично работает на всех десктопных и мобильных браузерах и может быть испльзован как на обычных веб сайтах, так и в играх.
  • Для более старых браузеров плагин использует HTML5 audio.
  • Плагин поддерживает работу с айдио-спрайтами
  • Репозиторий на GitHub.
  • Плагин свободно распространяется на условиях лицензии MIT.
  • 25 бесплатных звуковых файлов включены в архив

Сегодня веб-сайты переполнены событиями (новое письмо, новое сообщение в чат, обновление контента и т.п.). Часто не достаточно одной визуальной индикации этих событий, что бы привлечь внимание пользователя. Необходимы звуки! В этом деле вам поможет этот плагин.

Так же новая версия Ion.Sound теперь отлично подходит для создания звукового сопровождения браузерных игр. Контроль загрузки аудио ресурсов, поддержка аудио-спрайтов и пр. помогут вам в этом.

Попробуйте:

Поддерживаемые браузеры

Desktop Windows, OS X, Linux:

  • Google Chrome
  • Mozilla Firefox
  • Microsoft Internet Explorer 9.0+
  • Opera 12.16+
  • Safari 5.1+ (Safari на Windows требует установленный QuickTime для воспроизведения звуков)

Mobile:

  • iOS Safari и другие (с некоторыми ограничениями)
  • Android Google Chrome и другие (тоже с некоторыми ограничениями)
  • WP8 Internet Explorer

Can i use Web Audio API and HTML5 Audio?

Демо

Зависимости

  • Отсутствуют

Использование

Подключаем библиотеку:
  • ion.sound.min.js
Готовим звуковые файлы (25 звуков включены в поставку) и складываем их в какую-либо папку (например "sounds"):
  • my_cool_sound.mp3
  • my_cool_sound.ogg
  • my_cool_sound.aac

Помимо MP3-файла, нужно так же подготовить OGG и AAC-файл, так как не все браузеры поддерживают MP3.
Конвертировать MP3 в OGG и AAC можно на Media.io или на CloudConvert.org.
Поддержка формата AAC была добавлена для улучшения совместимости с iOS 8.x устройствами (iPhone, iPad)

Устанавливаем с помощью bower

  • bower install ionsound

Устанавливаем с помощью spm   spm

  • spm install ion-sound

Инициализация

Подключаем плагин

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 Вызывается каждый раз, когда воспроизведение аудио файла подошло к концу

Sound object

Атрибут По умолчанию Тип Описание
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

Возможность запуска в jQuery окружении:

  • Все методы плагины можно вызывать используя синонимы: ion.sound(); -> $.ionSound();
  • ion.sound.play("sound_name"); -> $.ionSound.play("sound_name");
  • И т.д.

Скачать

Поддержать

Поделиться

comments powered by Disqus
Fork me on GitHub