From 778c31fdd273d0b0ff13c2ba29f9b6562dea599c Mon Sep 17 00:00:00 2001 From: tronikos Date: Sun, 8 Jan 2023 13:46:28 -0800 Subject: [PATCH 1/7] Google Assistant SDK: Document TTS support --- .../google_assistant_sdk.markdown | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/source/_integrations/google_assistant_sdk.markdown b/source/_integrations/google_assistant_sdk.markdown index a60bf0ae6397..1714576439c5 100644 --- a/source/_integrations/google_assistant_sdk.markdown +++ b/source/_integrations/google_assistant_sdk.markdown @@ -27,6 +27,9 @@ This integration allows: - Someone is at the front door - Smoke detected in the master bedroom - Water leak detected in the master bathroom +- Playback Google Assistant audio response for any query on any media player. Examples + - Tell me a joke + - Count down from 100 ## Prerequisites @@ -133,3 +136,24 @@ data: - bedroom - basement ``` + +### Service `tts.google_assistant_sdk_say` + +In your configuration.yaml you first need to add: + +```yaml +tts: + - platform: google_assistant_sdk +``` + +Then for example you can call: + +```yaml +service: tts.google_assistant_sdk_say +data: + message: tell me a joke + entity_id: media_player.living_room_speaker + cache: false +``` + +which will say a joke on your living room speaker. From b1a6f2cfd0d1464987ba6329b15724053029558e Mon Sep 17 00:00:00 2001 From: tronikos Date: Sun, 8 Jan 2023 14:30:25 -0800 Subject: [PATCH 2/7] Update google_assistant_sdk.markdown --- source/_integrations/google_assistant_sdk.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_integrations/google_assistant_sdk.markdown b/source/_integrations/google_assistant_sdk.markdown index 1714576439c5..50c8f8e19e15 100644 --- a/source/_integrations/google_assistant_sdk.markdown +++ b/source/_integrations/google_assistant_sdk.markdown @@ -29,7 +29,8 @@ This integration allows: - Water leak detected in the master bathroom - Playback Google Assistant audio response for any query on any media player. Examples - Tell me a joke - - Count down from 100 + - Say the ABC + - Sing happy birthday to Nikos ## Prerequisites From 67144f4402bd6e626a042d8fa353a2a53eae0ecf Mon Sep 17 00:00:00 2001 From: tronikos Date: Sun, 8 Jan 2023 14:34:30 -0800 Subject: [PATCH 3/7] Update google_assistant_sdk.markdown --- source/_integrations/google_assistant_sdk.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/google_assistant_sdk.markdown b/source/_integrations/google_assistant_sdk.markdown index 50c8f8e19e15..1e252b59d94f 100644 --- a/source/_integrations/google_assistant_sdk.markdown +++ b/source/_integrations/google_assistant_sdk.markdown @@ -31,6 +31,7 @@ This integration allows: - Tell me a joke - Say the ABC - Sing happy birthday to Nikos + - What does the elephant say? ## Prerequisites From ca3cf75907e1cf25ce55f5ee73b0546df97b8fe8 Mon Sep 17 00:00:00 2001 From: tronikos Date: Sun, 8 Jan 2023 23:21:37 -0800 Subject: [PATCH 4/7] Update google_assistant_sdk.markdown --- source/_integrations/google_assistant_sdk.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/google_assistant_sdk.markdown b/source/_integrations/google_assistant_sdk.markdown index 1e252b59d94f..7c701bc872e7 100644 --- a/source/_integrations/google_assistant_sdk.markdown +++ b/source/_integrations/google_assistant_sdk.markdown @@ -30,7 +30,7 @@ This integration allows: - Playback Google Assistant audio response for any query on any media player. Examples - Tell me a joke - Say the ABC - - Sing happy birthday to Nikos + - Sing happy birthday - What does the elephant say? ## Prerequisites From 9bc6f80fdb8c01b037e12a56b259dc9fec1b9497 Mon Sep 17 00:00:00 2001 From: tronikos Date: Sun, 15 Jan 2023 23:53:51 -0800 Subject: [PATCH 5/7] Update google_assistant_sdk.markdown --- .../google_assistant_sdk.markdown | 35 +++++++------------ 1 file changed, 12 insertions(+), 23 deletions(-) diff --git a/source/_integrations/google_assistant_sdk.markdown b/source/_integrations/google_assistant_sdk.markdown index 7c701bc872e7..ed1d0a497d00 100644 --- a/source/_integrations/google_assistant_sdk.markdown +++ b/source/_integrations/google_assistant_sdk.markdown @@ -27,7 +27,7 @@ This integration allows: - Someone is at the front door - Smoke detected in the master bedroom - Water leak detected in the master bathroom -- Playback Google Assistant audio response for any query on any media player. Examples +- Playback Google Assistant audio response for any query on any media player. Examples: - Tell me a joke - Say the ABC - Sing happy birthday @@ -102,8 +102,9 @@ You can use the service `google_assistant_sdk.send_text_command` to send command | Service data attribute | Optional | Description | Example | | ---------------------- | -------- | ----------- | --------| | `command` | no | Command to send to Google Assistant. | turn off kitchen TV | +| `media_player` | yes | Name(s) of media player entities to play response on | media_player.living_room_speaker | -Example: +Examples: ```yaml service: google_assistant_sdk.send_text_command @@ -111,6 +112,15 @@ data: command: turn off kitchen TV ``` +```yaml +# Say a joke on the living room speaker +service: tts.google_assistant_sdk_say +data: + message: tell me a joke + entity_id: media_player.living_room_speaker + cache: false +``` + ### Service `notify.google_assistant_sdk` You can use the service `notify.google_assistant_sdk` to broadcast messages to Google Assistant speakers and displays without interrupting music/video playback. @@ -138,24 +148,3 @@ data: - bedroom - basement ``` - -### Service `tts.google_assistant_sdk_say` - -In your configuration.yaml you first need to add: - -```yaml -tts: - - platform: google_assistant_sdk -``` - -Then for example you can call: - -```yaml -service: tts.google_assistant_sdk_say -data: - message: tell me a joke - entity_id: media_player.living_room_speaker - cache: false -``` - -which will say a joke on your living room speaker. From e02a16cffea28f411ed1fe95f20d9fef53698c59 Mon Sep 17 00:00:00 2001 From: tronikos Date: Sun, 15 Jan 2023 23:55:20 -0800 Subject: [PATCH 6/7] Update google_assistant_sdk.markdown --- source/_integrations/google_assistant_sdk.markdown | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/source/_integrations/google_assistant_sdk.markdown b/source/_integrations/google_assistant_sdk.markdown index ed1d0a497d00..e050ab0c57ff 100644 --- a/source/_integrations/google_assistant_sdk.markdown +++ b/source/_integrations/google_assistant_sdk.markdown @@ -102,7 +102,7 @@ You can use the service `google_assistant_sdk.send_text_command` to send command | Service data attribute | Optional | Description | Example | | ---------------------- | -------- | ----------- | --------| | `command` | no | Command to send to Google Assistant. | turn off kitchen TV | -| `media_player` | yes | Name(s) of media player entities to play response on | media_player.living_room_speaker | +| `media_player` | yes | Name(s) of media player entities to play response on | media_player.living_room_speaker | Examples: @@ -114,11 +114,10 @@ data: ```yaml # Say a joke on the living room speaker -service: tts.google_assistant_sdk_say +service: google_assistant_sdk.send_text_command data: - message: tell me a joke - entity_id: media_player.living_room_speaker - cache: false + command: tell me a joke + media_player: media_player.living_room_speaker ``` ### Service `notify.google_assistant_sdk` From 710d2bd8a63d445bf612395c1fd0ac830ffbf4af Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Wed, 1 Feb 2023 10:32:24 +0100 Subject: [PATCH 7/7] Tweaks --- source/_integrations/google_assistant_sdk.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/google_assistant_sdk.markdown b/source/_integrations/google_assistant_sdk.markdown index fa398c1852ea..6ee45742f9ee 100644 --- a/source/_integrations/google_assistant_sdk.markdown +++ b/source/_integrations/google_assistant_sdk.markdown @@ -121,14 +121,14 @@ Examples: ```yaml service: google_assistant_sdk.send_text_command data: - command: turn off kitchen TV + command: "turn off kitchen TV" ``` ```yaml # Say a joke on the living room speaker service: google_assistant_sdk.send_text_command data: - command: tell me a joke + command: "tell me a joke" media_player: media_player.living_room_speaker You can also send multiple commands in the same conversation context which is useful to unlock doors or open covers that need a PIN. Example: