Media Session API ช่วยให้เว็บไซต์แจ้งให้ผู้ใช้ทราบว่ากำลังเล่นอะไรอยู่ในเบราว์เซอร์ และควบคุมเบราว์เซอร์ได้โดยไม่ต้องกลับไปยังหน้าที่เปิด ประสบการณ์ของผู้ใช้สามารถปรับแต่งได้ผ่านข้อมูลเมตาในการแจ้งเตือนสื่อแบบกำหนดเอง เหตุการณ์เกี่ยวกับสื่อ เช่น การเล่น หยุดชั่วคราว กรอวิดีโอ และการเปลี่ยนแปลงแทร็ก การปรับแต่งเหล่านี้พร้อมใช้งานในหลายๆ บริบท รวมถึงฮับสื่อบนเดสก์ท็อป การแจ้งเตือนสื่อบนอุปกรณ์เคลื่อนที่ หรือแม้แต่ในอุปกรณ์ที่สวมใส่ได้
เมื่อเว็บไซต์เล่นเสียงหรือวิดีโอ ผู้ใช้จะได้รับการแจ้งเตือนสื่อโดยอัตโนมัติในถาดการแจ้งเตือนในอุปกรณ์เคลื่อนที่หรือฮับสื่อบนเดสก์ท็อป เบราว์เซอร์จะดำเนินการอย่างดีที่สุดในการแสดงข้อมูลที่เหมาะสมโดยใช้ชื่อเอกสารและภาพไอคอนที่ใหญ่ที่สุดที่สามารถหาได้ 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";
});
อ่านเพิ่มเติม
- ข้อกำหนดเซสชันสื่อของ W3C
- ปรับแต่งการแจ้งเตือนสื่อและการควบคุมการเล่นด้วย Media Session API
- MDN Media Session API
ข้อมูลประชากร
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";
});