Deskripsi
chrome.bluetoothLowEnergy
API digunakan untuk berkomunikasi dengan perangkat Bluetooth Smart (Hemat Energi) menggunakan Profil Atribut Generik (GATT).
Manifes
Jenis
Advertisement
Properti
-
manufacturerData
ManufacturerData[] opsional
Daftar data khusus produsen yang akan disertakan dalam kolom "Data Khusus Produsen" pada data iklan.
-
serviceData
ServiceData[] opsional
Daftar data layanan yang akan disertakan dalam kolom "Data Layanan" pada data iklan.
-
serviceUuids
string[] opsional
Daftar UUID yang perlu disertakan dalam kolom "UUID Layanan" Data Iklan. UUID ini dapat dalam format 16bit, 32bit atau 128.
-
solicitUuids
string[] opsional
Daftar UUID yang harus disertakan dalam kolom "Meminta UUID" dari Data Iklan. UUID ini dapat dalam format 16bit, 32bit atau 128.
-
tipe
Jenis iklan.
AdvertisementType
Jenis iklan. Jika 'broadcast' dipilih, jenis iklan yang dikirim adalah ADV_NONCONN_IND dan perangkat akan menyiarkan dengan Alamat MAC acak. Jika ditetapkan ke 'periferal', jenis iklan adalah ADV_IND atau ADV_SCAN_IND dan perangkat akan disiarkan dengan Alamat MAC Adaptor Bluetooth yang sebenarnya.
Enum
Characteristic
Properti
-
instanceId
string opsional
Menampilkan ID yang ditetapkan untuk karakteristik ini. Gunakan ID instance untuk membedakan karakteristik dari periferal yang memiliki UUID yang sama dan untuk membuat panggilan fungsi yang menggunakan ID karakteristik. Ada, jika instance ini merepresentasikan karakteristik jarak jauh.
-
properti
Sifat-sifat karakteristik ini.
-
layanan
Layanan opsional
Layanan GATT yang memiliki karakteristik ini.
-
uuid
string
UUID karakteristik, misalnya 00002a37-0000-1000-8000-00805f9b34fb.
-
value
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 mewakili kemungkinan properti karakteristik. Izin karakteristik disimpulkan dari properti ini. Lihat spesifikasi Bluetooth 4.x untuk mengetahui arti dari setiap properti.
Enum
"writeWithoutResponse"
"authenticatedSignedWrites"
"extendedProperties"
"reliableWrite"
"writableAuxiliaries"
"encryptRead"
"encryptWrite"
"encryptAuthenticatedRead"
"encryptAuthenticatedWrite"
ConnectProperties
Properti
-
persisten
boolean
Tanda yang menunjukkan apakah koneksi ke perangkat dibiarkan terbuka saat halaman peristiwa aplikasi dihapus muatannya (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 untuk deskriptor ini. Gunakan ID instance untuk membedakan antara deskriptor dari periferal dengan UUID yang sama dan untuk membuat panggilan fungsi yang menggunakan ID deskriptor. Ada, jika instance ini merepresentasikan karakteristik jarak jauh.
-
izinChrome 52 dan yang lebih baru
Izin deskriptor ini.
-
uuid
string
UUID dari deskriptor karakteristik, misalnya 00002902-0000-1000-8000-00805f9b34fb.
-
value
ArrayBuffer opsional
Nilai deskriptor yang saat ini di-cache. Nilai ini diperbarui saat nilai deskriptor dibaca.
DescriptorPermission
Nilai yang mewakili kemungkinan izin untuk deskriptor. Lihat spesifikasi Bluetooth 4.x untuk mengetahui arti setiap izin.
Enum
"encryptedAuthenticatedRead"
Device
Properti
-
alamat
string
Alamat perangkat, dalam format 'XX:XX:XX:XX:XX:XX'.
-
deviceClass
nomor opsional
Kelas perangkat, bidang bit yang didefinisikan oleh http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.
-
name
string opsional
Nama perangkat yang dapat dibaca manusia.
ManufacturerData
Properti
-
data
angka[]
-
id
angka
Notification
Properti
-
shouldIndicate
boolean opsional
Flag opsional untuk mengirimkan indikasi, bukan notifikasi.
-
value
ArrayBuffer
Nilai baru karakteristik.
NotificationProperties
Properti
-
persisten
boolean
Flag yang menunjukkan apakah aplikasi harus menerima notifikasi saat halaman peristiwa aplikasi dihapus muatannya (lihat Mengelola Siklus Proses Aplikasi). Nilai defaultnya adalah
false
.
Request
Properti
-
perangkat
Perangkat yang mengirim permintaan ini.
-
requestId
angka
ID unik untuk permintaan ini. Gunakan ID ini saat merespons permintaan ini.
-
value
ArrayBuffer opsional
Nilai yang akan ditulis (jika ini adalah permintaan tulis).
Response
Properti
-
isError
boolean
Jika ini adalah respons error, ini seharusnya benar.
-
requestId
angka
ID permintaan yang merupakan respons.
-
value
ArrayBuffer opsional
Nilai respons. Permintaan tulis dan respons error akan mengabaikan parameter ini.
Service
Properti
-
deviceAddress
string opsional
Alamat perangkat periferal jarak jauh tempat layanan GATT berada. Ada, jika instance ini merepresentasikan layanan jarak jauh.
-
instanceId
string opsional
Menampilkan ID yang ditetapkan untuk layanan ini. Gunakan ID instance untuk membedakan layanan dari periferal yang memiliki 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
Properti
-
data
angka[]
-
uuid
string
Metode
connect()
chrome.bluetoothLowEnergy.connect(
deviceAddress: string,
properties?: ConnectProperties,
callback?: function,
)
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 koneksi ke perangkat dipertahankan. Jika perangkat tidak terhubung, semua layanan GATT perangkat akan ditemukan setelah panggilan ke connect
berhasil.
Parameter
-
deviceAddress
string
Alamat Bluetooth perangkat jarak jauh tempat koneksi GATT harus dibuka.
-
properti
ConnectProperties opsional
Properti koneksi (opsional).
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
createCharacteristic()
chrome.bluetoothLowEnergy.createCharacteristic(
characteristic: Characteristic,
serviceId: string,
callback?: function,
)
Buat karakteristik GATT yang dihosting secara lokal. Karakteristik ini harus dihosting di bawah layanan yang valid. Jika ID layanan tidak valid, lastError akan disetel. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
karakteristik
Karakteristik yang akan diciptakan.
-
serviceId
string
ID layanan yang akan digunakan untuk membuat karakteristik ini.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(characteristicId: string) => void
-
characteristicId
string
-
Hasil
-
Promise<string>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
createDescriptor()
chrome.bluetoothLowEnergy.createDescriptor(
descriptor: Descriptor,
characteristicId: string,
callback?: function,
)
Membuat deskriptor GATT yang dihosting secara lokal. Deskripsi 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:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
deskripsi
Deskripsi yang akan dibuat.
-
characteristicId
string
ID karakteristik yang akan digunakan untuk membuat deskripsi ini.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(descriptorId: string) => void
-
descriptorId
string
-
Hasil
-
Promise<string>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
createService()
chrome.bluetoothLowEnergy.createService(
service: Service,
callback?: function,
)
Membuat 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:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
layanan
Layanan yang akan dibuat.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(serviceId: string) => void
-
serviceId
string
-
Hasil
-
Promise<string>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
disconnect()
chrome.bluetoothLowEnergy.disconnect(
deviceAddress: string,
callback?: function,
)
Menutup koneksi aplikasi ke perangkat dengan alamat yang diberikan. Perhatikan bahwa tindakan ini tidak selalu menghancurkan tautan fisiknya, 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 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
getCharacteristic()
chrome.bluetoothLowEnergy.getCharacteristic(
characteristicId: string,
callback?: function,
)
Mendapatkan karakteristik GATT dengan ID instance yang diberikan dan dimiliki layanan GATT yang diberikan, jika karakteristik tersebut ada.
Parameter
-
characteristicId
string
ID instance karakteristik GATT yang diminta.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(result: Characteristic) => void
-
hasil
-
Hasil
-
Promise<Characteristic>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
getCharacteristics()
chrome.bluetoothLowEnergy.getCharacteristics(
serviceId: string,
callback?: function,
)
Dapatkan 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
-
Hasil
-
Promise<Characteristic[]>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
getDescriptor()
chrome.bluetoothLowEnergy.getDescriptor(
descriptorId: string,
callback?: function,
)
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
-
Hasil
-
Promise<Descriptor>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
getDescriptors()
chrome.bluetoothLowEnergy.getDescriptors(
characteristicId: string,
callback?: function,
)
Dapatkan daftar deskripsi karakteristik GATT yang termasuk dalam karakteristik yang ditentukan.
Parameter
-
characteristicId
string
ID instance karakteristik GATT yang deskripsinya harus ditampilkan.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(result: Descriptor[]) => void
-
hasil
-
Hasil
-
Promise<Descriptor[]>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
getIncludedServices()
chrome.bluetoothLowEnergy.getIncludedServices(
serviceId: string,
callback?: function,
)
Mendapatkan daftar layanan GATT yang disertakan oleh layanan tertentu.
Parameter
Hasil
-
Promise<Layanan[]>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
getService()
chrome.bluetoothLowEnergy.getService(
serviceId: string,
callback?: function,
)
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
-
Hasil
-
Promise<Layanan>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
getServices()
chrome.bluetoothLowEnergy.getServices(
deviceAddress: string,
callback?: function,
)
Mendapatkan semua layanan GATT yang ditemukan di perangkat jarak jauh dengan alamat perangkat yang diberikan.
Catatan: Jika penemuan layanan belum selesai di perangkat, API ini akan menampilkan subset (mungkin kosong) layanan. Solusinya adalah menambahkan penundaan berbasis waktu dan/atau panggilan berulang kali hingga jumlah layanan yang diharapkan dikembalikan.
Parameter
Hasil
-
Promise<Layanan[]>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
notifyCharacteristicValueChanged()
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
characteristicId: string,
notification: Notification,
callback?: function,
)
Memberi tahu perangkat jarak jauh tentang nilai baru untuk suatu karakteristik. Jika flag shouldindikasi di objek notifikasi benar, indikasi akan dikirim, bukan notifikasi. Perhatikan bahwa karakteristik perlu menyetel properti 'notify' atau 'tunjukkan' dengan benar selama pembuatan agar panggilan ini berhasil. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
characteristicId
string
Karakteristik yang akan dikirimi notifikasi.
-
notifikasi
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
readCharacteristicValue()
chrome.bluetoothLowEnergy.readCharacteristicValue(
characteristicId: string,
callback?: function,
)
Mengambil nilai karakteristik tertentu dari 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
-
Hasil
-
Promise<Characteristic>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
readDescriptorValue()
chrome.bluetoothLowEnergy.readDescriptorValue(
descriptorId: string,
callback?: function,
)
Mengambil nilai deskriptor karakteristik yang ditentukan dari periferal jarak jauh.
Parameter
-
descriptorId
string
ID instance deskripsi karakteristik GATT yang nilainya harus dibaca dari perangkat jarak jauh.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(result: Descriptor) => void
-
hasil
-
Hasil
-
Promise<Descriptor>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
registerAdvertisement()
chrome.bluetoothLowEnergy.registerAdvertisement(
advertisement: Advertisement,
callback?: function,
)
Buat iklan dan daftarkan untuk iklan. Untuk memanggil fungsi ini, aplikasi harus menyetel izin bluetooth:low_energy dan bluetooth:periferal ke benar (true). Selain itu, API ini hanya tersedia untuk aplikasi yang diluncurkan secara otomatis dalam Mode Kios atau dengan menyetel tombol command line '--enable-ble-advertising-in-apps'. Lihat https://developer.chrome.com/apps/manifest/bluetooth Catatan: Pada 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 maupun periferal, mencoba menggunakan perangkat dalam kedua mode akan menyebabkan perilaku yang tidak ditentukan atau mencegah aplikasi peran sentral lainnya berperilaku dengan benar (termasuk penemuan perangkat Bluetooth Hemat Energi).
Parameter
-
iklan
Iklan yang akan diiklankan.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(advertisementId: number) => void
-
advertisementId
angka
-
Hasil
-
Promise<number>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
registerService()
chrome.bluetoothLowEnergy.registerService(
serviceId: string,
callback?: function,
)
Mendaftarkan layanan yang diberikan ke server GATT lokal. Jika ID layanan tidak valid, lastError akan disetel. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
serviceId
string
ID unik layanan yang dibuat.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
removeService()
chrome.bluetoothLowEnergy.removeService(
serviceId: string,
callback?: function,
)
Menghapus layanan tertentu, membatalkan pendaftarannya jika terdaftar. Jika ID layanan tidak valid, lastError akan disetel. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
serviceId
string
ID unik layanan terdaftar saat ini.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
resetAdvertising()
chrome.bluetoothLowEnergy.resetAdvertising(
callback?: function,
)
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 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
sendRequestResponse()
chrome.bluetoothLowEnergy.sendRequestResponse(
response: Response,
)
Mengirim respons untuk permintaan baca/tulis karakteristik atau deskripsi. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
respons
Respons terhadap permintaan.
setAdvertisingInterval()
chrome.bluetoothLowEnergy.setAdvertisingInterval(
minInterval: number,
maxInterval: number,
callback?: function,
)
{i>Set<i} adalah interval antara dua iklan berturut-turut. Catatan: Ini adalah upaya terbaik. Interval yang sebenarnya mungkin berbeda-beda dari interval yang diminta. Pada beberapa hardware, ada interval minimum 100 md. Nilai minimum dan maksimum tidak boleh melebihi rentang yang diizinkan oleh spesifikasi Bluetooth 4.2.
Parameter
-
minInterval
angka
Interval minimum antariklan (dalam milidetik). Nilai ini tidak boleh lebih rendah dari 20 md (sesuai spesifikasi).
-
maxInterval
angka
Interval maksimum antar-iklan (dalam milidetik). Ini tidak boleh lebih dari 10240 md (sesuai spesifikasi).
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
startCharacteristicNotifications()
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
characteristicId: string,
properties?: NotificationProperties,
callback?: function,
)
Mengaktifkan notifikasi/indikasi nilai dari karakteristik yang ditentukan. Setelah diaktifkan, aplikasi dapat memproses notifikasi menggunakan peristiwa onCharacteristicValueChanged
.
Parameter
-
characteristicId
string
ID instance karakteristik GATT tempat notifikasi harus diaktifkan.
-
properti
NotificationProperties opsional
Properti sesi notifikasi (opsional).
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
stopCharacteristicNotifications()
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
characteristicId: string,
callback?: function,
)
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 tempat sesi notifikasi aplikasi ini harus dihentikan.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
unregisterAdvertisement()
chrome.bluetoothLowEnergy.unregisterAdvertisement(
advertisementId: number,
callback?: function,
)
Membatalkan pendaftaran iklan dan menghentikan iklannya. Jika iklan gagal membatalkan pendaftaran, satu-satunya cara untuk berhenti beriklan 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 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
unregisterService()
chrome.bluetoothLowEnergy.unregisterService(
serviceId: string,
callback?: function,
)
Membatalkan pendaftaran layanan yang diberikan dengan server GATT lokal. Jika ID layanan tidak valid, lastError akan disetel. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
serviceId
string
ID unik layanan terdaftar saat ini.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
writeCharacteristicValue()
chrome.bluetoothLowEnergy.writeCharacteristicValue(
characteristicId: string,
value: ArrayBuffer,
callback?: function,
)
Menulis nilai karakteristik tertentu dari periferal jarak jauh.
Parameter
-
characteristicId
string
ID instance karakteristik GATT yang nilainya harus ditulis.
-
value
ArrayBuffer
Nilai yang harus dikirim ke karakteristik jarak jauh sebagai bagian dari permintaan tulis.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
writeDescriptorValue()
chrome.bluetoothLowEnergy.writeDescriptorValue(
descriptorId: string,
value: ArrayBuffer,
callback?: function,
)
Menulis nilai deskriptor karakteristik yang ditentukan dari periferal jarak jauh.
Parameter
-
descriptorId
string
ID instance deskripsi karakteristik GATT yang nilainya harus ditulis.
-
value
ArrayBuffer
Nilai yang harus dikirim ke deskriptor jarak jauh sebagai bagian dari permintaan tulis.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
Peristiwa
onCharacteristicReadRequest
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 lama dapat menyebabkan koneksi terputus. Peristiwa ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(request: Request, characteristicId: string) => void
-
minta
-
characteristicId
string
-
onCharacteristicValueChanged
chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
callback: function,
)
Diaktifkan saat nilai karakteristik GATT jarak jauh berubah, baik sebagai hasil dari permintaan baca, maupun notifikasi/indikasi perubahan nilai. Peristiwa ini hanya akan dikirim jika aplikasi telah mengaktifkan notifikasi dengan memanggil startCharacteristicNotifications
.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(characteristic: Characteristic) => void
-
karakteristik
-
onCharacteristicWriteRequest
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 lama dapat menyebabkan koneksi terputus. Peristiwa ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(request: Request, characteristicId: string) => void
-
minta
-
characteristicId
string
-
onDescriptorReadRequest
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 lama dapat menyebabkan koneksi terputus. Peristiwa ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(request: Request, descriptorId: string) => void
-
minta
-
descriptorId
string
-
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 dibuat untuk memudahkan dan akan selalu dikirim setelah panggilan berhasil ke readDescriptorValue
.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(descriptor: Descriptor) => void
-
deskripsi
-
onDescriptorWriteRequest
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 lama dapat menyebabkan koneksi terputus. Peristiwa ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:periferal yang disetel ke benar (true). Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(request: Request, descriptorId: string) => void
-
minta
-
descriptorId
string
-
onServiceAdded
chrome.bluetoothLowEnergy.onServiceAdded.addListener(
callback: function,
)
Diaktifkan saat layanan GATT baru ditemukan di perangkat jarak jauh.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(service: Service) => void
-
layanan
-
onServiceChanged
chrome.bluetoothLowEnergy.onServiceChanged.addListener(
callback: function,
)
Diaktifkan saat status layanan GATT jarak jauh berubah. Hal ini melibatkan karakteristik dan/atau deskripsi yang ditambahkan atau dihapus dari layanan, serta notifikasi "ServiceChanged" dari perangkat jarak jauh.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(service: Service) => void
-
layanan
-
onServiceRemoved
chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
callback: function,
)
Diaktifkan saat layanan GATT yang sebelumnya ditemukan di perangkat jarak jauh telah dihapus.