Per i siti web

Widget

Un riquadro di pratica pronto da aggiungere alle tue pagine, senza schermate da costruire.

#Cosa fa

  • Mostra una frase, registra chi impara e riproduce un esempio.
  • Segna ogni parola e ogni suono, e mostra la posizione della bocca per ogni suono.
  • Chiaro o scuro: scegli tu, oppure segue il dispositivo del visitatore.
Il widget dopo una registrazione: quattro punteggi, pulsanti per riprodurre la registrazione e l’esempio, e ogni parola segnata in verde o in rosso.

#Configurarlo

  1. Nella Panoramica della tua console, indica i siti che mostreranno il widget e crea una chiave del widget.
  2. Copia il codice che ti dà la console e incollalo nella tua pagina.
Le chiavi del widget nella console: il campo dei siti, una nuova chiave con il codice da incollare e la chiave nell’elenco con il suo sito.
HTML
<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>

Mantieni allow="microphone": senza, il browser non lascia registrare il widget.

Le registrazioni valutate e le voci del modello riprodotte nel widget usano le unità del tuo account, esattamente come le chiamate all'API: 1 unità per registrazione, 0,5 per voce.

#Opzioni

pk
La tua chiave del widget. Obbligatoria.
text
La frase da esercitare. Al massimo 100 caratteri. Se la ometti, chi impara scrive la sua.
lang
Lingua della frase, esattamente come la chiama l'API: en-GB, en-US, es-ES, de-DE, fr-FR, it-IT, ca-ES. Obbligatoria: en-GB è l'inglese britannico, en-US l'inglese americano. Se omessa o con un altro valore, il widget mostra un errore.
theme
light, dark o system. system, il valore predefinito, segue l'impostazione del dispositivo del visitatore.

#Solo sui tuoi siti

I browser mostrano il widget solo sui siti indicati per la sua chiave. Altrove resta vuoto. Ogni indirizzo è esatto, come https://learn.example.com: indica ogni sottodominio che usi. Durante i test, indica il tuo indirizzo locale con la porta, come http://localhost:5173. Puoi cambiare l'elenco in qualsiasi momento, e revocare una chiave la blocca ovunque all'istante.

La chiave è visibile nella tua pagina, come qualsiasi chiave usata da un browser. L'elenco dei siti impedisce ad altri siti di mostrare il tuo widget, ma qualcuno potrebbe comunque copiare la chiave nel proprio programma. Per limitare quanto può spendere una copia, ogni chiave del widget invia al massimo 30 registrazioni e 60 voci del modello al minuto; oltre risponde 429. La tua console mostra l'ultimo uso di ogni chiave; se qualcosa non torna, revocala e creane una nuova.

Domande?

Raccontaci cosa hai in mente e ti risponderemo.

Contattaci