From c4b6323e519d8cf560fa2517678245028b4579f3 Mon Sep 17 00:00:00 2001
From: Noah Husby <32528627+noahhusby@users.noreply.github.com>
Date: Fri, 25 Oct 2024 01:15:07 -0400
Subject: [PATCH] Add play media documentation to Cambridge Audio (#35341)

* Add media play documentation to Cambridge Audio

* Tiny tweak

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/cambridge_audio.markdown | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/source/_integrations/cambridge_audio.markdown b/source/_integrations/cambridge_audio.markdown
index 4295378e414..24c11b8f006 100644
--- a/source/_integrations/cambridge_audio.markdown
+++ b/source/_integrations/cambridge_audio.markdown
@@ -55,6 +55,42 @@ Host:
 The integration provides a few entities to configure the device settings. The following entities are supported:
 - Display brightness
 
+## Playing media
+
+Cambridge Audio supports playing a variety of formats using the `media_player.play_media` action. 
+
+### Examples:
+
+Cambridge Audio can recall any stored presets saved on the device. An example action using a preset:
+```yaml
+action: media_player.play_media
+target:
+  entity_id: media_player.cambridge_audio
+data:
+  media_content_type: "preset"
+  media_content_id: "1"
+```
+
+An example action using an Airable radio ID:
+
+```yaml
+action: media_player.play_media
+target:
+  entity_id: media_player.cambridge_audio
+data:
+  media_content_type: "airable"
+  media_content_id: "12345678"
+```
+
+An example action using an internet radio url:
+```yaml
+action: media_player.play_media
+target:
+  entity_id: media_player.cambridge_audio
+data:
+  media_content_type: "internet_radio"
+  media_content_id: "https://example.com/internet-radio/station_abcd.mp3"
+```
 ## Troubleshooting
 
 ### The buttons to skip, shuffle, and repeat the track are missing