chrome.bluetoothLowEnergy

Deskripsi

chrome.bluetoothLowEnergy API digunakan untuk berkomunikasi dengan perangkat Bluetooth Smart (Hemat Energi) menggunakan Generic Attribute Profile (GATT).

Manifes

Kunci berikut harus dideklarasikan dalam manifes untuk menggunakan API ini.

"bluetooth"

Jenis

Advertisement

Chrome 47+

Properti

  • manufacturerData

    ManufacturerData[] opsional

    Daftar data spesifik produsen yang akan disertakan dalam kolom "Data Spesifik Produsen" pada data iklan.

  • serviceData

    ServiceData[] opsional

    Daftar data layanan yang akan disertakan dalam kolom "Data Layanan" dari data iklan.

  • serviceUuids

    string[] opsional

    Daftar UUID yang akan disertakan di kolom "UUID Layanan" Data Iklan. UUID ini dapat berupa format 16 bit, 32 bit, atau 128 bit.

  • solicitUuids

    string[] opsional

    Daftar UUID yang akan disertakan di kolom "Minta UUID" Data Iklan. UUID ini dapat berupa format 16 bit, 32 bit, atau 128 bit.

  • Jenis iklan.

AdvertisementType

Chrome 47+

Jenis iklan. Jika 'broadcast' dipilih, jenis iklan yang dikirim akan menjadi ADV_NONCONN_IND dan perangkat akan menyiarkan dengan Alamat MAC acak. Jika disetel ke 'peripheral', jenis iklan akan menjadi ADV_IND atau ADV_SCAN_IND dan perangkat akan menyiarkan dengan Alamat MAC Adaptor Bluetooth yang sebenarnya.

Enum

"broadcast"

"peripheral"

Characteristic

Properti

  • instanceId

    string opsional

    Menampilkan ID yang ditetapkan untuk karakteristik ini. Gunakan ID instance untuk membedakan karakteristik dari periferal dengan UUID yang sama dan untuk melakukan panggilan fungsi yang menggunakan ID karakteristik. Ada, jika instance ini mewakili karakteristik jarak jauh.

  • Properti karakteristik ini.

  • layanan

    Layanan opsional

    Layanan GATT yang memiliki karakteristik ini.

  • uuid

    string

    UUID karakteristik, misalnya 00002a37-0000-1000-8000-00805f9b34fb.

  • nilai

    ArrayBuffer opsional

    Nilai karakteristik yang saat ini di-cache. Nilai ini diperbarui saat nilai karakteristik dibaca atau diperbarui melalui notifikasi atau indikasi.

CharacteristicProperty

Nilai yang merepresentasikan kemungkinan properti karakteristik. Izin karakteristik disimpulkan dari properti ini. Lihat spesifikasi Bluetooth 4.x untuk melihat arti setiap properti.

Enum

"broadcast"

"read"

"writeWithoutResponse"

"tulis"

"notify"

"menunjukkan"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Properti

  • persisten

    boolean

    Flag yang menunjukkan apakah koneksi ke perangkat tetap terbuka saat halaman acara aplikasi dibatalkan pemuatannya (lihat Mengelola Siklus Proses Aplikasi). Nilai defaultnya adalah false.

Descriptor

Properti

  • karakteristik

    Karakteristik opsional

    Karakteristik GATT yang dimiliki deskriptor ini.

  • instanceId

    string opsional

    Menampilkan ID yang ditetapkan ke deskriptor ini. Gunakan ID instance untuk membedakan deskriptor dari perangkat periferal dengan UUID yang sama dan untuk melakukan panggilan fungsi yang mengambil ID deskriptor. Ada, jika instance ini mewakili karakteristik jarak jauh.

  • Chrome 52+

    Izin deskriptor ini.

  • uuid

    string

    UUID deskriptor karakteristik, misalnya 00002902-0000-1000-8000-00805f9b34fb.

  • nilai

    ArrayBuffer opsional

    Nilai deskriptor yang saat ini di-cache. Nilai ini diperbarui saat nilai deskriptor dibaca.

DescriptorPermission

Chrome 52+

Nilai yang merepresentasikan kemungkinan izin untuk deskriptor. Lihat spesifikasi Bluetooth 4.x untuk melihat arti setiap izin.

Enum

"read"

"tulis"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52+

