Media player

Entity ids in this domain look like media_player.<object_id>.

Use in preferencesCopy Anchor Link

{ key: 'device', label: 'Device', type: 'entity', domainFilter: 'media_player', required: true }

StatesCopy Anchor Link

getState() returns the raw token. subscribe filters, entity.is() and matchesState() also accept the friendly label the app shows (any case; spaces, hyphens and underscores interchangeable).

• playing
• paused
• stopped
• buffering

subscribe($g.device, { to: 'playing' }, onChange);
if ($g.device.is('playing')) { /* … */ }

ServicesCopy Anchor Link

Curated for smart apps (also offered by the wizard action catalog):

await $g.device.mute();

Also routable (MediaPlayerServices), not in the wizard catalog — callable as entity.<service>(); the integration may reject unsupported ones at runtime:

joinGroup, seek, setGroupVolume, unjoinGroup

Device classesCopy Anchor Link

none, tv, speaker, receiver, projector

Filter with deviceClassFilter in an entity input.

FeaturesCopy Anchor Link

Bitmask on the supportedFeatures attribute; read the values with getEntityFeatures().MediaPlayer.