Lenguaje de marcación de síntesis de voz (SSML)

Puedes enviar lenguaje de marcado de síntesis de voz (SSML) en tu solicitud a Text-to-Speech para permitir una mayor personalización en tu respuesta de audio mediante la entrega de detalles sobre las pausas y el formato de audio para los acrónimos, las fechas, las horas, las abreviaturas o el texto que se debe censurar. Consulta el instructivo de SSML de Text-to-Speech para obtener más información y muestras de código.

A continuación, se muestra un ejemplo de lenguaje de marcación SSML y cómo Text-to-Speech sintetiza el texto:

<speak>
  Here are <say-as interpret-as="characters">SSML</say-as> samples.
  I can pause <break time="3s"/>.
  I can play a sound
  <audio src="https://www.example.com/MY_MP3_FILE.mp3">didn't get your MP3 audio file</audio>.
  I can speak in cardinals. Your number is <say-as interpret-as="cardinal">10</say-as>.
  Or I can speak in ordinals. You are <say-as interpret-as="ordinal">10</say-as> in line.
  Or I can even speak in digits. The digits for ten are <say-as interpret-as="characters">10</say-as>.
  I can also substitute phrases, like the <sub alias="World Wide Web Consortium">W3C</sub>.
  Finally, I can speak a paragraph with two sentences.
  <p><s>This is sentence one.</s><s>This is sentence two.</s></p>
</speak>

Este es el texto sintetizado correspondiente al documento de ejemplo de SSML:

Here are S S M L samples. I can pause [3 second pause]. I can play a sound [audio file plays].
I can speak in cardinals. Your number is ten.
Or I can speak in ordinals. You are tenth in line.
Or I can even speak in digits. The digits for ten are one oh.
I can also substitute phrases, like the World Wide Web Consortium.
Finally, I can speak a paragraph with two sentences. This is sentence one. This is sentence two.

Text-to-Speech admite un subconjunto de las etiquetas SSML disponibles que se describen en este tema.

Para obtener más información sobre cómo crear datos de audio desde la entrada de SSML con Text-to-Speech, consulta Cómo crear archivos de audio de voz.

Sugerencias para usar SSML

Según la implementación, es posible que debas usar caracteres de escape con las comillas simples o dobles en la carga útil de SSML que envías a Text-to-Speech. En el siguiente ejemplo, se muestra cómo dar formato a la entrada de SSML incluida en un objeto JSON.

"{
    'input':{
     'ssml':'<speak>The <say-as interpret-as=\"characters\">SSML</say-as>
          standard <break time=\"1s\"/>is defined by the
          <sub alias=\"World Wide Web Consortium\">W3C</sub>.</speak>'
    },
    'voice':{
      'languageCode':'en-us',
      'name':'en-US-Standard-B',
      'ssmlGender':'MALE'
    },
    'audioConfig':{
      'audioEncoding':'MP3'
    }
  }"

Caracteres de reserva

Evita usar caracteres de reserva SSML en el texto que se va a convertir en audio. Cuando necesites usar un carácter de reserva SSML, evita que el carácter se lea como código mediante su código de escape. En la siguiente tabla, se muestran los caracteres SSML reservados y sus códigos de escape asociados.

Carácter	Código de escape
"	`"`
&	`&`
'	`'`
<	`<`
>	`>`

Seleccionar una voz

Puedes configurar la voz en el objeto VoiceSelectionParams. Consulta el instructivo de SSML de Text-to-Speech para ver un ejemplo de código que demuestra el uso del objeto VoiceSelectionParams.

Puedes usar la etiqueta <voice> para leer SSML con varias voces, pero debes configurar el nombre VoiceSelectionParams con una voz compatible:

Tipo de voz solicitado	Tipo de voz compatible en la etiqueta <voice>
Tipo de voz solicitado	Neural2	Studio	Wavenet	Noticias	Estándar
Neural2	✔	✔			✔
Studio	✔	✔			✔
Wavenet			✔	✔	✔
Estándar	✔	✔			✔
Noticias			✔	✔	✔

Compatibilidad con los elementos de SSML

En las siguientes secciones, se describen los elementos y las opciones de SSML que se pueden usar en tus Acciones.

`<speak>`

El elemento raíz de la respuesta de SSML.

Para obtener más información sobre el elemento speak, consulta la especificación de W3.

Ejemplo

<speak>
  my SSML content
</speak>

`<break>`

Un elemento vacío que controla las pausas, o bien otros límites prosódicos entre las palabras. Usar <break> entre cualquier par de tokens es opcional. Si este elemento no está presente entre las palabras, la pausa se determina automáticamente según el contexto lingüístico.

Para obtener más información sobre el elemento break, consulta la especificación de W3.

Atributos

Atributo Descripción