Properti

  • alamat

    string

    Alamat perangkat, dalam format 'XX:XX:XX:XX:XX:XX'.

  • deviceClass

    nomor opsional

    Class perangkat, kolom bit yang ditentukan oleh http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

  • nama

    string opsional

    Nama perangkat yang dapat dibaca manusia.

ManufacturerData

Chrome 47+

Properti

  • data

    number[]

  • id

    angka

Notification

Chrome 52+

Properti

  • shouldIndicate

    boolean opsional

    Tanda opsional untuk mengirimkan indikasi, bukan notifikasi.

  • nilai

    ArrayBuffer

    Nilai baru karakteristik.

NotificationProperties

Properti

  • persisten

    boolean

    Flag yang menunjukkan apakah aplikasi harus menerima notifikasi saat halaman acara aplikasi dibatalkan pemuatannya (lihat Mengelola Siklus Proses Aplikasi). Nilai defaultnya adalah false.

Request

Chrome 52+

Properti

  • perangkat

    Perangkat

    Perangkat yang mengirim permintaan ini.

  • requestId

    angka

    ID unik untuk permintaan ini. Gunakan ID ini saat merespons permintaan ini.

  • nilai

    ArrayBuffer opsional

    Nilai yang akan ditulis (jika ini adalah permintaan penulisan).

Response

Chrome 52+

Properti

  • isError

    boolean

    Jika ini adalah respons error, nilainya harus benar (true).

  • requestId

    angka

    ID permintaan yang merupakan respons ini.

  • nilai

    ArrayBuffer opsional

    Nilai respons. Permintaan tulis dan respons error akan mengabaikan parameter ini.

Service

Properti

  • deviceAddress

    string opsional

    Alamat perangkat periferal jarak jauh yang menjadi bagian dari layanan GATT. Ada, jika instance ini merepresentasikan layanan jarak jauh.

  • instanceId

    string opsional

    Menampilkan ID yang ditetapkan ke layanan ini. Gunakan ID instance untuk membedakan layanan dari perangkat periferal dengan UUID yang sama dan untuk melakukan panggilan fungsi yang menggunakan ID layanan. Ada, jika instance ini merepresentasikan layanan jarak jauh.

  • isPrimary

    boolean

    Menunjukkan apakah jenis layanan ini adalah primer atau sekunder.

  • uuid

    string

    UUID layanan, misalnya 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47+

Properti

  • data

    number[]

  • uuid

    string

Metode

connect()

Janji 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
): Promise<void>

Membuat koneksi antara aplikasi dan perangkat dengan alamat yang diberikan. Perangkat mungkin sudah terhubung dan layanan GATT-nya tersedia tanpa memanggil connect, tetapi aplikasi yang ingin mengakses layanan GATT perangkat harus memanggil fungsi ini untuk memastikan bahwa koneksi ke perangkat tetap terjaga. Jika perangkat tidak terhubung, semua layanan GATT perangkat akan ditemukan setelah panggilan berhasil ke connect.

Parameter

  • deviceAddress

    string

    Alamat Bluetooth perangkat jarak jauh yang harus dibuka koneksi GATT-nya.

  • properti

    ConnectProperties opsional

    Properti koneksi (opsional).

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

createCharacteristic()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
): Promise<string>

Buat karakteristik GATT yang dihosting secara lokal. Karakteristik ini harus dihosting di layanan yang valid. Jika ID layanan tidak valid, lastError akan ditetapkan. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • karakteristik

    Karakteristik

    Karakteristik yang akan dibuat.

  • serviceId

    string

    ID layanan untuk membuat karakteristik ini.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (characteristicId: string) => void

    • characteristicId

      string

Hasil

  • Promise<string>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

createDescriptor()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
): Promise<string>

Buat deskriptor GATT yang dihosting secara lokal. Deskriptor ini harus dihosting di bawah karakteristik yang valid. Jika ID karakteristik tidak valid, lastError akan disetel. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • deskripsi

    Descriptor

    Deskriptor yang akan dibuat.

  • characteristicId

    string

    ID karakteristik untuk membuat deskriptor ini.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (descriptorId: string) => void

    • descriptorId

      string

Hasil

  • Promise<string>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

createService()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

Buat layanan GATT yang dihosting secara lokal. Layanan ini dapat didaftarkan agar tersedia di server GATT lokal. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • layanan

    Layanan

    Layanan yang akan dibuat.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (serviceId: string) => void

    • serviceId

      string

