Jak dostosować powiadomienia o multimediach

François Beaufort
François Beaufort

Interfejs Media Session API pozwala witrynom informować użytkowników o obecnie odtwarzanym utworze w przeglądarce i sterować odtwarzaniem bez konieczności przechodzenia na stronę, która go uruchomiła. Wrażenia użytkownika można dostosować za pomocą metadanych w niestandardowych powiadomieniach o multimediach oraz zdarzeniach związanych z multimediami, takich jak odtwarzanie, wstrzymywanie, przewijanie i zmiana ścieżki. Te dostosowania są dostępne w kilku kontekstach, m.in. w centrach multimediów na komputerze, w powiadomieniach o multimediach na urządzeniach mobilnych, a nawet na urządzeniach do noszenia.

Obsługa przeglądarek

  • 73
  • 79
  • 82
  • 15

Źródło

Zrzuty ekranu przedstawiające kontekst sesji w mediach.
Centrum multimediów na komputerze, powiadomienia o multimediach na urządzeniu mobilnym i urządzenie do noszenia.

Gdy strona odtwarza dźwięk lub obraz, użytkownicy automatycznie otrzymują powiadomienia o multimediach na pasku powiadomień na urządzeniu mobilnym lub w centrum multimediów na komputerze. Przeglądarka dokłada wszelkich starań, aby wyświetlić odpowiednie informacje, korzystając z tytułu dokumentu i największego obrazu ikony, jaki można znaleźć. Interfejs Media Session API umożliwia dostosowanie powiadomień o multimediach za pomocą metadanych rich media, takich jak tytuł, nazwa wykonawcy, nazwa albumu i grafika, jak pokazano poniżej.

Ilustracja przedstawiająca interfejs sesji multimedialnej
Składnia powiadomień o multimediach na urządzeniach mobilnych

Poniższy przykład pokazuje, jak utworzyć niestandardowe powiadomienie o multimediach i reagować na podstawowe działania związane z multimediami, takie jak odtwarzanie i wstrzymywanie.

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

Więcej informacji

Pokaz

<!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>

       
: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%;
}
       

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