Skip to main content

Type Alias: RemoteVolumeControl

type RemoteVolumeControl = "absolute" | "relative" | "fixed";

Defined in: packages/media-session/src/specs/media-session.nitro.ts:192

How much of the remote device's volume the backend can actually drive.

Maps onto the platform's VolumeProvider control types, which media3 derives from the player's available commands (MediaSessionLegacyStub.createVolumeProviderCompat, media3 1.11.0):

  • absolute — the backend can be told a level and nudged a step (COMMAND_SET_DEVICE_VOLUME + COMMAND_ADJUST_DEVICE_VOLUME → VOLUME_CONTROL_ABSOLUTE). Cast is this. Hardware keys nudge, the system volume dialog's slider sets.
  • relative — steps only (VOLUME_CONTROL_RELATIVE): hardware keys work, the slider does not appear.
  • fixed — the level is readable but not writable (VOLUME_CONTROL_FIXED): the remote surfaces show it and the keys do nothing. An honest state for a receiver whose volume the sender may not touch, and the only one of the three that deliberately leaves the keys dead.