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().

См.также

Внешние ссылки