Atributo	Descripción
`time`	Establece la duración de la pausa en segundos o milisegundos (p. ej., “3 s” o “250 ms”).
`strength`	Establece la intensidad de la pausa prosódica del resultado según términos relativos. Los valores válidos son “x-weak”, “weak”, “medium”, “strong” y “x-strong”. El valor “none” (ninguna) indica que no se debe incluir ningún límite de pausa prosódica en el resultado; se puede usar para evitar una pausa prosódica que, de lo contrario, el procesador produciría. Los demás valores indican una intensidad de pausa no descendente y monótona (conceptualmente ascendente) entre los tokens. Los límites más intensos generalmente están acompañados de una pausa.

time

Establece la duración de la pausa en segundos o milisegundos (p. ej., “3 s” o “250 ms”).

strength

Establece la intensidad de la pausa prosódica del resultado según términos relativos. Los valores válidos son “x-weak”, “weak”, “medium”, “strong” y “x-strong”. El valor “none” (ninguna) indica que no se debe incluir ningún límite de pausa prosódica en el resultado; se puede usar para evitar una pausa prosódica que, de lo contrario, el procesador produciría. Los demás valores indican una intensidad de pausa no descendente y monótona (conceptualmente ascendente) entre los tokens. Los límites más intensos generalmente están acompañados de una pausa.

Ejemplo

En el siguiente ejemplo, se muestra cómo usar el elemento <break> para hacer pausas entre pasos:

<speak>
  Step 1, take a deep breath. <break time="200ms"/>
  Step 2, exhale.
  Step 3, take a deep breath again. <break strength="weak"/>
  Step 4, exhale.
</speak>

`<say‑as>`

Con este elemento, puedes indicar información sobre el tipo de construcción de texto que contiene el elemento. También te ayuda a especificar el nivel de detalle para el procesamiento del texto contenido.

El elemento <say‑as> tiene el atributo obligatorio interpret-as, que determina cómo se pronuncia el valor. Se pueden usar los atributos opcionales format y detail según el valor interpret-as determinado.

Ejemplos

El atributo interpret-as admite los siguientes valores:

currency
En el siguiente ejemplo, se expresa como “forty two dollars and one cent”. Si se omite el atributo de idioma, se usa la configuración regional actual.
```
<speak>
 <say-as interpret-as='currency' language='en-US'>$42.01</say-as>
</speak>
 
```
telephone
Consulta la descripción de interpret-as='telephone' en la nota de WG sobre los valores del atributo say-as de SSML 1.0 de W3C.

En el siguiente ejemplo, se expresa como “one eight zero zero two zero two one two one two”. Si se omite el atributo “google:style”, habla cero como la letra O.

En la actualidad, el atributo “google:style='zero-as-zero'” solo funciona la configuración regional en inglés.
```
 <speak>
 <say-as interpret-as='telephone' google:style='zero-as-zero'>1800-202-1212</say-as>
 </speak>
 
```
verbatim o spell-out
En el siguiente ejemplo, se deletrea letra por letra:
```
<speak>
 <say-as interpret-as="verbatim">abcdefg</say-as>
</speak>
 
```
Tu navegador no es compatible con el elemento de audio de HTML5.
date
El atributo format es una secuencia de códigos de caracteres del campo de fecha. Los códigos de caracteres de campo admitidos en format son {y, m, d} para el año, el mes y el día (del mes), respectivamente. Si el código del campo aparece una vez para el año, mes o día, entonces la cantidad de dígitos que se espera es 4, 2 y 2, respectivamente. Si el código del campo se repite, entonces la cantidad de dígitos que se espera es la cantidad de veces que se repite el código. Los campos en el texto de la fecha pueden separarse con puntuación o espacios.

El atributo detail controla el formato con el que se expresa la forma hablada de la fecha. Para detail='1', solo son obligatorios los campos de día y uno de los campos de mes o año, aunque se pueden ingresar ambos. Esta es la configuración predeterminada cuando no se proporcionan los tres campos. Se expresa como "El {número ordinal del día} de {mes}, {año}".

El siguiente ejemplo se expresa como "The tenth of September, nineteen sixty" (el diez de septiembre, mil novecientos sesenta):
```
<speak>
 <say-as interpret-as="date" format="yyyymmdd" detail="1">
 1960-09-10
 </say-as>
</speak>
 
```
Tu navegador no es compatible con el elemento de audio de HTML5.

En el siguiente ejemplo, la forma hablada se expresa como "The tenth of September" (el diez de septiembre):
```
<speak>
 <say-as interpret-as="date" format="dm">10-9</say-as>
</speak>
 
```
Tu navegador no es compatible con el elemento de audio de HTML5.

Para detail='2', son obligatorios los campos de día, mes y año, y esta es la configuración predeterminada cuando se proporcionan los tres campos. Se expresa como “{mes} {número ordinal del día}, {año}”.

