Piper: show how to use Piper TTS with media player in automation (#27523)

Co-authored-by: Franck Nijhof <git@frenck.dev>

source/_includes/asides/voice_navigation.html

@@ -17,6 +17,7 @@
       <li>{% active_link /voice_control/voice_remote_expose_devices/ Exposing devices to voice assistant %}</li>
       <li>{% active_link /voice_control/builtin_sentences/ Built-in sentences %}</li>
       <li>{% active_link /voice_control/custom_sentences/ Custom sentences %}</li>
+      <li>{% active_link /voice_control/using_tts_in_automation/ Using Piper TTS in automations %}</li>
       <li>{% active_link /voice_control/troubleshooting/ Troubleshooting Assist %}</li>
     </ul>
   </div>

source/voice_control/using_tts_in_automation.markdown

@@ -0,0 +1,40 @@
+---
+title: "Using Piper TTS in automations"
+---
+
+This procedure shows you how to create a text-to-speech {% term action %}. For this, we use our local text-to-speech engine, Piper, and the media player {% term service %}. Home Assistant can then speak to you over your media player as part of an {% term automation %}.
+
+1. Go to **{% my automations title="Settings > Automations & Scenes" %}**, and select **Create automation**.
+1. Select **Create new automation**, then **Add action**.
+1. From the drop-down menu, select **Play media** and select the media player you want to use for this automation.
+   ![Select your media player](/images/assist/tts_select_media_player.png)
+1. Select **Pick media**, then, select **Text-to-speech**.
+    ![Select your media source](/images/assist/tts_select_media_source.png)
+1. To use fully local text-to-speech processing, select **Piper**.
+    ![Select Piper](/images/assist/tts_select_piper.png)
+1. Enter the text you want to hear for this automation.
+    ![Enter text to be spoken](/images/assist/tts_enter_text.png)
+1. Your text-to-speech action is now ready to be used in your script or automation.
+    ![Enter text to be spoken](/images/assist/tts_action.png)
+1. Save your action.
+1. If you want, you can edit this service in YAML.
+
+    ```yaml
+    service: media_player.play_media
+    target:
+      entity_id: media_player.m5stack_atom_echo_a61920
+    data:
+      media_content_id: media-source://tts/tts.piper?message=Your+coffee+is+ready%21+Enjoy.
+      media_content_type: provider
+    metadata:
+      title: Your coffee is ready! Enjoy.
+      thumbnail: https://brands.home-assistant.io/_/tts/logo.png
+      media_class: app
+      children_media_class: null
+      navigateIds:
+          - {}
+          - media_content_type: app
+            media_content_id: media-source://tts
+          - media_content_type: provider
+            media_content_id: media-source://tts/tts.piper?message=Your+coffee+is+ready%21+Enjoy.
+    ```