Vibrasi (Getaran)

Dokumentasi ini menjelaskan plugin ini di versi master. Versi lain ada di GitHub.

AppVeyor	Travis CI

cordova-plugin-getaran

Plugin ini sejajar dengan spesifikasi getaran W3C http://www.w3.org/TR/vibration/

Plugin ini menyediakan cara untuk menggetarkan perangkat.

Plugin ini mendefinisikan objek global termasuk navigator.vibrate.

Meskipun dalam lingkup global, mereka tidak tersedia sampai setelah devicereadyacara.

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(navigator.vibrate);
}

Instalasi

cordova plugin add cordova-plugin-vibration

Platform yang Didukung

navigator.vibrate

• Android
• iOS
• Windows

Tampilan web Android (API level 19 ke atas) mendukung W3C Vibration API secara asli dan karenanya, implementasi spesifik Android dari plugin ini telah dibatalkan.

bergetar

Fungsi ini memiliki tiga fungsi berbeda berdasarkan parameter yang diteruskan ke sana.

Bergetar standar

Getar perangkat selama jangka waktu tertentu.

navigator.vibrate(time)

atau

navigator.vibrate([time])

- waktu : Milidetik untuk menggetarkan perangkat. (Jumlah)

Contoh

// Vibrate for 3 seconds
navigator.vibrate(3000);

// Vibrate for 3 seconds
navigator.vibrate([3000]);

Android Quirks

Panggilan ke navigator.vibrateakan segera kembali falsejika pengguna belum mengetuk bingkai atau bingkai yang disematkan. Silakan checkout https://issues.apache.org/jira/browse/CB-14022 untuk informasi lebih lanjut.

Keunikan iOS

• waktu : Mengabaikan waktu yang ditentukan dan bergetar untuk jumlah waktu yang ditentukan sebelumnya.

  navigator.vibrate(3000); // 3000 is ignored
  

  Keunikan Windows

• waktu : Waktu maksimum adalah 5000 ms (5s) dan waktu minimum adalah 1ms

navigator.vibrate(8000); // will be truncated to 5000

Bergetar dengan pola (khusus Android dan Windows)

Getar perangkat dengan pola yang diberikan

navigator.vibrate(pattern);

• pola : Urutan durasi (dalam milidetik) untuk menghidupkan atau mematikan vibrator. (Array Bilangan)

Contoh

// Vibrate for 1 second
// Wait for 1 second
// Vibrate for 3 seconds
// Wait for 1 second
// Vibrate for 5 seconds
navigator.vibrate([1000, 1000, 3000, 1000, 5000]);

Batalkan getaran (tidak didukung di iOS)

Segera membatalkan semua getaran yang sedang berjalan.

navigator.vibrate(0)

atau

navigator.vibrate([])

atau

navigator.vibrate([0])

Melewati parameter 0, array kosong, atau array dengan satu elemen bernilai 0 akan membatalkan semua getaran.