Skip to content

Latest commit

 

History

History
30 lines (19 loc) · 2.36 KB

use_cases.md

File metadata and controls

30 lines (19 loc) · 2.36 KB
Raw

Use Cases of the MediaSession API

Broadly, we want to support the following use cases:

Keyboard media keys

Keyboards may have play/pause, stop, rewind and fast forward keys. (Apple, Corsair)

  • While watching a video or listening to audio in the background, pause and resume playback using the play/pause key.
  • While watching a video playlist or listening to a music playlist, skip between videos/tracks using the rewind and fast forward keys.
  • While listening to a podcast, skip backward and forward ~10 seconds using the rewind and fast forward keys.

Headphone buttons

Headphones may have a multi-purpose button and volume buttons. (Apple, Samsung)

The headphone button should mostly function like a keyboard's play/pause key. Additionally:

  • While watching a video, turn off the screen. The audio continues to play and can be paused and resumed with the headphone button.
  • Double tap and other key sequences may follow platform-specific conventions. (iPhone)

Lock screen and notification area

PCs, phones and tablets may have media controls on the lock screen. (Windows, iOS, Android) Applications may also have media controls in the notification area, which are very similar to lock screen controls but can be dismissed. (Android)

The play/pause button should function like a keyboard's play/pause key. Where supported, the web application should be able to control:

  • Whether rewind and fast forward buttons appear and their behavior.
  • Title and subtitle, e.g. artist name and track title.
  • Background image, e.g. album art.
  • Any additional buttons, e.g. like/favorite.