En el siguiente ejemplo, se expresa como "September tenth, nineteen sixty" (septiembre diez, mil novecientos sesenta):
```
<speak>
 <say-as interpret-as="date" format="dmy" detail="2">
 10-9-1960
 </say-as>
</speak>
 
```
Tu navegador no es compatible con el elemento de audio de HTML5.
characters
En el siguiente ejemplo, la forma hablada se expresa como "C A N":
```
<speak>
 <say-as interpret-as="characters">can</say-as>
</speak>
 
```
Tu navegador no es compatible con el elemento de audio de HTML5.
cardinal
La forma hablada del número del siguiente ejemplo es “twelve thousand three hundred forty five”, en el caso del inglés estadounidense, o “twelve thousand three hundred and forty five”, en el caso del inglés británico:
```
<speak>
 <say-as interpret-as="cardinal">12345</say-as>
</speak>
 
```
Tu navegador no es compatible con el elemento de audio de HTML5.
ordinal
En el siguiente ejemplo, la forma hablada es "First" (primero):
```
<speak>
 <say-as interpret-as="ordinal">1</say-as>
</speak>
 
```
Tu navegador no es compatible con el elemento de audio de HTML5.
fraction
En el siguiente ejemplo, la forma hablada se expresa como "five and a half" (cinco y medio):
```
<speak>
 <say-as interpret-as="fraction">5+1/2</say-as>
</speak>
 
```
Tu navegador no es compatible con el elemento de audio de HTML5.
expletive o bleep
En el siguiente ejemplo, se escucha un “pip”, como si la palabra estuviera censurada:
```
<speak>
 <say-as interpret-as="expletive">censor this</say-as>
</speak>
 
```
Tu navegador no es compatible con el elemento de audio de HTML5.
unit
Convierte las unidades en singular o plural según el número. En el siguiente ejemplo, la forma hablada se expresa como "10 feet" (10 pies):
```
<speak>
 <say-as interpret-as="unit">10 foot</say-as>
</speak>
 
```
Tu navegador no es compatible con el elemento de audio de HTML5.
time
En el siguiente ejemplo, se expresa como "Two thirty P.M." (dos treinta p.m.):
```
<speak>
 <say-as interpret-as="time" format="hms12">2:30pm</say-as>
</speak>
 
```
Tu navegador no es compatible con el elemento de audio de HTML5.

El atributo format es una secuencia de códigos de caracteres de campo de hora. Los códigos de caracteres de campo admitidos en format son {h, m, s, Z, 12, 24} para la hora, los minutos (de la hora), los segundos (del minuto), la zona horaria, el formato de 12 horas y de 24 horas, respectivamente. Si el código del campo aparece una vez para la hora, los minutos o los segundos, la cantidad de dígitos que se espera es 1, 2 y 2, respectivamente. Si el código del campo se repite, entonces la cantidad de dígitos que se espera es la cantidad de veces que se repite el código. Los campos en el texto de la hora pueden separarse con puntuación o espacios. Si no se especifican la hora, los minutos o los segundos en el formato o si los dígitos no coinciden, el campo se trata como si tuviera valor cero. El valor predeterminado para format es “hms12”.

El atributo detail controla si se usa el formato de 12 o 24 horas para la forma hablada de la hora. El formato hablado será de 24 horas si se usa detail='1' o si se omite detail y el formato de la hora es de 24 horas. El formato hablado será de 12 horas si se usa detail='2' o si se omite detail y el formato de la hora es de 12 horas.

Para obtener más información sobre el elemento say-as, consulta la especificación de W3.

`<audio>`

Admite la inserción de archivos de audio grabado y la inserción de otros formatos de audio junto con el resultado de voz sintetizada.

Atributos

Atributo	Obligatorio	Valor predeterminado	Valores
`src`	sí	n/a	Un URI que hace referencia a la fuente de audio multimedia. El protocolo admitido es `https`.
`clipBegin`	no	0	Una TimeDesignation que es el desplazamiento desde el inicio del audio de origen en el cual se debe iniciar la reproducción. Si este valor es mayor o igual que la duración real del audio de origen, entonces no se inserta ningún audio.
`clipEnd`	no	infinito	Una TimeDesignation que es el desplazamiento desde el inicio del audio de origen en el cual se debe finalizar la reproducción. Si la duración real del audio de origen es menor que este valor, entonces la reproducción finalizará en ese momento. Si `clipBegin` es mayor o igual que `clipEnd`, entonces no se inserta ningún audio.
`speed`	no	100%	La tasa proporcional de velocidad de reproducción del resultado en relación con la velocidad de entrada normal expresada como un porcentaje. El formato es un número real positivo seguido de %. El rango admitido actualmente es [50% (lento - velocidad media), 200% (rápido - doble de velocidad)]. Los valores que se encuentren fuera de este intervalo se podrán ajustar (o no) para que se incluyan en él.
`repeatCount`	no	1 o 10 si se configura `repeatDur`	Un número real que especifica cuántas veces se debe insertar el audio (después del recorte, si corresponde, con `clipBegin` o `clipEnd`). Las repeticiones fraccionarias no son compatibles, por lo que el valor se redondeará al número entero más cercano. Cero no es un valor válido y, por consiguiente, se trata como sin especificar y se usa el valor predeterminado en ese caso.
`repeatDur`	no	infinito	Una TimeDesignation que es un límite de la duración del audio insertado después de procesar la fuente para los atributos `clipBegin`, `clipEnd`, `repeatCount` y `speed` (en lugar de la duración normal de la reproducción). Si la duración del audio procesado es menor que este valor, entonces la reproducción finalizará en ese momento.
`soundLevel`	no	+0dB	Ajusta el nivel de sonido del audio en decibeles de `soundLevel`. El intervalo máximo es de +/-40dB, pero el real puede ser, en efecto, menor, y la calidad del resultado puede no ser buena en el intervalo total.

