JavaScript:Библиотеки/p5.dom/Класс p5.MediaElement/addCue()

Содержание

Резерв

Резерв

Резерв

Резерв

Резерв

Библиотеки

Резерв

Резерв

Резерв

Перевод: Максим Кузьмин

Проверка/Оформление/Редактирование: Мякишев Е.А.

addCue()

Описание

Задает событие, которое должно будет происходить каждый раз, когда проигрывание медиаэлемента (аудио- или видео-элемента) дойдет до заданной отметки.

Параметрами для addCue() служат функция обратного вызова, вызываемая при достижении заданной отметки, а также время (в секундах), при достижении которого запускается функция обратного вызова, и опциональный параметр для функции обратного вызова.

У функции обратного вызова первый параметр – это время, а второй (опциональный) – это объект. Чтобы воспользоваться этой функцией, необходимо подключить библиотеку p5.dom. Для этого в заголовок своего файла «index.html» впишите следующее:

<script language="javascript" type="text/javascript" src="path/to/p5.dom.js"></script>

Синтаксис

addCue(time, callback, [value])

Параметры

time – отметка времени в медиаэлементе (в секундах). К примеру, чтобы событие запустилось на второй секунде проигрывания элемента, задайте в этом параметре «2». Служит также первым параметром для функции обратного вызова. Тип данных – number
callback – название функции, которая будет вызвана в момент, когда проигрывание файла дойдет до отметки, заданной в первом параметре time. Использует два параметра: время и (опционально) объект. Тип данных – функция
value – объект, который используется в качестве второго параметра для функции обратного вызова. Тип данных – объект

Возвращаемое значение

ID отметки, используемый для функции removeCue(). Тип данных – number.

Пример

function setup() {
  background(255, 255, 255);

  var audioEl = createAudio('assets/beat.mp3');
  audioEl.showControls();

  // шесть раз вызываем функцию changeBackground():
  audioEl.addCue(0.5, changeBackground, color(255, 0, 0));
  audioEl.addCue(1.0, changeBackground, color(0, 255, 0));
  audioEl.addCue(2.5, changeBackground, color(0, 0, 255));
  audioEl.addCue(3.0, changeBackground, color(0, 255, 255));
  audioEl.addCue(4.2, changeBackground, color(255, 255, 0));
  audioEl.addCue(5.0, changeBackground, color(255, 255, 0));
}

function changeBackground(val) {
  background(val);
}