TwiML™ Voice: <Say>
O verbo <Say>
converte o texto em fala que é lido de volta para o autor da chamada. <Say>
é útil para o desenvolvimento ou para dizer texto dinâmico que é difícil de pré‐gravar. O verbo oferece diferentes opções para vozes, cada uma com seu próprio conjunto compatível de idiomas e gêneros, para que você possa configurar seu TwiML dependendo da sua combinação preferida de gênero e idioma.
Atributos do verbo
O verbo <Say>
oferece suporte a diferentes atributos, dependendo do valor de voice
definido.
voice
O verbo <Say>
permite especificar a voz a ser usada para o texto. As vozes man
e woman
são compatíveis com os idiomas inglês, espanhol, francês, alemão e italiano. A voz alice
fala ainda mais idiomas com suporte para vários locais diferentes em uma voz feminina. Você também pode usar uma das mais de 50 vozes do Amazon Polly. Visite a página Text-to-Speech docs (documentos de Texto em fala) para saber mais.
Nome do atributo | Valores permitidos | Valor padrão |
---|---|---|
voice (voz) | man (homem), woman (mulher), alice ou qualquer outra voz do Amazon Polly | man (homem) (para provedor básico); Salli (para provedor do Amazon Polly). Consulte o console texto em fala (text-to-speech console) para configurar. |
loop | inteiro >= 0 | 1 |
language (idioma) | veja abaixo | veja abaixo |
voice (voz) = man (homem) ou woman (mulher)
Ao definir a voz para man
ou woman
, você pode usar os seguintes valores para o atributo de idioma:
Nome do atributo | Valores permitidos | Valor padrão |
---|---|---|
language (idioma) | en, en-gb, es, fr, de | en |
Usa um ou mais desses atributos em um verbo <Say>
da seguinte maneira:
voice (voz) = alice
Ao definir a voz como alice
, você pode usar os seguintes valores para o atributo de idioma:
Nome do atributo | Valor padrão |
---|---|
idioma | en-US |
Valores permitidos | Idioma, localização |
da-DK | Dinamarquês, Dinamarca |
de-DE | Alemão, Alemanha |
en-AU | Inglês, Austrália |
en-CA | Inglês, Canadá |
en-GB | Inglês, Reino Unido |
en-IN | Inglês, Índia |
en-US | Inglês, Estados Unidos |
ca-ES | Catalão, Espanha |
es-ES | Espanhol, Espanha |
es-MX | Espanhol, México |
fi-FI | Finlandês, Finlândia |
fr-CA | Francês, Canadá |
fr-FR | Francês, França |
it-IT | Italiano, Itália |
ja-JP | Japonês, Japão |
ko-KR | Coreano, Coreia do Sul |
nb-NO | Norueguês, Noruega |
nl-NL | Neerlandês, Países Baixos |
pl-PL | Polonês-Polônia |
pt-BR | Português, Brasil |
pt-PT | Português, Portugal |
ru-RU | Russo, Rússia |
sv-SE | Sueco, Suécia |
zh-CN | Chinês (mandarim) |
zh-HK | Chinês (cantonês) |
zh-TW | Chinês (mandarim taiwanês) |
Use um ou mais desses atributos em um verbo <Say>
da seguinte forma:
language (idioma)
O atributo language
permite especificar um idioma e uma localidade, com
o sotaque e as pronúncias afiliados. A Twilio oferece suporte a idiomas separados
, dependendo da voz escolhida.
As vozes man
ou woman
trabalham com as seguintes localidades: Inglês com sotaque estadunidense (en
),
Inglês com sotaque britânico (en-gb
), Espanhol (es
), Francês (fr
), italiano (it
) e alemão (de
).
O padrão é Inglês com sotaque estadunidense (en
).
A voz alice
fala 26 dialetos totais (18 idiomas e 14 localidades). Consulte a tabela
acima para obter uma descrição de todos os idiomas e localidades
compatíveis com a Alice.
Observação: se você especificar um idioma e uma localidade que apenas Alice fala, mas não especificar uma voz, você obterá a Alice por padrão. Por exemplo, o seguinte TwiML será padronizado para Alice:
loop
O atributo loop
especifica quantas vezes você gostaria que o texto fosse repetido. O
padrão é uma vez. Especificar 0 fará com que o verbo <Say>
faça loop até que a
chamada seja desligada ou 1.000 iterações sejam realizadas.
Nouns (Substantivos)
O noun
de um verbo do TwiML é o conteúdo aninhado no verbo;
é o elemento sobre o qual o verbo atua. O único substantivo para o verbo <Say>
é
o texto sem formatação que será reproduzido.
Noun (Substantivo) | Descrição |
---|---|
texto sem formatação | O texto que a Twilio lê para o autor da chamada. As vozes TTS básicas são limitadas a 4.096 caracteres UTF-8 de byte único. As vozes da Polly são limitadas a 3.000 caracteres UTF-8 de byte único, não incluindo tags SSML. |
Regras de aninhamento
Você não pode aninhar nenhum verbo em <Say>
. Entretanto, você pode aninhar <Say>
no verbo <Gather>
.
Exemplos
Exemplo 1: Hello World (Olá, mundo)
Quando uma chamada é direcionada para o seguinte documento do TwiML, o autor da chamada ouve "hello world" (Olá, mundo) falado uma vez em voz masculina.
Exemplo 2: Hello, Hello (Olá, Olá)
Este documento do TwiML diz "Hello" (Olá) duas vezes em português brasileiro:
Dicas e usos avançados
- Há um limite de 4.096 caracteres Unicode no texto que
<Say>
pode processar. - Ao traduzir o texto em fala, o verbo
<Say>
fará suposições sobre como pronunciar números, datas, horas, quantias de dinheiro e outras abreviações. Teste bem essas situações. - Ao dizer números, "12345" será falado como "twelve thousand three hundred forty-five" (doze mil, trezentos e quarenta e cinco), enquanto "1 2 3 4 5" será falado como "one two three four five." ("um dois três quatro cinco")
- A pontuação, como vírgulas e pontos, será interpretada como pausas naturais.
<Say>
é útil para dizer texto dinâmico que seria difícil de gravar previamente. Nos casos em que o conteúdo de<Say>
é estático, você pode considerar gravar uma pessoa ao vivo dizendo a frase e usando o verbo<Play>
em vez disso.- Se desejar inserir uma pausa longa, tente utilizar o verbo
<Pause>
.<Pause>
deve ser colocado fora das tags<Say>
, não aninhado dentro delas.
Precisa de ajuda?
Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.