play
Play file(s), ringtones, speech or silence.
Parameters
Name | Type | Description |
---|---|---|
urls (or url ) | string | string [] | URL or array of URLs to play. Required. Allowed URLs are:
|
volume | number | Optional volume gain to apply to played URLs. Allowed values from -40.0 to 40.0 . Default 0. |
say_voice | string | Optional voice to use with say: for text to speech. Default is Polly.Salli . |
say_language | string | Optional language to use with say: for text to speech. Default is en-US . |
say_gender | string | Optional gender to use with say: for text to speech. Default is female. |
Variables
Read by the method:
say_voice:
(in) - Optional voice to use for text to speech.say_language:
(in) - Optional language to use for text to speech.say_gender:
(in) - Optional gender to use for text to speech.
Possible Values of Voice, Language and Ringtone
The following voice, language and ringtone values are permitted.
The ml
variant stands for the multilingual version.
Parameter | ||
---|---|---|
say_voice | The available Amazon Polly voices are here The available Google Cloud voices are here The available Elevenlabs are:
|
|
say_language default: en | arb [Arabic, Modern Standard] ar-AR [Arabic, Modern Standard] ar-XA [Arabic] gcloud bn-IN [Bengali, India] gcloud yue-HK [Chinese, Hong Kong] gcloud cmn-CN [Chinese, Mandarin] gcloud cmn-TW [Chinese, Mandarin] gcloud zh-CN [Chinese, Mandarin] cs-CZ [Czech, Czech Republic] gcloud cy-GB [Welsh, UK] da-DK [Danish, Denmark] de [German, Germany] de-DE [German, Germany] en [English, United States] en-AU [English, Australia] en-CA [English, Canada] en-GB [English, UK] en-GB-WLS [English, Wales] en-IN [English, India] en-US [English, United States] es [Spanish, United States] es-ES [Spanish, Spain] es-MX [Spanish, Mexico] es-US [Spanish, United States] fil-PH [Filipino, Philippines] gcloud fi-FI [Finnish, Finland] gcloud fr [French, France] fr-CA [French, Canada] | fr-FR [French, France] el-GR [Greek, Greece] gcloud gu-IN [Gujarati, India] gcloud hi-IN [Hindi, India] hu-HU [Hungarian, Hungary] gcloud is-IS [Icelandic, Iceland] id-ID [Indonesian, Indonesia] gcloud it [Italian, Italy] it-IT [Italian, Italy] ja-JP [Japanese, Japan] kn-IN [Kannada, India] gcloud ko-KR [Korean, Korea] ml-IN [Malayalam, India] gcloud morse [Morse Code, Dit Dah] nb-NO [Norwegian, Norway] nl-NL [Dutch, Netherlands] pl-PL [Polish, Poland] pt-BR [Portuguese, Brazil] pt-PT [Portuguese, Portugal] ro-RO [Romanian, Romania] ru-RU [Russian, Russia] sk-SK [Slovak, Slovakia] gcloud sv-SE [Swedish, Sweden] ta-IN [Tamil, India] gcloud te-IN [Telugu, India] gcloud th-TH [Thai, Thailand] gcloud tr-TR [Turkish, Turkey] uk-UA [Ukrainian, Ukraine] gcloud vi-VN [Vietnamese, Vietnam] gcloud |
urls.ring | Available values are the following ISO 3166-1 alpha-2 country codes: at, au, bg, br, be, ch, cl, cn, cz, de, dk, ee, es, fi, fr, gr, hu, il, in, it, lt, jp, mx, my, nl, no, nz, ph, pl, pt, ru, se, sg, th, uk, us, us-old, tw, ve, za. |
Examples
Playing a single URL
- YAML
- JSON
version: 1.0.0
sections:
main:
- play: https://example.com/file.mp3
{
"version": "1.0.0",
"sections": {
"main": [
{
"play": "https://example.com/file.mp3"
}
]
}
}
Playing multiple URLs
- YAML
- JSON
version: 1.0.0
sections:
main:
- play:
- https://example.com/file1.wav
- https://example.com/file2.wav
- say:this is something to say
- silence:3.0
- ring:10.0:us
{
"version": "1.0.0",
"sections": {
"main": [
{
"play": [
"https://example.com/file1.wav",
"https://example.com/file2.wav",
"say: this is something to say",
"silence:3.0",
"ring:10.0:us"
]
}
]
}
}
Playing multiple URLs with volume adjusted
- YAML
- JSON
version: 1.0.0
sections:
main:
- play:
volume: 30
urls:
- https://example.com/file1.wav
- https://example.com/file2.wav
- say:this is something to say
- silence:3.0
- ring:10.0:us
{
"version": "1.0.0",
"sections": {
"main": [
{
"play": {
"volume": 30,
"urls": [
"https://example.com/file1.wav",
"https://example.com/file2.wav",
"say:this is something to say",
"silence:3.0",
"ring:10.0:us"
]
}
}
]
}
}