Add notify platform to TTS (#14574)

Co-authored-by: Franck Nijhof <frenck@frenck.dev>
This commit is contained in:
Diogo Gomes 2020-10-13 13:54:39 +01:00 committed by GitHub
parent 732d74e562
commit b3c8b031ca
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -0,0 +1,51 @@
---
title: "Notify using TTS"
description: "Instructions on how to set up a Notify integration using TTS service and media_player within Home Assistant."
ha_category:
- Notifications
ha_release: 0.117
ha_iot_class: Local Push
ha_quality_scale: internal
ha_domain: notify
---
The notify TTS platform lets you use the TTS integration [Service Say](/integrations/tts/#service-say) and a [media_player](/integrations/media_player) to alert you of important events. This integration provides a simple interface to use in your automations and alerts.
In order to use this integration, you must already have a TTS platform installed and configured, and a media_player working with the TTS platform.
To enable this platform in your installation, consider the following example using [google_translate](/integrations/google_translate/) and an example `media_player.living_room`.
In your `configuration.yaml` file type:
```yaml
tts:
- platform: google_translate
service_name: google_say
notify:
- platform: tts
name: in_the_living_room
tts_service: tts.google_say
media_player: media_player.living_room
```
Please note that the `tts_service` parameter, must match the `service_name` defined in the TTS integration.
{% configuration %}
name:
description: The name of the notify service.
required: true
type: string
tts_service:
description: "The `service_name` of a TTS platform."
required: true
type: string
media_player:
description: "The `entity_id` of a media_player."
required: true
type: string
language:
description: "The `language` to be passed to the TTS `Service Say`"
required: false
type: string
{% endconfiguration %}