Bluetooth - SuperApp

Topik ini menjelaskan API JavaScript dari WVBluetooth. Anda dapat merujuk pada topik ini saat membuat aplikasi HTML5 atau Miniapps. Gunakan API JavaScript dari WVBluetooth untuk meminta izin Bluetooth, mencari perangkat Bluetooth Low Energy (BLE), menghubungkan perangkat tempat aplikasi berjalan ke perangkat Bluetooth, serta menanyakan semua layanan terkait perangkat BLE.

WVBluetooth.requestAuthorization

Meminta izin dan mengaktifkan Bluetooth.

Parameter Input

Tidak ada parameter input yang diperlukan.

Parameter Callback

Parameter untuk callback sukses:

[object]value: sebuah objek JSON. Objek ini berisi parameter kunci berikut beserta nilai yang sesuai:
- [string]state: 'poweredOn'.

Parameter untuk callback gagal:

[string]msg: pesan kesalahan.

window.WindVane.call('WVBluetooth', 'requestAuthorization', {}, function(e) {
        alert('sukses: ' + JSON.stringify(e));
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
});

WVBluetooth.scan

Mencari perangkat BLE.

Parameter Input

Tidak ada parameter input yang diperlukan.

Parameter Callback

Parameter untuk callback sukses:

Tidak ada parameter callback yang diperlukan.

Parameter untuk callback gagal:

[string]msg: pesan kesalahan.

Pendengaran Event

WV.Event.WVBluetooth.discoverDevice: Menemukan perangkat BLE.

Parameter event:

[string]name: nama perangkat Bluetooth.
[string]devceId: alamat perangkat Bluetooth.

document.addEventListener('WV.Event.WVBluetooth.discoverDevice', function (e) {
        alert('event discoverDevice: ' + JSON.stringify(e.param));
});

