jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-18 23:06:58 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update tts.microsoft.markdown (#3923)

Browse Source
This commit is contained in:
Jeroen ter Heerdt 2017-12-01 18:22:43 +01:00 committed by Fabian Affolter
parent a86926a98a
commit 7f9d2bfeca
No known key found for this signature in database
GPG Key ID: DDF3D6F44AAB1336
1 changed files with 13 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
source/_components/tts.microsoft.markdown
View File

@ -2,7 +2,7 @@
layout: page
title: "Microsoft Text-to-Speech"
description: "Instructions how to setup Microsoft Text-to-Speech with Home Assistant."
date: 2017-10-23 11:00
date: 2017-11-07 12:00
sidebar: true
comments: false
sharing: true
@ -27,10 +27,13 @@ tts:
Configuration variables:
- **api_key** (*Required*): Your API key.
- **language** (*Optional*): The language to use. Defaults to `en-us`. Accepted values are listed in the documentation mentioned below.
- **language** (*Optional*): The language to use. Defaults to `en-us`. Accepted values are listed in the documentation mentioned below. Note that if you set the language to anything other than the default of `en-us`, you will need to specify a matching voice type as well.
- **gender** (*Optional*): The gender you would like to use for the voice. Accepted values are `Female` and `Male`. Defaults to `Female`
- **type** (*Optional*): The voice type you want to use. Accepted values are listed in the service name mapping [in the documentation](https://docs.microsoft.com/en-us/azure/cognitive-services/Speech/api-reference-rest/bingvoiceoutput). Defaults to `ZiraRUS`
- **rate** (*Optional*): Change the rate of speaking. Example values: `-25%`, `+50%`. Defaults to `+0%` (no change)
- **volume** (*Optional*): Change the volume of the output. Example values: `-20%`, `+70%`. Defaults to `+0%` (no change)
- **pitch** (*Optional*): Change the pitch of the output. Example values: `high`. Defaults to `default` (no change)
- **contour** (*Optional*): Change the contour of the output. This overrides the pitch setting. See the [W3 SSML specification](http://www.w3.org/TR/speech-synthesis/#pitch_contour) for what it does. Example value: `(0%,+0%) (100%,+100%)`
A full configuration sample including optional configuration variables:
@ -39,7 +42,11 @@ A full configuration sample including optional configuration variables:
tts:
- platform: microsoft
api_key: XXXXXXXXX
language: en-us
gender: male
type: BenjaminRUS
language: en-gb
gender: Male
type: George, Apollo
rate: +20%
volume: -50%
pitch: high
contour: (0%, +0%) (100%, +100%)
```