A continuación, se definen las opciones de configuración que se admiten para el audio en la actualidad:

Formato: MP3 (MPEG v2)
- 24,000 muestras por segundo
- Entre 24,000 y 96,000 bits por segundo, tasa fija
Formato: Opus en Ogg
- 24,000 muestras por segundo (súper banda ancha)
- De 24,000 a 96,000 bits por segundo, tasa fija
Formato (obsoleto): WAV (RIFF)
- PCM de 16 bits con signo y de tipo "little endian"
- 24,000 muestras por segundo
Para todos los formatos:
- Se prefiere el uso de un solo canal, pero se acepta el formato estéreo.
- La duración máxima es de 240 segundos. Si deseas reproducir audio con una duración más prolongada, evalúa implementar una respuesta multimedia.
- El límite de tamaño de los archivos es de 5 megabytes.
- La URL de origen debe usar el protocolo HTTPS.
- Nuestro UserAgent cuando se obtiene el audio es "Google-Speech-Actions".

El contenido del elemento <audio> es opcional y se usa si el archivo de audio no se puede reproducir o si el dispositivo de salida no admite audio. Puede incluir un elemento <desc>, en cuyo caso el contenido de texto de ese elemento se utiliza para mostrarse. Consulta la sección de audio grabado de la lista de tareas para las respuestas a fin de obtener más información.

La URL src también debe ser una URL HTTPS (Google Cloud Storage puede alojar tus archivos de audio en una URL HTTPS).

Para obtener más información acerca de las respuestas multimedia, consulta la sección correspondiente de la guía de respuestas.

Para obtener más información sobre el elemento audio, consulta la especificación de W3.

Ejemplo

