

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Controlar como tipos especiais de palavras são ditas
<a name="say-as-tag"></a>

*<say-as>*

 A tag `<say-as>` é compatível com mecanismos de TTS generativos, de forma longa, neural e padrão. Entretanto, se o Amazon Polly estiver usando uma voz neural e encontrar a tag `<say-as>` com a opção `characters` no runtime, a frase afetada será sintetizada usando a voz padrão relacionada. No entanto, a frase afetada ainda será cobrada como se usasse uma voz neural. 

Use a tag `<say-as>` com o atributo `interpret-as` para informar ao Amazon Polly como dizer determinados caracteres, palavras e números. Isso permite que você forneça contexto adicional para eliminar qualquer ambiguidade sobre como o Amazon Polly deve renderizar o texto.

A tag `<say-as>` usa um atributo, `interpret-as`, que usa um número de possíveis valores disponíveis. Todos usam a mesma sintaxe:

```
<say-as interpret-as="value">[text to be interpreted]</say-as>
```

Os valores a seguir estão disponíveis com o `interpret-as`:
+ `characters`ou`spell-out`: Escreve cada letra do texto, como em. a-b-c
**nota**  
No momento, essa opção não é compatível com vozes neurais. Se você estiver usando uma voz neural e esse código SSML for encontrado pelo Amazon Polly no runtime, a frase afetada será sintetizada usando a voz padrão relacionada. No entanto, essa frase ainda será cobrada como se usasse uma voz neural.
+ `cardinal` ou `number`: interpreta o texto numérico como um número cardinal, por exemplo, 1.234.
+ `ordinal`: interpreta o texto numérico como um número ordinal, por exemplo, 1.234º. 
+ `digits`: soletra cada dígito individualmente, como em 1-2-3-4. 
+ `fraction`: interpreta o texto numérico como uma fração. Isso funciona tanto em frações comuns, como 3/20, quanto em mistas, como 2 ½. Veja a seguir mais informações.
+ `unit`: interpreta um texto numérico como medida. O valor deve ser um número ou uma fração que, por sua vez, é seguida por uma unidade sem espaço no meio, como em `1/2inch`, ou por apenas uma unidade, como em `1meter`.
+ `date`: interpreta o texto como uma data. O formato de data deve ser especificado com o atributo do formato. Veja a seguir mais informações.
+ `time`: interpreta o texto numérico como uma duração, em minutos e segundos, como em `1'21"`. 
+ `address`: interpreta o texto como parte de um endereço. 
+ `expletive`: aumenta o som do conteúdo incluído na tag. 
+ `telephone`: interpreta o texto numérico como um número de telefone de 7 ou 10 dígitos, como em `2025551212`. Você também pode usar esse valor para lidar com ramais telefônicos, como em `2025551212x345`. Veja a seguir mais informações.
**nota**  
Atualmente, a opção `telephone` não está disponível para todos os idiomas. No entanto, está disponível para vozes que falam variantes do idioma inglês (en-AU, en-GB, en-IN, en-US e en-GB-WLS), variantes do idioma espanhol (es-ES, es-MX e es-US), variantes do idioma francês (fr-FR e fr-CA) e variantes do português (pt-BR e pt-PT), bem como alemão (de-DE), italiano (it-IT), japonês (ja-JP) e russo (ru-ru). Também deve ser observado que, em alguns casos, idiomas como o árabe (arb) manipulam automaticamente o número definido como um número de telefone e, portanto, não implementam a etiqueta SSML `telephone` de fato.

**Frações**

O Amazon Polly interpretará os valores da tag `say-as` com o atributo `interpret-as="fraction"` como frações comuns. Veja a seguir a sintaxe de frações.
+ *Fração*

  Sintaxe:*cardinal number*/*cardinal number*, como 2/9.

  Por exemplo: `<say-as interpret-as="fraction">2/9</say-as>` é pronunciado "dois nonos."
+ *Número misto não negativo*

  Sintaxe: *cardinal number* \$1*cardinal number*/*cardinal number*, como 3\$11/2. 

  Por exemplo: `<say-as interpret-as="fraction">3+1/2</say-as>` é pronunciado "três e meio".
**nota**  
Deve haver um `+` entre "3" e "1/2". O Amazon Polly não é compatível com um número misto sem o `+`, como "3 1/2".

**Datas**

Quando `interpret-as` for definido como `date`, você também precisará indicar o formato da data. 

Neste caso, usa-se a seguinte sintaxe:

```
<say-as interpret-as="date" format="format">[date]</say-as>
```

Por exemplo:

```
<speak>
     I was born on <say-as interpret-as="date" format="mdy">12-31-1900</say-as>.
</speak>
```

Os formatos a seguir podem ser usados com o atributo `date`.
+ `mdy`: Month-day-year.
+ `dmy`: Day-month-year.
+ `ymd`: Year-month-day.
+ `md`: mês-dia.
+ `dm`: dia-mês.
+ `ym`: ano-mês.
+ `my`: mês-ano.
+ `d`: dia.
+ `m`: Mês.
+ `y`: Ano.
+ `yyyymmdd`: Year-month-day. Se você usar esse formato, poderá fazer com que o Amazon Polly pule partes da data usando pontos de interrogação. 

  Por exemplo, o Amazon Polly renderiza o seguinte exemplo como "22 de setembro":

  ```
  <say-as interpret-as="date">????0922</say-as>
  ```

   `Format` não é necessários.

**Telefone**

O Amazon Polly tenta interpretar o texto fornecido corretamente com base na formatação do texto, mesmo sem a tag `<say-as>`. Por exemplo, se o texto incluir 202-555-1212, o Amazon Polly o interpretará como um número de telefone de dez dígitos e dirá cada dígito individualmente, com uma breve pausa para cada traço. Nesse caso, você não precisa usar o `<say-as interpret-as="telephone">`. No entanto, se você fornecer o texto 2025551212 e quiser que o Amazon Polly o diga como número de telefone, será necessário especificar `<say-as interpret-as="telephone">`.

A lógica para a interpretação de cada elemento é específica de cada idioma. Por exemplo, o Inglês dos EUA e o Inglês do Reino Unido se diferenciam na pronúncia dos números de telefone (no Inglês do Reino Unido, as sequências do mesmo dígito são agrupadas, como "double five" [dois números cinco] ou "triple four" [três números quatro]). Para ver a diferença, teste o exemplo a seguir com uma voz dos EUA e com uma voz do Reino Unido: 

```
<speak>
     Richard's number is <say-as interpret-as="telephone">2122241555</say-as>
</speak>
```

