Caracteres reservados em SSML

Existem cinco caracteres predefinidos que normalmente não podem ser usados em uma instrução SSML. Essas entidades são reservadas pela especificação da linguagem. Esses caracteres são

Nome	Caractere	Código de escape
aspas (aspas duplas)	"	"
E comercial	&	&
apóstrofo ou aspas simples	'	'
sinal menor que	<	&lt;
sinal maior que	>	&gt;

Como o SSML usa esses caracteres como parte de seu código, para usar esses símbolos no SSML, você deve escapar o caractere ao usá-lo. Use o código de escape em vez do caractere real para que ele seja exibido corretamente enquanto cria um documento SSML válido. Por exemplo, a frase a seguir

We're using the lawyer at Peabody & Chambers, attorneys-at-law.

seria renderizada em SSML como

<speak>
We&apos;re using the lawyer at Peabody &amp; Chambers, attorneys-at-law.
</speak>

Nesse caso, os caracteres especiais apóstrofo e E comercial precisam de escape para que o documento SSML permaneça válido.

Para os símbolos &, <, e > os códigos de escape são sempre necessários quando você usa SSML. Além disso, ao usar o apóstrofo/aspas simples (') como apóstrofo, você também deve usar o código de escape.

No entanto, quando você usa aspas duplas (") ou apóstrofo/aspas simples (') como aspas, a opção por usar ou não o código de escape dependerá do contexto.

Aspas duplas

• Deve ser escapado quando em um valor de atributo delimitado por aspas duplas. Por exemplo, no AWS CLI código a seguir

  --text "Pete "Maverick" Mitchell"

• Não precisa de escape quando estiver no contexto textual. Por exemplo, no seguinte

  He said, "Turn right at the corner."

• Não precisa de escape quando em um valor de atributo delimitado por aspas simples. Por exemplo, no seguinte código da AWS CLI .

  --text 'Pete "Maverick" Mitchell'

Aspas simples

• Precisa de escape quando usado como apóstrofo. Por exemplo, no seguinte

  We've got to leave quickly.

• Não precisa de escape quando estiver no contexto textual. Por exemplo, no seguinte

  "And then I said, 'Don't quote me.'"

• Não precisa de escape quando em um atributo de código delimitado por aspas duplas. Por exemplo, no seguinte código da AWS CLI .

  --text "Pete 'Maverick' Mitchell"