From 18f069fbc1f06eed2e490663df200113f76ae6f3 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Thu, 12 Sep 2024 09:36:32 +0200
Subject: [PATCH] Media player: add states (#34692)

---
 source/_integrations/media_player.markdown | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/source/_integrations/media_player.markdown b/source/_integrations/media_player.markdown
index 10790ef7ea5..b777d47aaf9 100644
--- a/source/_integrations/media_player.markdown
+++ b/source/_integrations/media_player.markdown
@@ -20,6 +20,18 @@ Interacts with media players on your network.
 
 {% include integrations/building_block_integration.md %}
 
+## The state of a media player
+
+A media player can have the following states:
+
+- **Off**: The media player is turned off and is not accepting commands until turned on.
+- **On**: The media player is turned on, but no details on its state are currently known.
+- **Idle**: The media player is turned on and accepting commands, but currently not playing any media. Possibly at some idle home screen.
+- **Playing**: The media player is currently playing media.
+- **Paused**: The media player has an active media and is currently paused
+- **Standby**: The media player is in a low power state, accepting commands.
+- **Buffering**: The media player is preparing to start playback of media.
+
 ## Actions
 
 ### Media control actions
@@ -183,7 +195,7 @@ Allows to group media players together for synchronous playback. Only works on s
 | ---------------------- | -------- | ---------------------------------------------------- |
 | `entity_id`            |      yes | Unjoin this media player from any player groups.     |
 
-### Device class
+## Device class
 
 {% include integrations/device_class_intro.md %}