Hasil

  • Promise<string>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

disconnect()

Janji 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
): Promise<void>

Menutup koneksi aplikasi ke perangkat dengan alamat yang diberikan. Perhatikan bahwa tindakan ini tidak akan selalu menghancurkan link fisik itu sendiri, karena mungkin ada aplikasi lain dengan koneksi terbuka.

Parameter

  • deviceAddress

    string

    Alamat Bluetooth perangkat jarak jauh.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getCharacteristic()

Janji 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

Mendapatkan karakteristik GATT dengan ID instance tertentu yang termasuk dalam layanan GATT tertentu, jika karakteristiknya ada.

Parameter

  • characteristicId

    string

    ID instance karakteristik GATT yang diminta.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (result: Characteristic) => void

Hasil

  • Promise<Characteristic>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getCharacteristics()

Janji 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
): Promise<Characteristic[]>

Mendapatkan daftar semua karakteristik GATT yang ditemukan dan termasuk dalam layanan tertentu.

Parameter

  • serviceId

    string

    ID instance layanan GATT yang karakteristiknya harus ditampilkan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (result: Characteristic[]) => void

Hasil

  • Promise<Characteristic[]>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getDescriptor()

Janji 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

Mendapatkan deskriptor karakteristik GATT dengan ID instance yang diberikan.

Parameter

  • descriptorId

    string

    ID instance deskriptor karakteristik GATT yang diminta.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (result: Descriptor) => void

Hasil

  • Promise<Descriptor>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getDescriptors()

Janji 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
): Promise<Descriptor[]>

Mendapatkan daftar deskriptor karakteristik GATT yang termasuk dalam karakteristik yang diberikan.

Parameter

  • characteristicId

    string

    ID instance karakteristik GATT yang deskriptornya harus ditampilkan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (result: Descriptor[]) => void

Hasil

  • Promise<Descriptor[]>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getIncludedServices()

Janji 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
): Promise<Service[]>

Mendapatkan daftar layanan GATT yang disertakan oleh layanan tertentu.

Parameter

  • serviceId

    string

    ID instance layanan GATT yang layanan sertanya harus ditampilkan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (result: Service[]) => void

Hasil

  • Promise<Service[]>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getService()

Janji 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
): Promise<Service>

Mendapatkan layanan GATT dengan ID instance yang diberikan.

Parameter

  • serviceId

    string

    ID instance layanan GATT yang diminta.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (result: Service) => void

Hasil

  • Promise<Service>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getServices()

Janji 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
): Promise<Service[]>

Mendapatkan semua layanan GATT yang ditemukan di perangkat jarak jauh dengan alamat perangkat tertentu.

Catatan: Jika penemuan layanan belum selesai di perangkat, API ini akan menampilkan subset (mungkin kosong) layanan. Solusinya adalah menambahkan penundaan berbasis waktu dan/atau melakukan panggilan berulang kali hingga jumlah layanan yang diharapkan ditampilkan.

Parameter

  • deviceAddress

    string

    Alamat Bluetooth perangkat jarak jauh yang layanan GATT-nya harus ditampilkan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (result: Service[]) => void

Hasil

  • Promise<Service[]>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

notifyCharacteristicValueChanged()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

Memberi tahu perangkat jarak jauh tentang nilai baru untuk karakteristik. Jika tanda shouldIndicate dalam objek notifikasi bernilai benar (true), indikasi akan dikirim, bukan notifikasi. Perhatikan bahwa karakteristik harus menyetel properti 'notify' atau 'indicate' dengan benar selama pembuatan agar panggilan ini berhasil. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • characteristicId

    string

    Karakteristik untuk mengirim notifikasi.

  • notifikasi

    Notifikasi

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

readCharacteristicValue()

Janji 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

Mengambil nilai karakteristik tertentu dari perangkat periferal jarak jauh.

Parameter

  • characteristicId

    string

    ID instance karakteristik GATT yang nilainya harus dibaca dari perangkat jarak jauh.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (result: Characteristic) => void

Hasil

  • Promise<Characteristic>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

readDescriptorValue()

Janji 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

Mengambil nilai deskriptor karakteristik tertentu dari perangkat periferal jarak jauh.

