Аудиоплеер

Проверка готовности аудиоплеера

Для проверки готовности аудиоплеера можно воспользоваться функцией initPromise(). Эта функция работает в асинхронном режиме и возвращает объект-обещание, который разрешается при успешной инициализации плеера и отклоняется при возникновении ошибки.

// Проверка на готовность плеера.
audioPlayer.initPromise().then(function() {
    console.log("Аудиоплеер готов к работе.");
}, function() {
    console.error("Не удалось инициализировать аудиоплеер.");
});

Запуск воспроизведения

После создания плеера можно запустить воспроизведение какого-нибудь аудиофайла. Для этого нужно вызвать функцию play(), указав URL файла:

// Запуск воспроизведения.
audioPlayer.play('http://my-host.ru/track.mp3').then(function() {
    console.log("Аудиоплеер начал воспроизведение.");
}, function (err) {
    console.log("При воспроизведении возникла ошибка.");
});

Пауза

Поставить воспроизведение на паузу можно с помощью pause():

// Пауза.
audioPlayer.pause().then(function () {
    console.log("Воспроизведение поставлено на паузу.");
}, function (err) {
    console.log("Ошибка при попытке поставить плеер на паузу.");
});

Снять с паузы

Для снятия плеера с паузы предназначена функция resume():

// Снятие плеера с паузы.
audioPlayer.resume().then(function () {
    console.log("Возобновление воспроизведения.");
}, function (err) {
    console.log("Ошибка при обновлении воспроизведения.");
}); 

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

Чтобы остановить воспроизведение и прекратить загрузку аудиофайла, следует вызвать функцию stop():

// Остановка воспроизведения и прерывание загрузки аудиофайла.   
audioPlayer.stop().then(function () {
    console.log("Воспроизведение и загрузка файла остановлены.");
}, function (err) {
    console.log("Ошибка при остановке загрузки файла.");
});

Повторно воспроизвести файл

Функция restart() позволяет повторно воспроизвести файл с начала, не загружая его заново:

// Повторное воспроизведение аудиофайла.
audioPlayer.restart.then(function () {
    console.log("Началось воспроизведение.");
}, function (err) {
    console.log("Ошибка воспроизведения.");
}); 

Установить позицию воспроизведения

Задать новую позицию воспроизведения можно с помощью функции setPosition():

// Установить новую позицию воспроизведения.
audioPlayer.setPosition(position);  

Получение информации о воспроизведении

Для получения информации о воспроизведении API предоставляет следующие методы:

console.log("Ссылка на текущий аудиофайл: ", audioPlayer.getSrc());    
console.log("Длительность файла: ", audioPlayer.getDuration());    
console.log("Текущая позиция воспроизведения: ", audioPlayer.getPosition());
console.log("Длительность загруженной части: ", audioPlayer.getLoaded());    
console.log("Общее время воспроизведения аудиофайла: ", audioPlayer.getPlayed());
console.log("Статус воспроизведения: ", audioPlayer.getState());
console.log("Текущее значение громкости: ", audioPlayer.getVolume());

Полный список методов для работы с аудиоплеером приведен в справочнике.