วิธีปรับแต่งการแจ้งเตือนสื่อ

François Beaufort
François Beaufort

Media Session API ช่วยให้เว็บไซต์แจ้งให้ผู้ใช้ทราบว่ากำลังเล่นอะไรอยู่ในเบราว์เซอร์และควบคุมการเล่นได้โดยไม่ต้องกลับไปที่หน้าที่เปิดการเล่น คุณสามารถปรับแต่งประสบการณ์ของผู้ใช้ผ่านข้อมูลเมตาในการแจ้งเตือนสื่อที่กำหนดเอง เหตุการณ์สื่อ เช่น การเล่น การหยุดชั่วคราว การค้นหา และการเปลี่ยนแทร็ก การปรับแต่งเหล่านี้มีให้ใช้งานในหลายบริบท รวมถึงฮับสื่อในเดสก์ท็อป การแจ้งเตือนสื่อในอุปกรณ์เคลื่อนที่ และแม้แต่ในอุปกรณ์สวมใส่

Browser Support

  • Chrome: 73.
  • Edge: 79.
  • Firefox: 82.
  • Safari: 15.

Source

ภาพหน้าจอของบริบทเซสชันสื่อ
ฮับสื่อในเดสก์ท็อป การแจ้งเตือนสื่อในอุปกรณ์เคลื่อนที่ และอุปกรณ์ที่สวมใส่ได้

เมื่อเว็บไซต์เล่นเสียงหรือวิดีโอ ผู้ใช้จะได้รับการแจ้งเตือนสื่อโดยอัตโนมัติในถาดการแจ้งเตือนบนอุปกรณ์เคลื่อนที่ หรือฮับสื่อในเดสก์ท็อป เบราว์เซอร์จะพยายามอย่างเต็มที่เพื่อแสดงข้อมูลที่เหมาะสมโดยใช้ชื่อของเอกสารและรูปภาพไอคอนที่ใหญ่ที่สุดที่หาได้ Media Session API ช่วยให้คุณปรับแต่งการแจ้งเตือนสื่อด้วยข้อมูลเมตาของสื่อที่สมบูรณ์ยิ่งขึ้น เช่น ชื่อศิลปิน ชื่ออัลบั้ม และภาพปก ดังที่แสดงด้านล่าง

ภาพประกอบอินเทอร์เฟซเซสชันสื่อ
โครงสร้างของการแจ้งเตือนสื่อในอุปกรณ์เคลื่อนที่

ตัวอย่างด้านล่างแสดงวิธีสร้างการแจ้งเตือนสื่อที่กำหนดเองและตอบสนองต่อการดำเนินการสื่อพื้นฐาน เช่น เล่นและหยุดชั่วคราว

const video = document.querySelector("video");

navigator.mediaSession.metadata = new MediaMetadata({
  title: "Never Gonna Give You Up",
  artist: "Rick Astley",
  album: "Whenever You Need Somebody",
  artwork: [
    { src: "https://via.placeholder.com/96",  sizes: "96x96" },
    { src: "https://via.placeholder.com/128", sizes: "128x128" },
    { src: "https://via.placeholder.com/256", sizes: "256x256" },
    { src: "https://via.placeholder.com/512", sizes: "512x512" },
  ],
});

navigator.mediaSession.setActionHandler("play", async () => {
  // Resume playback
  try {
    await video.play();
  } catch (err) {
    console.error(err.name, err.message);
  }
});

navigator.mediaSession.setActionHandler("pause", () => {
  // Pause active playback
  video.pause();
});

video.addEventListener("play", () => {
  navigator.mediaSession.playbackState = "playing";
});

video.addEventListener("pause", () => {
  navigator.mediaSession.playbackState = "paused";
});

อ่านเพิ่มเติม

สาธิต

HTML

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <link
      rel="icon"
      href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>📺</text></svg>"
    />
    <title>How to customize media notifications</title>
  </head>
  <body>
    <h1>How to customize media notifications</h1>
    <video controls playsinline src="https://storage.googleapis.com/media-session/caminandes/short.mp4"></video>
    <p>Credits: Media files are © copyright Blender Foundation | <a href="https://www.blender.org">www.blender.org</a>.</p>
  </body>
</html>

CSS


        :root {
  color-scheme: dark light;
}
html {
  box-sizing: border-box;
}
*,
*:before,
*:after {
  box-sizing: inherit;
}
body {
  margin: 1rem;
  font-family: system-ui, sans-serif;
}
video {
  display: block;
  margin-top: 10px;
  max-width: 100%;
}
        

JS


        const video = document.querySelector("video");

navigator.mediaSession.metadata = new MediaMetadata({
  title: "Caminandes 2: Gran Dillama - Blender Animated Short",
  artist: "Blender Foundation",
  artwork: [
    { src: "https://storage.googleapis.com/media-session/caminandes/artwork-96.png",  sizes: "96x96" },
    { src: "https://storage.googleapis.com/media-session/caminandes/artwork-128.png", sizes: "128x128" },
    { src: "https://storage.googleapis.com/media-session/caminandes/artwork-256.png", sizes: "256x256" },
    { src: "https://storage.googleapis.com/media-session/caminandes/artwork-512.png", sizes: "512x512" },
  ],
});

navigator.mediaSession.setActionHandler("play", async () => {
  // Resume playback
  try {
    await video.play();
  } catch (err) {
    console.error(err.name, err.message);
  }
});

navigator.mediaSession.setActionHandler("pause", () => {
  // Pause active playback
  video.pause();
});

video.addEventListener("play", () => {
  navigator.mediaSession.playbackState = "playing";
});

video.addEventListener("pause", () => {
  navigator.mediaSession.playbackState = "paused";
});