Parameter

  • descriptorId

    string

    ID instance deskriptor karakteristik GATT yang nilainya harus dibaca dari perangkat jarak jauh.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (result: Descriptor) => void

Hasil

  • Promise<Descriptor>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

registerAdvertisement()

Promise Chrome 47+ 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

Buat iklan dan daftarkan untuk beriklan. Untuk memanggil fungsi ini, aplikasi harus memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke benar (true). Selain itu, API ini hanya tersedia untuk aplikasi yang diluncurkan otomatis dalam Mode Kios atau dengan menyetel perintah switch command line '--enable-ble-advertising-in-apps'. Lihat https://developer.chrome.com/apps/manifest/bluetooth Catatan: Di beberapa hardware, mode sentral dan periferal secara bersamaan didukung, tetapi di hardware yang tidak mendukungnya, melakukan panggilan ini akan mengalihkan perangkat ke mode periferal. Dalam kasus hardware yang tidak mendukung mode sentral dan periferal, mencoba menggunakan perangkat dalam kedua mode akan menyebabkan perilaku yang tidak terdefinisi atau mencegah aplikasi peran sentral lainnya berperilaku dengan benar (termasuk penemuan perangkat Bluetooth Hemat Energi).

Parameter

  • iklan

    Iklan

    Iklan yang akan diiklankan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (advertisementId: number) => void

    • advertisementId

      angka

Hasil

  • Promise<number>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

registerService()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

Mendaftarkan layanan yang diberikan dengan server GATT lokal. Jika ID layanan tidak valid, lastError akan ditetapkan. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • serviceId

    string

    ID unik layanan yang dibuat.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeService()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

Menghapus layanan yang ditentukan, membatalkan pendaftarannya jika layanan tersebut terdaftar. Jika ID layanan tidak valid, lastError akan ditetapkan. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • serviceId

    string

    ID unik layanan terdaftar saat ini.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

resetAdvertising()

Promise Chrome 61+ 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

Mereset iklan di perangkat saat ini. Tindakan ini akan membatalkan pendaftaran dan menghentikan semua iklan yang ada.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

sendRequestResponse()

Chrome 52+ 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
): void

Mengirim respons untuk permintaan baca/tulis karakteristik atau deskriptor. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • respons

    Respons

    Respons terhadap permintaan.

setAdvertisingInterval()

Promise Chrome 55+ 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

Menetapkan interval antara dua iklan berturut-turut. Catatan: Ini adalah upaya terbaik. Interval sebenarnya dapat bervariasi secara signifikan dari interval yang diminta. Pada beberapa hardware, terdapat interval minimum 100 md. Nilai minimum dan maksimum tidak boleh melebihi rentang yang diizinkan oleh spesifikasi Bluetooth 4.2.

Parameter

  • minInterval

    angka

    Interval minimum antar-iklan (dalam milidetik). Nilai ini tidak boleh lebih rendah dari 20 md (sesuai spesifikasi).

  • maxInterval

    angka

    Interval maksimum antar-iklan (dalam milidetik). Durasi tidak boleh lebih dari 10240 md (sesuai spesifikasi).

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

startCharacteristicNotifications()

Janji 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
): Promise<void>

Mengaktifkan notifikasi/indikasi nilai dari karakteristik yang ditentukan. Setelah diaktifkan, aplikasi dapat memproses notifikasi menggunakan peristiwa onCharacteristicValueChanged.

Parameter

  • characteristicId

    string

    ID instance karakteristik GATT yang notifikasinya harus diaktifkan.

  • properti

    NotificationProperties opsional

    Properti sesi notifikasi (opsional).

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

stopCharacteristicNotifications()

Janji 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
): Promise<void>

Menonaktifkan notifikasi/indikasi nilai dari karakteristik yang ditentukan. Setelah panggilan berhasil, aplikasi akan berhenti menerima notifikasi/indikasi dari karakteristik ini.

Parameter

  • characteristicId

    string

    ID instance karakteristik GATT yang sesi notifikasi aplikasi ini harus dihentikan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

unregisterAdvertisement()

Promise Chrome 47+ 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

Membatalkan pendaftaran iklan dan menghentikan pengiklanannya. Jika iklan gagal membatalkan pendaftaran, satu-satunya cara untuk menghentikan iklan mungkin adalah dengan memulai ulang perangkat.

