Speaker Device
Device Category: speaker
The Speaker device represents an audio output system capable of producing sound and potentially supporting media playback and input functionality.
Required Channels
These channels are mandatory for the functionality of the speaker:
| Channel | Description | Multiple | Details |
|---|---|---|---|
speaker | Controls speaker devices, including volume, mute state, and audio output modes. | Yes | See details |
device_information | Provides metadata about the device, including manufacturer details, model information, and operational statuses. | No | See details |
Optional Channels
These channels are optional and provide additional features:
| Channel | Description | Multiple | Details |
|---|---|---|---|
switcher | Optional power control for speakers/soundbars when supported (hard power / standby). | No | See details |
electrical_energy | Measures the total energy consumption over time, typically reported in kilowatt-hours (kWh). | No | See details |
electrical_power | Reports real-time power metrics such as voltage, current, and wattage for monitoring and diagnostics. | No | See details |
media_input | Manages the input sources of multimedia devices like TVs, projectors, or audio receivers. | No | See details |
media_playback | Provides playback controls for multimedia devices, excluding volume control. | No | See details |
Use Case Scenarios
-
Audio Output:
- Control volume, mute state, and audio modes using the speaker channel. Support for multiple speaker zones.
-
Media Playback:
- Play audio content with optional media_playback channel. Switch between input sources with media_input.
-
Power Management:
- Control speaker power state with optional switcher channel.
Developer Notes
- The speaker channel is required and supports multiple instances.
- Media playback and input channels are optional for smart speakers.
- Switcher provides power control when available.
Last updated on