window.WindVane.call('WVBluetooth', 'scan', {}, function(e) {
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
}

WVBluetooth.stopScan

Menghentikan pencarian perangkat BLE.

Parameter Input

Tidak ada parameter input yang diperlukan.

Parameter Callback

Parameter untuk callback sukses:

Tidak ada parameter callback yang diperlukan.

Parameter untuk callback gagal:

[string]msg: pesan kesalahan.

window.WindVane.call('WVBluetooth', 'stopScan', {}, function(e) {
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
}

WVBluetooth.connect

Menghubungkan perangkat tempat aplikasi berjalan ke perangkat Bluetooth dengan alamat tertentu.

Parameter Input

[string]deviceId: alamat perangkat Bluetooth yang akan dihubungkan.

Parameter Callback

Parameter untuk callback sukses:

Tidak ada parameter callback yang diperlukan.

Parameter untuk callback gagal:

[string]msg: pesan kesalahan.

var params = {
  deviceId: '00:aa:bb:cc:dd'
};

window.WindVane.call('WVBluetooth', 'connect', params, function(e) {
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
}

WVBluetooth.disconnect

Memutuskan koneksi perangkat Bluetooth yang terhubung.

Parameter Input

Tidak ada parameter input yang diperlukan.

Parameter Callback

Parameter untuk callback sukses:

Tidak ada parameter callback yang diperlukan.

Parameter untuk callback gagal:

[string]msg: pesan kesalahan.

Pendengaran Event

WV.Event.WVBluetooth.GATTServerDisconnected: Koneksi BLE terputus

document.addEventListener('WV.Event.WVBluetooth.GATTServerDisconnected', function (e) {
        alert('event GATTServerDisconnected: ' + JSON.stringify(e.param));
});
window.WindVane.call('WVBluetooth', 'disconnect', {}, function(e) {
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
}

WVBluetooth.getServices

Menanyakan layanan terkait perangkat BLE.

Parameter Input

[string]deviceId: alamat perangkat Bluetooth.

Catatan

Anda harus terlebih dahulu menghubungkan perangkat tempat aplikasi berjalan ke perangkat Bluetooth.

Parameter Callback

Parameter untuk callback gagal:

[string]msg: pesan kesalahan.

var params = {
  deviceId: '00:aa:bb:cc:dd'
};
window.WindVane.call('WVBluetooth', 'getServices', params, function(e) {
  			alert('sukses: ' + JSON.stringify(e));
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
}

WVBluetooth.getCharacteristics

Mendapatkan semua nilai karakteristik perangkat BLE.

Parameter Input

[string]deviceId: alamat perangkat Bluetooth.
Catatan
Anda harus terlebih dahulu menghubungkan perangkat tempat aplikasi berjalan ke perangkat Bluetooth.
[string]serviceId: ID layanan. ID harus dalam format UUID.

Parameter Callback

Parameter untuk callback sukses:

[object]characteristics: sebuah array JSON. Setiap objek JSON dalam array berisi parameter kunci berikut beserta nilai yang sesuai:
- [string]characteristicId: ID nilai karakteristik. ID harus dalam format UUID.

Parameter untuk callback gagal:

[string]msg: pesan kesalahan.

var params = {
  deviceId: '00:aa:bb:cc:dd', 
  serviceId: 'xxxx'
};
window.WindVane.call('WVBluetooth', 'getCharacteristics', params, function(e) {
  			alert('sukses: ' + JSON.stringify(e));
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
}

WVBluetooth.writeValue

Menulis nilai karakteristik tertentu ke perangkat BLE yang terhubung.

Parameter Input

[string]deviceId: alamat perangkat Bluetooth. Harap dicatat bahwa Anda harus terlebih dahulu menghubungkan perangkat tempat aplikasi berjalan ke perangkat Bluetooth.
[string]serviceId: ID layanan. ID harus dalam format UUID.
[string]characteristicId: ID nilai karakteristik. ID harus dalam format UUID.
[string]value: nilai yang akan ditulis.
Catatan
Nilai string sebelumnya dikodekan menggunakan Base64.

Parameter Callback

Parameter untuk callback sukses:

Tidak ada parameter callback yang diperlukan.

Parameter untuk callback gagal:

[string]msg: pesan kesalahan.

Pendengaran Event

WV.Event.WVBluetooth.characteristicValueChanged: Nilai characteristicValue berubah (memerlukan startNotifications untuk membuka notifikasi).

var params = {
  deviceId: '00:aa:bb:cc:dd', 
  serviceId: 'xxxx',
  characteristicId: 'xxx',
  value: 'xxx'
};
window.WindVane.call('WVBluetooth', 'writeValue', params, function(e) {
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
}

WVBluetooth.readValue

Membaca nilai karakteristik tertentu dari perangkat BLE yang terhubung.

Parameter Input

[string]deviceId: alamat perangkat Bluetooth.
Catatan
Anda harus terlebih dahulu menghubungkan perangkat tempat aplikasi berjalan ke perangkat Bluetooth.
[string]serviceId: ID layanan. ID harus dalam format UUID.
[string]characteristicId: ID nilai karakteristik. ID harus dalam format UUID.

Parameter Callback

Parameter untuk callback sukses:

Tidak ada parameter callback yang diperlukan.

Parameter untuk callback gagal:

[string]msg: pesan kesalahan.

var params = {
  deviceId: '00:aa:bb:cc:dd', 
  serviceId: 'xxxx',
  characteristicId: 'xxx',
};
window.WindVane.call('WVBluetooth', 'readValue', params, function(e) {
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
}

WVBluetooth.startNotifications

Mengaktifkan notifikasi perubahan nilai karakteristik.

Parameter Input

[string]deviceId: alamat perangkat Bluetooth.
Catatan
Anda harus terlebih dahulu menghubungkan perangkat tempat aplikasi berjalan ke perangkat Bluetooth.
[string]serviceId: ID layanan. ID harus dalam format UUID.
[string]characteristicId: ID nilai karakteristik. ID harus dalam format UUID.

Parameter Callback

Parameter untuk callback sukses:

Tidak ada parameter callback yang diperlukan.

Parameter untuk callback gagal:

[string]msg: pesan kesalahan.

var params = {
  deviceId: '00:aa:bb:cc:dd', 
  serviceId: 'xxxx',
  characteristicId: 'xxx',
};
window.WindVane.call('WVBluetooth', 'startNotifications', params, function(e) {
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
}

WVBluetooth.stopNotifications

Menonaktifkan notifikasi perubahan nilai karakteristik.

Parameter Input

[string]deviceId: alamat perangkat Bluetooth.
Catatan
Anda harus terlebih dahulu menghubungkan perangkat tempat aplikasi berjalan ke perangkat Bluetooth.
[string]serviceId: ID layanan. ID harus dalam format UUID.
[string]characteristicId: ID nilai karakteristik. ID harus dalam format UUID.

Parameter Callback

Parameter untuk callback sukses:

Tidak ada parameter callback yang diperlukan.

Parameter untuk callback gagal:

[string]msg: pesan kesalahan.

var params = {
  deviceId: '00:aa:bb:cc:dd', 
  serviceId: 'xxxx',
  characteristicId: 'xxx',
};
window.WindVane.call('WVBluetooth', 'stopNotifications', params, function(e) {
}, function(e) {
        alert('gagal: ' + JSON.stringify(e));
}