Mikä on Vibration API?

Vibration API (navigator.vibrate()) on selaimen standardi, jonka avulla verkkosivut voivat laukaista älypuhelimiin ja joihinkin tabletteihin sisäänrakennetun värinämoottorin. Se hyväksyy joko yhden keston millisekunteina tai vuorottelevan värinä- ja taukokestojen taulukon — kutsutaan värinäkuvioksi. API on tuettu useimmissa Android-selaimissa; iOS ei paljasta värinää verkkosivuille alustan rajoitusten vuoksi.

Värinäkuviot kuvataan taulukkoina, joissa parittomissa indekseissä olevat arvot edustavat värinäkestoja ja parillisissa indekseissä olevat arvot edustavat taukokestoja. Esimerkiksi [200, 100, 200] tarkoittaa värinää 200 ms, tauko 100 ms, värinä 200 ms. Kutsuminen navigator.vibrate(0) tai navigator.vibrate([]) peruuttaa kaikki käynnissä olevat värinät välittömästi.

Työkalun kuvaus

Tämä työkalu antaa sinulle mahdollisuuden testata, tukeeko laitteesi Vibration API:a, ja kokeilla värinäkuvioita suoraan selaimessa. Voit laukaista yhden pulssin säädettävällä kestolla, syöttää täysin mukautetun pilkulla erotetun kuvion tai valita valmiista esiasetuksista, kuten SOS, sydämen lyönnit ja kaksois-/kolmoispulssit. Tapahtumaloki tallentaa jokaisen värinäyrityksen aikaleimalla ja käytetyllä tarkalleen ottaen kuviolla, jotta voit vertailla tuloksia eri laitteiden ja selaimien välillä.

Esimerkit

Kuvion syöte Mitä tapahtuu
300 Yksittäinen pulssi, joka kestää 300 ms
200,100,200 Värinä 200 ms → tauko 100 ms → värinä 200 ms
150,100,150,100,150 Kolme lyhyttä pulssia 100 ms:n väleillä
0 Peruuttaa kaikki käynnissä olevat värinät

Ominaisuudet

  • Havaitsee, tukeeko laite ja selain Vibration API:a, ja näyttää tilan latautuessa
  • Säädettävä yksittäisen pulssin kesto 10 ms:stä 5000 ms:iin liukusäätimen avulla
  • Mukautetun kuvion syöte hyväksyy minkä tahansa pilkulla erotetun värinä- ja taukokestojen sarjan
  • Kuusi valmiista esiasetusta: Lyhyt pulssi, Pitkä pulssi, Kaksois pulssi, Kolmois pulssi, SOS-kuvio ja Sydämen lyönnit
  • Tapahtumaloki aikaleimoineen, joka näyttää jokaisen laukaistun kuvion ja sen, hyväksyikö selain sen vai hylkäsikö

Käyttötapaukset

  • Mobiiliverkkokehitys: Varmista, että Vibration API:lla toteutettu haptinen palaute todella toimii kohdelaitteessa ennen ominaisuuden julkaisua.
  • QA-laitteen testaus: Vahvista nopeasti, että värinämoottori toimii uudessa tai korjatussa älypuhelimessa ilman natiivia sovellusta.
  • Kuvion prototyyppien luominen: Iteroi mukautettuja värinäsarjoja (ilmoitushälytykset, pelipalaute, saavutettavuuden vihjeet) testaamalla niitä live-tilassa selaimessa.

Kuinka se toimii

Työkalu kutsuu navigator.vibrate(pattern) antamallasi arvolla. Selain palauttaa true, jos kutsu hyväksyttiin, ja false, jos se hylättiin — esimerkiksi siksi, että dokumentti ei ole fokuksessa tai laite ei tue API:a. Molemmat tulokset tallennetaan tapahtumalokkiin. Kaikki käsittely tapahtuu kokonaan laitteella; mitään tietoja ei lähetetä millekään palvelimelle.

Rajoitukset

  • iOS (Safari, Chrome iOS:ssä): Apple ei paljasta navigator.vibrate():a iOS:ssä, joten API on aina raportoitu ei-tuettuna iPhoneissa ja iPadeissa.
  • Pöytäkoneen selaimet: Pöytäkoneet eivät yleensä sisällä värinämoottoria, joten vaikka API olisi saatavilla, sillä ei ole fyysistä vaikutusta.
  • Taustalla olevat välilehdet: Jotkut selaimet hylkäävät värinäkutsut äänettömästi, kun sivu ei ole etualalla.
  • Enimmäiskesto: Yksittäiset värinäsegmentit on rajoitettu selaimella (yleensä noin 10 sekuntia); hyvin suuret arvot voidaan hiljaa katkaista.