MediaSession: метод setPositionState()

Метод setPositionState() интерфейса MediaSession используется для обновления текущей позиции и скорости воспроизведения медиа в документе для отображения устройством пользователя в любом интерфейсе, отображающем информацию о текущем воспроизведении. Это особенно полезно, если ваш код реализует проигрыватель для типа медиа, не поддерживаемого браузером напрямую.

Вызывайте этот метод на объекте mediaSession объекта navigator.

stateDict Необязательно

Объект, предоставляющий обновлённую информацию о позиции и скорости воспроизведения текущего медиа. Если объект пуст, существующая информация о состоянии воспроизведения очищается. Этот объект может содержать следующие параметры:

duration Необязательно

Значение с плавающей точкой, представляющее полную продолжительность текущего медиа в секундах. Это значение всегда должно быть положительным, положительная бесконечность (Infinity) указывает на медиа без определённого конца, например, прямую трансляцию.

playbackRate Необязательно

Значение с плавающей точкой, указывающее скорость воспроизведения медиа в отношении его нормальной скорости. Таким образом, значение 1 соответствует нормальной скорости, 2 — удвоенной скорости и т. д. Отрицательные значения указывают на обратное воспроизведение; -1 — воспроизведение с нормальной скоростью, но в обратном направлении, -2 — в два раза быстрее в обратном направлении и т. д.

position Необязательно

Значение с плавающей точкой, указывающее последнюю зарегистрированную позицию воспроизведения медиа в секундах. Это значение всегда должно быть положительным.

None (undefined).

TypeError

Эта ошибка может возникнуть в следующих ситуациях:

• У указанного объекта отсутствует duration, он отрицательный или null.
• Его position отрицательное или больше, чем duration.
• Его playbackRate равно нулю.

Ниже представлена функция, обновляющая состояние позиции текущего трека MediaSession.

function updatePositionState() {
  navigator.mediaSession.setPositionState({
    duration: audioEl.duration,
    playbackRate: audioEl.playbackRate,
    position: audioEl.currentTime,
  });
}

Мы можем использовать эту функцию при обновлении MediaMetadata и внутри обратных вызовов для действий, как показано ниже.

navigator.mediaSession.setActionHandler("seekbackward", (details) => {
  // our time to skip
  const skipTime = details.seekOffset || 10;

  // set our position
  audioEl.currentTime = Math.max(audioEl.currentTime - skipTime, 0);
  updatePositionState();
});