YandexAudio — JavaScript-библиотека, предназначенная для воспроизведения аудиоданных в браузере. Работа YandexAudio базируется на технологиях html5 audio и flash. Библиотека предоставляет удобный интерфейс для добавления этих технологий на страницу и управления их настройками. При этом YandexAudio решает основные проблемы, связанные с использованием audio и flash – неполная поддержка браузерами, трудная отладка ошибок и др.
Основные возможности YandexAudio:
Существует 2 способа подключения данной библиотеки:
var YandexAudio = require('YandexAudio'); var audioPlayer = new ya.music.Audio(preferredPlayerType, flashOverlayElement);
audioPlayer.initPromise().then(function() {
console.log("Аудио-плеер готов к работе");
}, function() {
console.error("Не удалось инициализировать аудио-плеер");
});"html5", "flash" или любое ложное значение (false, null, undefined, 0, ""). Если выбранный тип плеера окажется недоступен, будет запущен оставшийся тип. Если параметр не передан, либо указано ложное значение, то API автоматически выберет поддерживаемый тип плеера. audioPlayer.play(src).then(function() {
console.log("Воспроизведение успешно началось");
}, function(err) {
console.error("Не удалось начать воспроизведенние", err);
}); audioPlayer.pause(); // пауза
audioPlayer.resume(); // продолжение воспроизведения
audioPlayer.stop(); // остановка воспроизведения и загрузки трека
console.log("Ссылка на текущий трек", audioPlayer.getSrc());
console.log("Длительность трека", audioPlayer.getDuration());
console.log("Текущая позиция воспроизведения", audioPlayer.getPosition());
console.log("Длительность загруженной части", audioPlayer.getLoaded());
console.log("Время воспроизведения трека", audioPlayer.getPlayed());
console.log("Новая позиция воспроизведения", audioPlayer.setPosition(position)); audioPlayer.on(ya.music.Audio.EVENT_STATE, function(state) {
switch(state) {
case ya.music.Audio.STATE_INIT: console.log("Инициализация плеера"); break;
case ya.music.Audio.STATE_IDLE: console.log("Плеер готов и ожидает"); break;
case ya.music.Audio.STATE_PLAYING: console.log("Плеер проигрывает музыку"); break;
case ya.music.Audio.STATE_PAUSED: console.log("Плеер поставлен на паузу"); break;
case ya.music.Audio.STATE_CRASHED: console.log("Не удалось инициализировать плеер"); break;
}
});
var logEvent = function(text) { return function(data) { console.log(text, data); }; };
audioPlayer.on(ya.music.Audio.EVENT_PLAY, logEvent("Плеер начал воспроизведение трека"));
audioPlayer.on(ya.music.Audio.EVENT_STOP, logEvent("Остановка воспроизведения"));
audioPlayer.on(ya.music.Audio.EVENT_PAUSE, logEvent("Пауза воспроизведения"));
audioPlayer.on(ya.music.Audio.EVENT_PROGRESS, logEvent("Обновление позиции воспроизведения"));
audioPlayer.on(ya.music.Audio.EVENT_ENDED, logEvent("Воспроизведение трека завершено"));
audioPlayer.on(ya.music.Audio.EVENT_LOADING, logEvent("Трек начал загружаться"));
audioPlayer.on(ya.music.Audio.EVENT_LOADED, logEvent("Трек загружен полностью"));
audioPlayer.on(ya.music.Audio.EVENT_VOLUME, logEvent("Изменение громкости"));
audioPlayer.on(ya.music.Audio.EVENT_ERROR, logEvent("Возникла ошибка при воспроизведении"));
audioPlayer.on(ya.music.Audio.EVENT_CRASHED, logEvent("Крах инициализации"));
audioPlayer.on(ya.music.Audio.EVENT_SWAP, logEvent("Переключение между текущим и предзагруженным треком"));В большинство команд управления можно передать вторым аргументом 1, чтобы они применялись к прелоадеру вместо текущего плеера.
Для прослушивания событий плероадера следует использовать префикс ya.music.Audio.PRELOADER_EVENT.
// Следует обратить внимание, что обещание разрешится, когда трек начал загружаться, а не когда загрузился
audioPlayer.preload(src).then(function() {
console.log("Началась предзагрузка трека");
}, function(err) {
console.error("Ну удалось начать загрузку трека", err);
});
audioPlayer.playPreloaded().then(function() {
console.log("Воспроизведение успешно началось");
}, function(err) {
console.error("Не удалось начать воспроизведенние", err);
});
audioPlayer.stop(1); // остановка загрузки трека
console.log("Ссылка на текущий трек", audioPlayer.getSrc(1));
console.log("Длительность трека", audioPlayer.getDuration(1));
console.log("Длительность загруженной части", audioPlayer.getLoaded(1));
// Два похожих метода, но первый является сахаром для audioPlayer.getSrc(1) == src, а второй проверяет успех начала загрузки
console.log("Трек " + (audioPlayer.isPreloading(src) ? "загружается/ожидает загрузки" : "не загружается"));
console.log("Трек " + (audioPlayer.isPreloaded(src) ? "начал загружаться" : "не загружается"));
var logEvent = function(text) { return function(data) { console.log(text, data); }; };
audioPlayer.on(ya.music.Audio.PRELOADER_EVENT + ya.music.Audio.EVENT_STOP, logEvent("Остановка загрузки"));
audioPlayer.on(ya.music.Audio.PRELOADER_EVENT + ya.music.Audio.EVENT_PROGRESS, logEvent("Процесс загрузки"));
audioPlayer.on(ya.music.Audio.PRELOADER_EVENT + ya.music.Audio.EVENT_LOADING, logEvent("Трек начал загружаться"));
audioPlayer.on(ya.music.Audio.PRELOADER_EVENT + ya.music.Audio.EVENT_LOADED, logEvent("Трек загружен полностью"));
audioPlayer.on(ya.music.Audio.PRELOADER_EVENT + ya.music.Audio.EVENT_ERROR, logEvent("Возникла ошибка при загрузке"));