MediaSession: phương thức setPositionState()

Cú pháp

setPositionState()
setPositionState(stateDict)

Tham số

stateDict Optional

Một đối tượng cung cấp thông tin cập nhật về vị trí phát lại và tốc độ của phương tiện đang phát của tài liệu. Nếu đối tượng rỗng, thông tin trạng thái phát lại hiện có sẽ bị xóa. Đối tượng này có thể chứa các tham số sau:

duration Optional

Giá trị dấu phẩy động cho biết tổng thời lượng của phương tiện hiện tại tính bằng giây. Luôn phải là số dương, với vô cực dương (Infinity) cho biết phương tiện không có điểm kết thúc xác định, chẳng hạn như luồng trực tiếp.

playbackRate Optional

Giá trị dấu phẩy động cho biết tốc độ phát lại phương tiện, theo tỷ lệ so với tốc độ phát lại bình thường. Giá trị 1 là phát ở tốc độ bình thường, 2 là phát ở tốc độ gấp đôi, v.v. Giá trị âm cho biết phương tiện đang phát ngược; -1 cho biết phát ở tốc độ bình thường nhưng ngược lại, -2 là tốc độ gấp đôi theo chiều ngược lại, v.v.

position Optional

Giá trị dấu phẩy động cho biết vị trí phát lại được báo cáo gần nhất của phương tiện tính bằng giây. Phải luôn là giá trị dương.

Giá trị trả về

Không có (undefined).

Ngoại lệ

TypeError

Lỗi này có thể xảy ra trong một số trường hợp:

• duration của đối tượng được chỉ định bị thiếu, âm hoặc null.
• position của nó là âm hoặc lớn hơn duration.
• playbackRate của nó bằng không.

Ví dụ

Dưới đây là hàm cập nhật trạng thái vị trí của bài hát MediaSession hiện tại.

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

Chúng ta có thể sử dụng hàm này khi cập nhật MediaMetadata và trong các callback cho các hành động, chẳng hạn như dưới đây.

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();
});

Thông số kỹ thuật

Tương thích trình duyệt