services/media_session/README.md

   1 # Media Session
   2
   3 Media Session manages the media session and audio focus for playback across the
   4 entire system.
   5
   6 Clients can use the Audio Focus API to request audio focus and observe changes
   7 through AudioFocusObserver. The Media Session API can be used to control
   8 playback and observe changes through MediaSessionObserver.
   9
  10 For more details about controlling playback see [controlling Media Playback](https://chromium.googlesource.com/chromium/src/+/master/services/media_session/controlling_media_playback.md).
  11
  12 TODO(beccahughes): Write docs about requesting audio focus.
  13
  14 ## Media Session IDs
  15
  16 The Media Session service uses base::UnguessableToken for a number of different
  17 reasons, these are:
  18
  19 * Request IDs: These identify a single media session
  20 * Group IDs: These group together a number of media sessions that should share
  21   focus, this is usually per-app.
  22 * Source IDs: These identity a user/profile that created a media session
  23
  24 Every media session has its own unique request ID and it may also have a group
  25 ID and a source ID.