JavaScript:Библиотеки/p5.dom/Класс p5.MediaElement
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
p5.MediaElement [1]
Описание
Этот класс – расширение класса p5.Element для работы с аудио и видео. То есть вдобавок к методам p5.Element он также оснащен методами для управления медиа-файлами. Он не вызывается напрямую, но создается при помощи функций createVideo(), createAudio() и createCapture().
Чтобы использовать этот класс, нужно подключить библиотеку p5.dom. Для этого в заголовке своего файла «index.html» впишите следующее:
<script language="javascript" type="text/javascript" src="path/to/p5.dom.js"></script>
Синтаксис
new p5.MediaElement(elt)
Параметры
elt – DOM-узел, обернутый объектом p5.MediaElement. Тип данных – String
Поля
src – путь к источнику медиа-элемента.
Методы
- play() – проигрывает HTML5-медиаэлемент.
- stop() – останавливает проигрывание HTML5-медиаэлемента и сбрасывает время проигрывания на 0.
- pause() – ставит проигрывание HTML5-медиаэлемента на паузу.
- loop() – задает свойству loop HTML5-медиаэлемента значение true и запускает его проигрывание. Другими словами, задает циклическое проигрывание этого элемента.
- noLoop() – задает свойству loop HTML5-медиаэлемента значение false. В результате, дойдя до конца медиаэлемента, проигрывание остановится.
- autoplay() – задает, будет ли HTML5-медиаэлемент проигрываться автоматически или нет.
- volume() – задает громкость для текущего HTML5-медиаэлемента. Если параметров не задано, возвращает текущую громкость.
- speed() – если параметра не задано, возвращает текущую скорость воспроизведения элемента. Параметр «speed» задает скорость проигрывания: если задать «2.0», элемент воспроизведется с удвоенной скоростью, если «0.5» – в два раза медленнее, а если «-1» – на нормальной скорости, но задом наперед. Имейте в виду, что проигрывание задом наперед поддерживается не всеми браузерами. Кроме того, даже если браузер его поддерживает, проигрывание будет, возможно, недостаточно плавным.
- time() – если параметра не задано, возвращает время, на котором находится курсор проигрывания элемента. Если параметр задан, курсор проигрывания перепрыгнет на это время.
- duration() – возвращает продолжительность HTML5-медиаэлемента.
- onended() – задает событие, вызываемое при завершении проигрывания аудио- или видео-элемента. Если элемент проигрывается циклически, это событие вызвано не будет. Параметром функции обратного вызова должен быть сам проигрываемый элемент.
- connect() – отправляет выходящие аудиоданные элемента заданному интерфейсу audioNode или заданному объекту из библиотеки p5.sound. Если параметра не задано, подключается к главному устройству вывода аудиоданных. Соединение устанавливается при самом первом вызове метода connect(). Все настроенные соединения можно удалить при помощи метода disconnect(). Метод connect() предназначен для использования вместе с библиотекой p5.sound.
- disconnect() – отключает все соединения, настроенные при помощи Web Audio, включая соединение с главным устройством вывода аудиоданных. Можно использовать, например, если вам нужно перенаправить аудио на объекты для генерирования эффектов.
- showControls() – показывает средства управления медиаэлементом, используемые браузером по умолчанию.
- hideControls() – прячет средства управления медиаэлементом, используемые браузером по умолчанию.
- addCue() – задает событие, которое произойдет, когда курсор проигрывания аудио- или видео-элемента достигнет заданной отметки. В качестве параметров указываются время, на котором должна сработать функция обратного вызова (в секундах), сама функция обратного вызова и (опционально) параметр для функции обратного вызова. У функции обратного вызова первый параметр – это время, а второй (опциональный) – это объект.
- removeCue() – удаляет функцию обратного вызова с заданным ID, поставленную с помощью addCue(). Сам ID тоже можно узнать при помощи функции addCue().
- clearCues() – удаляет все функции обратного вызова, поставленные при помощи addCue().
