Widget

#Was es kann

• Zeigt einen Satz, nimmt die lernende Person auf und spielt ein Beispiel ab.
• Markiert jedes Wort und jeden Laut und zeigt die Mundstellung für jeden Laut.
• Hell oder dunkel: du entscheidest, oder es folgt dem Gerät der Besucher.

#Einrichten

1. Gib in der Übersicht deiner Konsole die Websites an, die das Widget zeigen, und erstelle einen Widget-Schlüssel.
2. Kopiere den Code, den dir die Konsole gibt, und füg ihn in deine Seite ein.

<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>

Behalte allow="microphone": Ohne das lässt der Browser das Widget nicht aufnehmen.

Bewertete Aufnahmen und abgespielte Modellstimmen im Widget verbrauchen die Einheiten deines Kontos, genau wie API-Aufrufe: 1 Einheit pro Aufnahme, 0,5 pro Stimme.

#Optionen

pk

Dein Widget-Schlüssel. Pflicht.

text

Der Satz zum Üben. Höchstens 100 Zeichen. Lässt du ihn weg, tippt die lernende Person ihren eigenen ein.

lang

Sprache des Satzes, genau so, wie die API sie nennt: en-GB, en-US, es-ES, de-DE, fr-FR, it-IT, ca-ES. Pflicht: en-GB ist britisches Englisch, en-US amerikanisches Englisch. Fehlt er oder hat er einen anderen Wert, zeigt das Widget einen Fehler.

theme

light, dark oder system. system, der Standard, folgt der Geräteeinstellung der Besucher.

#Nur auf deinen Websites

Browser zeigen das Widget nur auf den Websites, die für seinen Schlüssel angegeben sind. Überall sonst bleibt es leer. Jede Adresse gilt genau so, wie sie dasteht, etwa https://learn.example.com: Gib jede Subdomain an, die du nutzt. Zum Testen gib deine lokale Adresse mit Port an, etwa http://localhost:5173. Du kannst die Liste jederzeit ändern, und ein widerrufener Schlüssel funktioniert sofort nirgends mehr.