Widget

#Qué hace

• Muestra una frase, graba a quien aprende y reproduce un ejemplo.
• Marca cada palabra y cada sonido, y muestra la posición de la boca para cada sonido.
• Claro u oscuro: tú eliges, o sigue el dispositivo del visitante.

#Configúralo

1. En el Resumen de tu consola, indica los sitios web que mostrarán el widget y crea una clave de widget.
2. Copia el código que te da la consola y pégalo en tu página.

<iframe
  src="https://spelly.ch/widget?pk=pk_live_…&lang=en-GB&text=The%20quick%20brown%20fox."
  allow="microphone"
  style="width:100%;height:560px;border:0">
</iframe>

Mantén allow="microphone": sin él, el navegador no deja grabar al widget.

Las grabaciones evaluadas y las voces del modelo que suenan en el widget usan las unidades de tu cuenta, igual que las llamadas a la API: 1 unidad por grabación, 0,5 por voz.

#Opciones

pk

Tu clave de widget. Obligatoria.

text

La frase para practicar. Como mucho 100 caracteres. Si la omites, quien aprende escribe la suya.

lang

Idioma de la frase, tal como lo nombra la API: en-GB, en-US, es-ES, de-DE, fr-FR, it-IT, ca-ES. Obligatorio: en-GB es inglés británico y en-US, inglés americano. Si se omite o lleva otro valor, el widget muestra un error.

theme

light, dark o system. system, el valor por defecto, sigue el ajuste del dispositivo del visitante.

#Solo en tus sitios web

Los navegadores solo muestran el widget en los sitios web indicados para su clave. En cualquier otro sitio queda en blanco. Cada dirección es exacta, como https://learn.example.com: indica cada subdominio que uses. Mientras haces pruebas, indica tu dirección local con su puerto, como http://localhost:5173. Puedes cambiar la lista cuando quieras, y revocar una clave la detiene en todas partes a la vez.