Mis on Vibration API?

Vibration API (navigator.vibrate()) on brauseri standard, mis võimaldab veebilehtedel käivitada nutitelefonidesse ja mõnedesse tahvelarvutitesse sisseehitatud füüsilist vibratsioonimootori. See aktsepteerib kas üksikut kestust millisekundites või vahelduvat vibratsiooni/pausi kestuste massiivi — nn vibratsioonimustrit. API-t toetavad enamik Android-brausereid; iOS ei paljasta vibratsiooni veebilehtedele platvormi piirangute tõttu.

Vibratsioonimustrid on kirjeldatud massiividena, kus paaritu indeksiga väärtused esindavad vibratsiooni kestusi ja paarisindeksiga väärtused esindavad pausi kestusi. Näiteks [200, 100, 200] tähendab vibreeri 200 ms, paus 100 ms, vibreeri 200 ms. Käsk navigator.vibrate(0) või navigator.vibrate([]) tühistab mis tahes käimasoleva vibratsiooni kohe.

Tööriista kirjeldus

See tööriist võimaldab teil testida, kas teie seade toetab Vibration API-t, ja katsetada vibratsioonimustrite abil otse brauseris. Saate käivitada üksiku impulsi konfigureeritava kestusega, sisestada täielikult kohandatud komadega eraldatud mustri või valida sisseehitatud eelseadete hulgast, nagu SOS, südamelöök ja kahekordne/kolmekordne impulss. Sündmuste logi salvestab iga vibratsioonipüüde ajatempliga ja kasutatud täpse mustriga, nii et saate võrrelda tulemusi erinevate seadmete ja brauserite vahel.

Näited

Mustri sisend Mis juhtub
300 Üksik impulss, mis kestab 300 ms
200,100,200 Vibreeri 200 ms → paus 100 ms → vibreeri 200 ms
150,100,150,100,150 Kolm lühikest impulsi 100 ms vahedega
0 Tühistab mis tahes käimasoleva vibratsiooni

Funktsioonid

  • Tuvastab, kas seade ja brauser toetavad Vibration API-t, ja kuvab olekut laadimise ajal
  • Kohandatav üksiku impulsi kestus 10 ms kuni 5000 ms vahemikus liuguri abil
  • Kohandatud mustri sisend aktsepteerib mis tahes komadega eraldatud vibratsiooni ja pausi kestuste jada
  • Kuus valmis eelseadet: Short Pulse, Long Pulse, Double Pulse, Triple Pulse, SOS Pattern ja Heartbeat
  • Sündmuste logi ajatemplitega, mis näitab iga käivitatud mustrit ja kas brauser selle aktsepteeris või tagasi lükkas

Kasutamise juhtumid

  • Mobiilse veebiarenduse: Veenduge, et Vibration API-ga rakendatud haptiline tagasiside tegelikult käivitub sihtseadmes enne funktsiooni väljastamist.
  • QA seadmete testimine: Kinnitage kiiresti, et vibratsioonimootor töötab äsja saadud või remonditud nutitelefonil ilma kohalikku rakendust paigaldamata.
  • Mustri prototüüpimine: Itereerige kohandatud vibratsioonijärjestuste (teatiste hoiatused, mängu tagasiside, juurdepääsetavuse vihjed) üle, testides neid otse brauseris.

Kuidas see töötab

Tööriist kutsub navigator.vibrate(pattern) teie antud väärtusega. Brauser tagastab true, kui kõne aktsepteeriti, ja false, kui see lükati tagasi — näiteks seetõttu, et dokument pole fokuseeritud või seade ei toeta API-t. Mõlemad tulemused salvestatakse sündmuste logisse. Kogu töötlemine toimub täielikult seadmes; andmeid ei saadeta ühegi serverisse.

Piirangud

  • iOS (Safari, Chrome iOS-is): Apple ei paljasta navigator.vibrate() iOS-is, seega API-t alati teatakse iPhone'i ja iPad'i puhul mittetoetavana.
  • Töölaua brauserid: Töölaua arvutitel pole tavaliselt vibratsioonimootori, seega isegi kui API on saadaval, pole sellel füüsilist mõju.
  • Tausta vahekaardid: Mõned brauserid lükkavad vaikselt tagasi vibratsioonkutsed, kui leht pole esiplanil.
  • Maksimaalne kestus: Üksikud vibratsioonisegmendid on piiratud brauseriga (tavaliselt umbes 10 sekundit); väga suured väärtused võidakse vaikselt kärbida.