3.8 KiB
title, description, ha_category, ha_release, ha_domain, ha_iot_class, ha_platforms, ha_integration_type
| title | description | ha_category | ha_release | ha_domain | ha_iot_class | ha_platforms | ha_integration_type | ||
|---|---|---|---|---|---|---|---|---|---|
| Amazon Polly | Instructions on how to setup Amazon Polly with Home Assistant. |
|
0.37 | amazon_polly | Cloud Push |
|
integration |
The amazon_polly text-to-speech platform that works with Amazon Polly to create the spoken output.
Polly is a paid service via Amazon Web Services. There is a free tier for the first 12 months and then a charge per million characters afterwards.
Setup
For more information, please read the AWS General Reference regarding Security Credentials to get the needed details. Also, check the boto3 Documentation about the profiles and the AWS Regions and Endpoints Reference for available regions.
Available voices are listed in the Amazon Documentation.
Configuration
To get started, add the following lines to your configuration.yaml (example for Amazon Polly):
# Example configuration.yaml entry
tts:
- platform: amazon_polly
aws_access_key_id: AWS_ACCESS_KEY_ID
aws_secret_access_key: AWS_SECRET_ACCESS_KEY
{% configuration %}
aws_access_key_id:
description: "Your AWS Access Key ID. If provided, you must also provide an aws_secret_access_key and must not provide a profile_name."
required: true
type: string
aws_secret_access_key:
description: "Your AWS Secret Access Key. If provided, you must also provide an aws_access_key_id and must not provide a profile_name."
required: true
type: string
profile_name:
description: A credentials profile name. If provided, you must not provide an aws_access_key_id nor an aws_secrete_access_key.
required: false
type: string
region_name:
description: The region identifier to connect to.
required: false
type: [string, list]
default: us-east-1
text_type:
description: "Whether to interpret messages as text or as ssml by default."
required: false
type: string
default: text
voice:
description: The Voice Name/ID to be used for generated speech by default.
required: false
type: string
output_format:
description: "Override the default output format. Either mp3, ogg_vorbis or pcm."
required: false
type: string
default: mp3
sample_rate:
description: "Override the default sample rate. Possible values are: 8000, 16000, 22050, 24000."
required: false
type: string
default: 22050 for MP3 and Ogg Vorbis, 16000 for pcm
engine:
description: "Override the default engine. Can be either of standard or neural. See Amazon documentation for compatible regions and voices."
required: false
type: string
default: standard
{% endconfiguration %}
Usage
Say to all media_player device entities:
- service: tts.amazon_polly_say
data:
message: "<speak>Hello from Amazon Polly</speak>"
or
- service: tts.amazon_polly_say
data:
message: >
<speak>
Hello from Amazon Polly
</speak>
Say to the media_player.living_room device entity:
- service: tts.amazon_polly_say
target:
entity_id: media_player.living_room
message: >
<speak>
Hello from Amazon Polly
</speak>
Say with break:
- service: tts.amazon_polly_say
data:
message: >
<speak>
Hello from
<break time=".9s" />
Amazon Polly
</speak>