<speak>
  <audio src="cat_purr_close.ogg">
    <desc>a cat purring</desc>
    PURR (sound didn't load)
  </audio>
</speak>

`,<s>`

Elementos de la oración y el párrafo.

Para obtener más información sobre los elementos p y s, consulta la especificación W3.

Ejemplo

<p><s>This is sentence one.</s><s>This is sentence two.</s></p>

Prácticas recomendadas

Usa etiquetas <s>...</s> para unir oraciones completas, especialmente si contienen elementos de SSML que cambian la prosodia (es decir, <audio>, <break>, <emphasis>, <par>, <prosody>, <say-as>, <seq> y ).
Si se pretende que una pausa en el discurso sea lo suficientemente larga para percibirla, usa las etiquetas <s>...</s> y coloca esa pausa entre oraciones.

``

Indica que el texto en el valor de atributo alias reemplaza al texto contenido para la pronunciación.

También puedes usar el elemento sub para proporcionar una pronunciación simplificada de una palabra difícil de leer. Con el último ejemplo que aparece a continuación, se demuestra este caso práctico en japonés.

Para obtener más información sobre el elemento sub, consulta la especificación de W3.

Ejemplos

<sub alias="World Wide Web Consortium">W3C</sub>

<sub alias="にっぽんばし">日本橋</sub>

``

Un elemento vacío que coloca un marcador en la secuencia de texto o etiquetas. Se puede usar para hacer referencia a una ubicación específica en la secuencia o para insertar un marcador en una transmisión de salida para notificaciones asíncronas.

Nota: Sigue estos lineamientos cuando uses el elemento mark:

Usa las marcas START y END en lugar de agregar marcas personalizadas cerca del principio o del final del SSML.
No agregues marcas consecutivas a tu SSML. Es posible que las marcas en sucesión rápida no generen eventos. Además, si no se genera audio entre las marcas, no se generarán eventos. Por ejemplo, evita hacer lo siguiente:
Sentence 1. Sentence 2.

Nota: Para mayor comodidad, obtienes eventos START y END automáticamente en tus respuestas para Interactive Canvas. Estas marcas no se incluyen en la especificación de W3.

Para obtener más información sobre el elemento mark, consulta la especificación de W3.

Ejemplo

<speak>
Go from <mark name="here"/> here, to <mark name="there"/> there!
</speak>

`<prosody>`

Se usa para personalizar el tono de la voz, la velocidad del habla y el volumen del texto que contiene el elemento. Actualmente, se admiten los atributos rate, pitch y volume.

Los atributos rate y volume se pueden configurar de acuerdo con las especificaciones de W3. Existen tres opciones para configurar el valor del atributo pitch, que se indican a continuación:

Nota: Las etiquetas <prosody> solo se deben usar alrededor de oraciones completas. Delimitar palabras dentro de una oración puede causar pausas no deseadas en el habla.

Atributo	Descripción
`name`	El ID de la string de cada marca.

Opción	Descripción
Pariente	Especifica un valor relativo (p. ej., “bajo”, “medio”, “alto”, etc.), en el que “medio” es el tono predeterminado.
Semitonos	Aumenta o disminuye la afinación en “N” semitonos con “+Nst” o “-Nst”, respectivamente. Ten en cuenta que “+/-” y “st” son obligatorios.
Porcentaje	Aumenta o disminuye el tono en porcentaje de “N” con “+N%” o “-N%”, respectivamente. Ten en cuenta que el signo “%” es obligatorio, pero “+/-” es opcional.

Para obtener más información sobre el elemento prosody, consulta la especificación de W3.

Ejemplo

En el siguiente ejemplo, se usa el elemento <prosody> para hablar lentamente a 2 semitonos por debajo de lo normal:

<prosody rate="slow" pitch="-2st">Can you hear me now?</prosody>

`<emphasis>`

Se usa para agregar o quitar énfasis al texto que contiene el elemento. El elemento <emphasis> modifica el discurso de manera similar a <prosody>, pero sin la necesidad de establecer atributos de voz individuales.

Nota: Las etiquetas <emphasis> solo se deben usar alrededor de oraciones completas. Delimitar palabras dentro de una oración puede causar pausas no deseadas en el habla.

Este elemento acepta un atributo de “nivel” opcional con los siguientes valores válidos:

strong
moderate
none
reduced

Para obtener más información sobre el elemento emphasis, consulta la especificación de W3.

Ejemplo

En el siguiente ejemplo, se usa el elemento <emphasis> para hacer un anuncio:

<emphasis level="moderate">This is an important announcement</emphasis>

`<par>`

Un contenedor multimedia paralelo que te permite reproducir varios elementos multimedia a la vez. El único contenido permitido es un conjunto de uno o más elementos <par>, <seq> y <media>. El orden de los elementos <media> no es importante.

A menos que un elemento secundario especifique un tiempo de inicio diferente, el tiempo de inicio implícito del elemento es el mismo que el del contenedor <par>. Si un elemento secundario tiene un valor de desplazamiento configurado para su atributo begin o end, el desplazamiento del elemento estará relacionado con el tiempo de inicio del contenedor <par>. Para el elemento raíz <par>, el atributo begin se ignora y el tiempo de inicio será cuando el proceso de síntesis de voz SSML comience a generar resultados para el elemento raíz <par> (es decir, en efecto, tiempo “cero”).

Ejemplo

<speak>
  <par>
    <media xml:id="question" begin="0.5s">
      <speak>Who invented the Internet?</speak>
    </media>
    <media xml:id="answer" begin="question.end+2.0s">
      <speak>The Internet was invented by cats.</speak>
    </media>
    <media begin="answer.end-0.2s" soundLevel="-6dB">
      <audio
        src="https://actions.google.com/.../cartoon_boing.ogg"/>
    </media>
    <media repeatCount="3" soundLevel="+2.28dB"
      fadeInDur="2s" fadeOutDur="0.2s">
      <audio
        src="https://actions.google.com/.../cat_purr_close.ogg"/>
    </media>
  </par>
</speak>

`<seq>`

Un contenedor multimedia secuencial con el que puedes reproducir elementos multimedia uno detrás de otro. El único contenido permitido es un conjunto de uno o más elementos <seq>, <par> y <media>. El orden de los elementos multimedia será el orden en el que se procesen.

Los atributos begin y end de los elementos secundarios se pueden configurar como valores de desplazamiento (consulta la sección de Especificación de tiempos, a continuación). Los valores de desplazamiento de esos elementos secundarios estarán relacionados con el final del elemento anterior en la secuencia o, en el caso del primer elemento de la secuencia, con el comienzo de su contenedor <seq>.

Ejemplo

<speak>
  <seq>
    <media begin="0.5s">
      <speak>Who invented the Internet?</speak>
    </media>
    <media begin="2.0s">
      <speak>The Internet was invented by cats.</speak>
    </media>
    <media soundLevel="-6dB">
      <audio
        src="https://actions.google.com/.../cartoon_boing.ogg"/>
    </media>
    <media repeatCount="3" soundLevel="+2.28dB"
      fadeInDur="2s" fadeOutDur="0.2s">
      <audio
        src="https://actions.google.com/.../cat_purr_close.ogg"/>
    </media>
  </seq>
</speak>

`<media>`

Representa una capa multimedia en un elemento <par> o <seq>. El contenido permitido de un elemento <media> es un elemento de SSML <speak> o <audio>. La siguiente tabla describe los atributos válidos de un elemento <media>.

Atributos

Atributo	Obligatorio	Valor predeterminado	Valores
xml:id	no	ningún valor	Un identificador XML único para este elemento. Las entidades codificadas no son compatibles. Los valores de identificador permitidos coinciden con la expresión regular `"([-_#]\|\p{L}\|\p{D})+"`. Consulta XML-ID para obtener más información.
begin	no	0	El tiempo de inicio de este contenedor multimedia. Se ignora si es un elemento de contenedor multimedia raíz (y se trata igual que el valor predeterminado “0”). Consulta la sección de Especificación de tiempos que se encuentra a continuación para ver los valores de string válidos.
end	no	ningún valor	Una especificación para el tiempo de finalización de este contenedor multimedia. Consulta la sección de Especificación de tiempos que se encuentra a continuación para ver los valores de string válidos.
repeatCount	no	1	Un número real que especifica cuántas veces se debe insertar el elemento multimedia. No se admiten fracciones en las repeticiones, de manera que el valor se redondeará al número entero más cercano. Cero no es un valor válido y, por consiguiente, se trata como sin especificar y se usa el valor predeterminado en ese caso.
repeatDur	no	ningún valor	Una TimeDesignation que es el límite de duración del elemento multimedia insertado. Si la duración del elemento multimedia es menor que este valor, entonces la reproducción finalizará en ese momento.
soundLevel	no	+0dB	Ajusta el nivel de sonido del audio en decibeles de `soundLevel`. El intervalo máximo es de +/-40dB, pero el real puede ser, en efecto, menor, y la calidad del resultado puede no ser buena en el intervalo total.
fadeInDur	no	0 s	Una TimeDesignation durante la cual el elemento multimedia aparecerá gradualmente desde el silencio hasta el `soundLevel` especificado de forma opcional. Si la duración del elemento multimedia es menor que este valor, la aparición gradual se detendrá al final de la reproducción y el nivel de sonido no alcanzará el nivel de sonido especificado.
fadeOutDur	no	0 s	Una TimeDesignation durante la cual el elemento multimedia desaparecerá gradualmente del `soundLevel` especificado de forma opcional, hasta el silencio. Si la duración del elemento multimedia es menor que este valor, el nivel de sonido se establece en un valor más bajo para garantizar que se alcance el silencio al final de la reproducción.

Especificación de tiempo

Una especificación de tiempo, que se usa para el valor de los atributos “begin” y “end” de elementos <media> y contenedores multimedia (elementos <par> y <seq>), es un valor de desplazamiento (por ejemplo, +2.5s) o un valor syncbase (por ejemplo, foo_id.end-250ms).

Valor de desplazamiento: El valor de desplazamiento de tiempo (offset) es un “Timecount-value” de SMIL (lenguaje de integración multimedia sincronizada) que acepta valores que coinciden con la expresión regular: "\s\*(+|-)?\s\*(\d+)(\.\d+)?(h|min|s|ms)?\s\*"
La primera string de dígitos es la parte entera del número decimal y la segunda string de dígitos es la fracción del decimal. El signo predeterminado (es decir, “(+|-)?”) es “+”. Los valores unitarios corresponden a horas, minutos, segundos y milisegundos, respectivamente. La configuración predeterminada para las unidades es "s" (segundos).
Valor syncbase: Un valor syncbase es un valor de syncbase de SMIL que permite valores que coinciden con la expresión regular: "([-_#]|\p{L}|\p{D})+\.(begin|end)\s\*(+|-)\s\*(\d+)(\.\d+)?(h|min|s|ms)?\s\*"
Los dígitos y las unidades se interpretan de la misma manera que con un valor de desplazamiento.

`<phoneme>`

Puedes usar la etiqueta <phoneme> para producir pronunciaciones personalizadas de palabras intercaladas. Text-to-Speech acepta los alfabetos fonéticos IPA y X-SAMPA. Consulta la página de fonemas para ver una lista de idiomas y fonemas compatibles.

Cada aplicación de la etiqueta <phoneme> dirige la pronunciación de una sola palabra:

  <phoneme alphabet="ipa" ph="ˌmænɪˈtoʊbə">manitoba</phoneme>
  <phoneme alphabet="x-sampa" ph='m@"hA:g@%ni:'>mahogany</phoneme>

Marcadores de acentuación

Existen hasta tres niveles de acentuación que se pueden colocar en una transcripción:

Acento principal: Se denota con /ˈ/ en IPA y /"/ en X-SAMPA.
Acento secundario: Se indica con /ˌ/ en IPA y /%/ en X-SAMPA.
No acentuado: No se indica con un símbolo (en ninguna notación).

Algunos idiomas pueden tener menos de tres niveles o no denotan ninguna posición de acentuación. Consulta la página de fonemas para ver los niveles de acentuación disponibles para tu idioma. Los marcadores de acentuación se colocan al comienzo de cada sílaba acentuada. Por ejemplo, en inglés de EE.UU.:

Palabra de ejemplo	IPA	X-SAMPA
water	ˈwɑːtɚ	"wA:t@`
underwater	ˌʌndɚˈwɑːtɚ	%Vnd@"wA:t@

Comparación entre transcripción amplia y reducida

Como regla general, mantén tus transcripciones más amplias y fonéticas. Por ejemplo, en inglés de EE.UU., transcribe la /t/ intervocálica (en lugar de usar una vibrante):

Palabra de ejemplo	IPA	X-SAMPA
mantequilla	ˈbʌtɚ en lugar de ˈbʌɾɚ	“bVt@” en lugar de “bV4@`

Hay algunos casos en los que el uso de la representación fonética hace que los resultados de TTS no suenen naturales (por ejemplo, si la secuencia de fonemas es difícil de pronunciar).

Un ejemplo de esto es la asimilación fonética de /s/ en inglés. En este caso, la asimilación se debe reflejar en la transcripción:

Palabra de ejemplo	IPA	X-SAMPA
gatos	ˈkæts	"k{ts
perros	ˈdɑːgz en lugar de ˈdɑːgs	“dA:gz en lugar de “dA:gs

Reducción

Cada sílaba debe contener una (y solo una) vocal. Esto significa que debes evitar las consonantes silábicas y, en su lugar, transcribirlas con una vocal reducida. Por ejemplo:

Palabra de ejemplo	IPA	X-SAMPA
kitten	ˈkɪtən en lugar de ˈkɪtn	“kIt@n en lugar de “kitn
kettle	ˈkɛtəl en lugar de ˈkɛtl	"kEt@l en lugar de "kEtl

Silabeo

De manera opcional, puedes especificar límites de sintaxis con /./. Cada sílab debe contener una vocal (y solo una). Por ejemplo:

Palabra de ejemplo	IPA	X-SAMPA
readability	ˌɹiː.də.ˈbɪ.lə.tiː	%r\i:.d@."bI.l@.ti:

Diccionario de pronunciación personalizado

Como alternativa a proporcionar pronunciaciones intercaladas con la etiqueta phoneme, proporciona un diccionario de pronunciaciones personalizadas en la RPC de síntesis de voz. Cuando el diccionario de pronunciación personalizado esté en la solicitud, el texto de entrada se transformará automáticamente con la etiqueta phoneme de SSML.

A modo de ejemplo, la siguiente solicitud con entrada de texto y pronunciación personalizada se transformará y será equivalente al SSML que se muestra a continuación.

Entrada original:

input: {
  text: 'Hello world! It is indeed a beautiful world!',
  custom_pronunciations: {
    pronunciations: {
      phrase: 'world'
      phonetic_encoding: PHONETIC_ENCODING_IPA
      pronunciation: 'wɜːld'
    }
  }
}

Entrada transformada:

input: {
  ssml: '<speak>Hello <phoneme alphabet="ipa" ph="wɜːld">world</phoneme>! It is indeed a beautiful <phoneme alphabet="ipa" ph="wɜːld">world</phoneme>!</speak>'
}

Duraciones

Text-to-Speech admite <say-as interpret-as="duration"> para leer de forma correcta las duraciones. Por ejemplo, el siguiente ejemplo se verbalizaría como “cinco horas y treinta minutos”:

<say-as interpret-as="duration" format="h:m">5:30</say-as>

La string de formato admite los siguientes valores:

Abreviatura	Valor
h	horas
m	minutos
s	segundos
ms	milésimas de segundo

`<voice>`

La etiqueta <voice> te permite usar más de una voz en una sola solicitud de SSML. En el siguiente ejemplo, la voz predeterminada es una voz masculina en inglés. Todas las palabras se sintetizarán en esta voz, excepto “qu'est-ce qui t'amène ici”, que se verbalizará en francés con una voz femenina en lugar del idioma (inglés) y género (masculino) predeterminados.

<speak>And then she asked, <voice language="fr-FR" gender="female">qu'est-ce qui
t'amène ici</voice><break time="250ms"/> in her sweet and gentle voice.</speak>

Como alternativa, puedes usar una etiqueta <voice> para especificar una voz individual (el nombre de la voz en la página de voces compatibles) en lugar de especificar language o gender:

<speak>The dog is friendly<voice name="fr-CA-Wavenet-B">mais la chat est
mignon</voice><break time="250ms"/> said a pet shop
owner</speak>

Cuando usas la etiqueta <voice>, Text-to-Speech espera recibir un name (el nombre de la voz que deseas usar) o una combinación de los siguientes atributos. Los tres atributos son opcionales, pero debes proporcionar al menos uno si no proporcionas un name.

gender: Puede ser “masculino”, “femenino” o “neutro”.
variant: Se usa como desempate en casos en los que existen múltiples posibilidades de qué voz usar según la configuración.
language: El idioma que deseas. Solo se puede especificar un idioma en una etiqueta <voice> determinada. Especifica tu idioma en formato BCP-47. Puedes encontrar el código BCP-47 para el idioma en la columna código de idioma de la página de idiomas y voces compatibles.

También puedes controlar la prioridad relativa de cada uno de los atributos gender, variant y language mediante dos etiquetas adicionales: required y ordering.

required: Si un atributo se designa como required y no se configura de forma correcta, la solicitud fallará.
ordering: Cualquier atributo enumerado después de una etiqueta ordering se considera como atributo preferido en lugar de obligatorio. La API de Text-to-Speech considera los atributos preferidos según el criterio del mejor esfuerzo y en función del orden en que se enumeran después de la etiqueta ordering. Si algún atributo preferido está configurado de forma incorrecta, es posible que Text-to-Speech aún muestre una voz válida, pero con la configuración incorrecta descartada.

Ejemplos de configuración mediante las etiquetas required y ordering:

<speak>And there it was <voice language="en-GB" gender="male" required="gender"
ordering="gender language">a flying bird </voice>roaring in the skies for the
first time.</speak>

<speak>Today is supposed to be <voice language="en-GB" gender="female"
ordering="language gender">Sunday Funday.</voice></speak>

`<lang>`

Puedes usar <lang> para incluir texto en varios idiomas dentro de la misma solicitud de SSML. Todos los idiomas se sintetizarán con la misma voz, a menos que uses la etiqueta <voice> para cambiar la voz de forma explícita. La string xml:lang debe contener el idioma de destino en formato BCP-47 (este valor aparece como “código de idioma” en la tabla voces compatibles). En el siguiente ejemplo, “chat” se verbalizará en francés en lugar del idioma predeterminado (inglés):

<speak>The french word for cat is <lang xml:lang="fr-FR">chat</lang></speak>

Text-to-Speech admite la etiqueta <lang> según el criterio del mejor esfuerzo. No todas las combinaciones de idiomas producen los mismos resultados de calidad si se especifican en la misma solicitud de SSML. En algunos casos, una combinación de idiomas puede producir un efecto que es detectable, pero sutil o percibido como negativo. Problemas conocidos:

El japonés con caracteres kanji no es compatible con la etiqueta <lang>. La entrada se translitera y se lee como caracteres chinos.
Los idiomas semíticos, como el árabe, el hebreo y el persa, no son compatibles con la etiqueta <lang> y generarán silencio. Si deseas usar cualquiera de estos idiomas, te recomendamos que uses la etiqueta <voice> para cambiar a una voz que habla el idioma deseado (si está disponible).

Puntos de tiempo de SSML

La API de Text-to-Speech admite el uso de puntos de tiempo en los datos de audio creados. Un punto de tiempo es una marca de tiempo (en segundos, medida desde el comienzo del audio generado) que corresponde a un punto designado en la secuencia de comandos. Puedes configurar un punto de tiempo en guion mediante la etiqueta . Cuando se genera el audio, la API muestra la compensación horaria entre el comienzo del audio y el punto de tiempo.

Hay dos pasos para establecer un punto de tiempo:

Agrega una etiqueta SSML  al punto de la secuencia de comandos para la que deseas tener una marca de tiempo.
Configura TimepointType como SSML_MARK. Si no se configura este campo, los puntos de tiempo no se muestran de forma predeterminada.

En el siguiente ejemplo, se muestran dos puntos de tiempo:

timepoint_1: Indica el momento (en segundos) en el que la palabra "Mark" aparece en el audio generado.
timepoint_2: Indica el momento (en segundos) en el que la palabra "see" aparece en el audio generado.

<speak>Hello <mark name="timepoint_1"/> Mark. Good to <mark
name="timepoint_2"/> see you.</speak>

Estilos

Las siguientes voces pueden hablar en varios estilos:

en-US-Neural2-F
en-US-Neural2-J

Usa la etiqueta <google:style> para controlar qué estilo usar. Usa la etiqueta solo alrededor de oraciones completas.

Ejemplo:

<speak><google:style name="lively">Hello I'm so happy today!</google:style></speak>

El campo name admite los siguientes valores:

apologetic
calm
empathetic
firm
lively

Lenguaje de marcación de síntesis de voz (SSML)

Sugerencias para usar SSML

Caracteres de reserva

Seleccionar una voz

Compatibilidad con los elementos de SSML

<speak>

Ejemplo

<break>

Atributos

Ejemplo

<say‑as>

Ejemplos

<audio>

Atributos

Ejemplo

<p>,<s>

Ejemplo

Prácticas recomendadas

<sub>

Ejemplos

<mark>

Ejemplo

<prosody>

Ejemplo

<emphasis>

Ejemplo

<par>

Ejemplo

<seq>

Ejemplo

<media>

Atributos

Especificación de tiempo

<phoneme>

Marcadores de acentuación

Comparación entre transcripción amplia y reducida

Reducción

Silabeo

Diccionario de pronunciación personalizado

Duraciones

<voice>

<lang>

Puntos de tiempo de SSML

Estilos

`<speak>`

`<break>`

`<say‑as>`

`<audio>`

`<p>,<s>`

`<sub>`

`<mark>`

`<prosody>`

`<emphasis>`

`<par>`

`<seq>`

`<media>`

`<phoneme>`

`<voice>`

`<lang>`