Parameter

  • advertisementId

    angka

    ID iklan yang akan dibatalkan pendaftarannya.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

unregisterService()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

Membatalkan pendaftaran layanan tertentu dengan server GATT lokal. Jika ID layanan tidak valid, lastError akan ditetapkan. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • serviceId

    string

    ID unik layanan terdaftar saat ini.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

writeCharacteristicValue()

Janji 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

Menulis nilai karakteristik tertentu dari perangkat periferal jarak jauh.

Parameter

  • characteristicId

    string

    ID instance karakteristik GATT yang nilainya harus ditulis.

  • nilai

    ArrayBuffer

    Nilai yang harus dikirim ke karakteristik jarak jauh sebagai bagian dari permintaan penulisan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

writeDescriptorValue()

Janji 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

Menulis nilai deskriptor karakteristik tertentu dari perangkat periferal jarak jauh.

Parameter

  • descriptorId

    string

    ID instance deskriptor karakteristik GATT yang nilainya harus ditulis.

  • nilai

    ArrayBuffer

    Nilai yang harus dikirim ke deskriptor jarak jauh sebagai bagian dari permintaan penulisan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

Acara

onCharacteristicReadRequest

Chrome 52+ 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Diaktifkan saat perangkat pusat yang terhubung meminta untuk membaca nilai karakteristik yang terdaftar di server GATT lokal. Tidak merespons permintaan ini dalam waktu yang lama dapat menyebabkan koneksi terputus. Peristiwa ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang ditetapkan ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (request: Request, characteristicId: string) => void

onCharacteristicValueChanged

chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
  callback: function,
)

Diaktifkan saat nilai karakteristik GATT jarak jauh berubah, baik sebagai hasil dari permintaan baca, atau notifikasi/indikasi perubahan nilai. Peristiwa ini hanya akan dikirim jika aplikasi telah mengaktifkan notifikasi dengan memanggil startCharacteristicNotifications.

Parameter

onCharacteristicWriteRequest

Chrome 52+ 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Diaktifkan saat perangkat pusat yang terhubung meminta untuk menulis nilai karakteristik yang terdaftar di server GATT lokal. Tidak merespons permintaan ini dalam waktu yang lama dapat menyebabkan koneksi terputus. Peristiwa ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang ditetapkan ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (request: Request, characteristicId: string) => void

onDescriptorReadRequest

Chrome 52+ 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Diaktifkan saat perangkat pusat yang terhubung meminta untuk membaca nilai deskriptor yang terdaftar di server GATT lokal. Tidak merespons permintaan ini dalam waktu yang lama dapat menyebabkan koneksi terputus. Peristiwa ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang ditetapkan ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (request: Request, descriptorId: string) => void

onDescriptorValueChanged

chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
  callback: function,
)

Diaktifkan saat nilai deskriptor karakteristik GATT jarak jauh berubah, biasanya sebagai hasil dari permintaan baca. Peristiwa ini sebagian besar ada untuk kemudahan dan akan selalu dikirim setelah panggilan berhasil ke readDescriptorValue.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52+ 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Diaktifkan saat perangkat pusat yang terhubung meminta untuk menulis nilai deskriptor yang terdaftar di server GATT lokal. Tidak merespons permintaan ini dalam waktu yang lama dapat menyebabkan koneksi terputus. Peristiwa ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang ditetapkan ke benar (true). Izin periferal mungkin tidak tersedia untuk semua aplikasi.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (request: Request, descriptorId: string) => void

onServiceAdded

chrome.bluetoothLowEnergy.onServiceAdded.addListener(
  callback: function,
)

Dipicu saat layanan GATT baru telah ditemukan di perangkat jarak jauh.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (service: Service) => void

onServiceChanged

chrome.bluetoothLowEnergy.onServiceChanged.addListener(
  callback: function,
)

Diaktifkan saat status layanan GATT jarak jauh berubah. Hal ini mencakup karakteristik dan/atau deskriptor apa pun yang ditambahkan atau dihapus dari layanan, serta notifikasi "ServiceChanged" dari perangkat jarak jauh.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (service: Service) => void

onServiceRemoved

chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
  callback: function,
)

Diaktifkan saat layanan GATT yang sebelumnya ditemukan di perangkat jarak jauh telah dihapus.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (service: Service) => void