Cos'è l'API Vibration?

L'API Vibration (navigator.vibrate()) è uno standard del browser che consente alle pagine web di attivare il motore di vibrazione fisico integrato negli smartphone e in alcuni tablet. Accetta una singola durata in millisecondi oppure un array alternato di durate di vibrazione/pausa — chiamato pattern di vibrazione. L'API è supportata nella maggior parte dei browser Android; iOS non espone la vibrazione alle pagine web a causa delle restrizioni della piattaforma.

I pattern di vibrazione sono descritti come array in cui i valori con indice dispari rappresentano le durate di vibrazione e i valori con indice pari rappresentano le durate di pausa. Ad esempio, [200, 100, 200] significa vibra 200 ms, pausa 100 ms, vibra 200 ms. Chiamare navigator.vibrate(0) o navigator.vibrate([]) annulla immediatamente qualsiasi vibrazione in corso.

Descrizione dello strumento

Questo strumento ti consente di verificare se il tuo dispositivo supporta l'API Vibration e di sperimentare pattern di vibrazione direttamente nel browser. Puoi attivare un singolo impulso con una durata configurabile, inserire un pattern completamente personalizzato separato da virgole, oppure scegliere tra preset integrati come SOS, battito cardiaco e impulsi doppi/tripli. Un registro degli eventi registra ogni tentativo di vibrazione con un timestamp e il pattern esatto utilizzato, così puoi confrontare i risultati su diversi dispositivi e browser.

Esempi

Input del pattern Cosa accade
300 Singolo impulso della durata di 300 ms
200,100,200 Vibra 200 ms → pausa 100 ms → vibra 200 ms
150,100,150,100,150 Tre impulsi brevi con intervalli di 100 ms tra loro
0 Annulla qualsiasi vibrazione in corso

Funzionalità

  • Rileva se il dispositivo e il browser supportano l'API Vibration e visualizza lo stato al caricamento
  • Durata dell'impulso singolo regolabile da 10 ms a 5000 ms tramite uno slider
  • L'input del pattern personalizzato accetta qualsiasi sequenza separata da virgole di durate di vibrazione e pausa
  • Sei preset pronti all'uso: Impulso Breve, Impulso Lungo, Impulso Doppio, Impulso Triplo, Pattern SOS e Battito Cardiaco
  • Registro degli eventi con timestamp che mostra ogni pattern attivato e se è stato accettato o rifiutato dal browser

Casi d'uso

  • Sviluppo web mobile: Verifica che il feedback aptico implementato con l'API Vibration funzioni effettivamente su un dispositivo di destinazione prima di rilasciare la funzionalità.
  • Test QA del dispositivo: Conferma rapidamente che il motore di vibrazione funziona su uno smartphone appena ricevuto o riparato senza installare un'app nativa.
  • Prototipazione di pattern: Itera su sequenze di vibrazione personalizzate (avvisi di notifica, feedback di gioco, segnali di accessibilità) testandole dal vivo nel browser.

Come funziona

Lo strumento chiama navigator.vibrate(pattern) con il valore che fornisci. Il browser restituisce true se la chiamata è stata accettata e false se è stata rifiutata — ad esempio, perché il documento non è in focus o il dispositivo non supporta l'API. Entrambi gli esiti vengono registrati nel registro degli eventi. Tutta l'elaborazione avviene interamente sul dispositivo; nessun dato viene inviato a nessun server.

Limitazioni

  • iOS (Safari, Chrome su iOS): Apple non espone navigator.vibrate() su iOS, quindi l'API è sempre segnalata come non supportata su iPhone e iPad.
  • Browser desktop: I computer desktop generalmente non hanno un motore di vibrazione, quindi anche quando l'API è disponibile non ha alcun effetto fisico.
  • Schede in background: Alcuni browser rifiutano silenziosamente le chiamate di vibrazione quando la pagina non è in primo piano.
  • Durata massima: I singoli segmenti di vibrazione sono limitati dal browser (comunemente intorno a 10 secondi); i valori molto grandi possono essere silenziosamente troncati.