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.

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:

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:

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.

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.