Deskripsi
chrome.bluetoothLowEnergy
API digunakan untuk berkomunikasi dengan perangkat Bluetooth Smart (Hemat Energi) menggunakan Generic Attribute Profile (GATT).
Manifes
Jenis
Advertisement
Properti
-
manufacturerData
ManufacturerData[] opsional
Daftar data khusus produsen yang akan disertakan dalam "Data Khusus Produsen" bidang data iklan.
-
serviceData
ServiceData[] opsional
Daftar data layanan yang akan disertakan dalam "Data Layanan" bidang data iklan.
-
serviceUuids
string[] opsional
Daftar UUID yang akan disertakan dalam "UUID Layanan" bidang Data Iklan. UUID ini dapat berupa format 16bit, 32bit atau 128.
-
solicitUuids
string[] opsional
Daftar UUID yang akan disertakan dalam "UUID Permintaan" bidang Data Iklan. UUID ini dapat berupa format 16bit, 32bit atau 128.
-
jenis
Jenis iklan.
AdvertisementType
Jenis iklan. Jika 'broadcast' dipilih, jenis iklan yang dikirim adalah ADV_NONCONN_IND dan perangkat akan disiarkan dengan Alamat MAC acak. Jika kebijakan disetel ke 'periferal', jenis iklan akan menjadi ADV_IND atau ADV_SCAN_IND dan perangkat akan disiarkan dengan Alamat MAC Adaptor Bluetooth sebenarnya.
Enum
"broadcast"
"periferal"
Characteristic
Properti
-
instanceId
string opsional
Menampilkan ID yang ditetapkan ke karakteristik ini. Gunakan ID instance untuk membedakan antara karakteristik dari periferal dengan UUID yang sama, dan untuk melakukan panggilan fungsi yang menggunakan ID karakteristik. Ada, jika instance ini merepresentasikan karakteristik jarak jauh.
-
properti
Properti dari 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 di-cache saat ini. Nilai ini diupdate saat nilai karakteristik dibaca atau diupdate melalui notifikasi atau indikasi.
CharacteristicProperty
Nilai yang mewakili kemungkinan properti dari suatu karakteristik. Izin karakteristik disimpulkan dari properti ini. Harap lihat spesifikasi Bluetooth 4.x untuk mengetahui arti dari setiap properti.
Enum
"broadcast"
"baca"
"writeWithoutResponse"
"write"
"beri tahu"
"tunjukkan"
"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 memiliki deskripsi ini.
-
instanceId
string opsional
Menampilkan ID yang ditetapkan ke deskriptor ini. Gunakan ID instance untuk membedakan antara deskripsi dari periferal dengan UUID yang sama dan untuk melakukan panggilan fungsi yang menggunakan ID deskriptor. Ada, jika instance ini merepresentasikan karakteristik jarak jauh.
-
izinChrome 52 atau yang lebih baru
Izin deskriptor ini.
-
uuid
string
UUID deskripsi karakteristik, mis. 00002902-0000-1000-8000-00805f9b34fb.
-
nilai
ArrayBuffer opsional
Nilai deskriptor yang di-cache saat ini. Nilai ini diperbarui saat nilai deskriptor dibaca.
DescriptorPermission
Nilai yang mewakili kemungkinan izin untuk deskriptor. Lihat spesifikasi Bluetooth 4.x untuk mengetahui arti dari setiap izin.
Enum
"baca"
"write"
"encryptedRead"
"encryptedWrite"
"encryptedAuthenticatedRead"
"encryptedAuthenticatedWrite"
Device
Properti
-
alamat
string
Alamat perangkat, dalam format 'XX:XX:XX:XX:XX:XX'.
-
deviceClass
angka opsional
Class perangkat, bidang bit yang ditentukan oleh http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.
-
nama
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.
-
nilai
ArrayBuffer
Nilai baru karakteristik.
NotificationProperties
Properti
-
persisten
boolean
Tanda 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.
-
nilai
ArrayBuffer opsional
Nilai yang akan ditulis (jika ini adalah permintaan tulis).
Response
Properti
-
isError
boolean
Jika ini adalah respons error, seharusnya ini benar.
-
requestId
angka
ID permintaan yang menerima respons tersebut.
-
nilai
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 antara layanan dari periferal dengan UUID yang sama dan untuk melakukan panggilan fungsi yang menggunakan ID layanan. Ada, jika instance ini merepresentasikan layanan jarak jauh.
-
Utama
boolean
Menunjukkan apakah jenis layanan ini 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 telah 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 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 ini:() => void
Hasil
-
Janji<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 pada 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 true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
karakteristik
Karakteristik yang akan dibuat.
-
IDlayanan
string
ID layanan yang akan digunakan untuk membuat karakteristik ini.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:(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,
)
Buat deskriptor GATT yang dihosting secara lokal. Deskriptor ini harus dihosting berdasarkan karakteristik yang valid. Jika ID karakteristik tidak valid, lastError akan diatur. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
deskripsi
Deskriptor yang akan dibuat.
-
characteristicId
string
ID karakteristik yang akan dibuatkan deskriptor ini.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:(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,
)
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 true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
layanan
Layanan yang akan dibuat.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:(serviceId: string) => void
-
IDlayanan
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 akan selalu menghancurkan tautan 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 ini:() => void
Hasil
-
Janji<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,
)
Dapatkan karakteristik GATT dengan ID instance yang diberikan yang termasuk dalam layanan GATT yang diberikan, jika karakteristik tersebut ada.
Parameter
-
characteristicId
string
ID instance dari karakteristik GATT yang diminta.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:(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
-
IDlayanan
string
ID instance layanan GATT yang karakteristiknya harus ditampilkan.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:(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,
)
Dapatkan deskriptor karakteristik GATT dengan ID instance yang diberikan.
Parameter
-
descriptorId
string
ID instance dari deskripsi karakteristik GATT yang diminta.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:(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 tertentu.
Parameter
-
characteristicId
string
ID instance karakteristik GATT yang deskripsinya harus ditampilkan.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:(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<Service[]>
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
-
IDlayanan
string
ID instance layanan GATT yang diminta.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:(result: Service) => void
-
hasil
-
Hasil
-
Promise<Service>
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 pada perangkat jarak jauh dengan alamat perangkat yang diberikan.
Catatan: Jika penemuan layanan belum selesai di perangkat, API ini akan menampilkan subkumpulan layanan (mungkin kosong). Solusinya adalah menambahkan penundaan berbasis waktu dan/atau panggilan berulang kali hingga jumlah layanan yang diharapkan dihasilkan.
Parameter
Hasil
-
Promise<Service[]>
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 harusMenunjukkan dalam objek notifikasi benar, indikasi akan dikirim, bukan notifikasi. Perhatikan, karakteristik harus mengatur 'notify' dengan benar atau 'tunjukkan' selama pembuatan agar panggilan ini berhasil. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
characteristicId
string
Karakteristik yang akan dikirim notifikasi.
-
notifikasi
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:() => void
Hasil
-
Janji<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 ini:(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 ini:(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,
)
Membuat dan mendaftarkannya untuk beriklan. Untuk memanggil fungsi ini, aplikasi harus memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang ditetapkan ke true. Selain itu, API ini hanya tersedia untuk aplikasi yang diluncurkan secara otomatis dalam Mode Kios atau dengan menyetel parameter '--enable-ble-advertising-in-apps' {i>command line switch<i}. Lihat https://developer.chrome.com/apps/manifes/bluetooth Catatan: Pada beberapa hardware, mode pusat dan periferal secara bersamaan didukung, tetapi pada hardware yang tidak mendukungnya, melakukan panggilan ini akan mengalihkan perangkat ke mode periferal. Dalam kasus hardware yang tidak mendukung mode pusat dan periferal, berupaya menggunakan perangkat dalam kedua mode akan menyebabkan perilaku yang tidak ditentukan atau mencegah aplikasi peran pusat lainnya berperilaku dengan benar (termasuk penemuan perangkat Bluetooth Hemat Energi).
Parameter
-
iklan
Iklan yang akan diiklankan.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:(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 ditetapkan. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
IDlayanan
string
ID unik layanan yang dibuat.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:() => void
Hasil
-
Janji<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,
)
Hapus layanan yang ditentukan, dan batalkan pendaftarannya jika 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 true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
IDlayanan
string
ID unik layanan yang terdaftar saat ini.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:() => void
Hasil
-
Janji<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 ini:() => void
Hasil
-
Janji<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 deskriptor. Fungsi ini hanya tersedia jika aplikasi memiliki izin bluetooth:low_energy dan bluetooth:peripheral yang disetel ke true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
respons
Respons terhadap permintaan.
setAdvertisingInterval()
chrome.bluetoothLowEnergy.setAdvertisingInterval(
minInterval: number,
maxInterval: number,
callback?: function,
)
Menyetel interval antara dua iklan berturut-turut. Catatan: Ini adalah upaya terbaik. Interval yang sebenarnya dapat berbeda dari yang tidak biasa dari interval yang diminta. Di 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). Waktu ini tidak boleh kurang dari 20 md (sesuai spesifikasi).
-
maxInterval
angka
Interval maksimum antariklan (dalam milidetik). Waktu ini tidak boleh lebih dari 10.240 md (sesuai spesifikasi).
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:() => void
Hasil
-
Janji<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 ini:() => void
Hasil
-
Janji<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,
)
Nonaktifkan 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 ini:() => void
Hasil
-
Janji<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 dan menghentikan iklan. Jika iklan gagal membatalkan pendaftaran, satu-satunya cara untuk menghentikan iklan adalah dengan memulai ulang perangkat.
Parameter
-
advertisementId
angka
ID iklan yang akan dibatalkan pendaftarannya.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:() => void
Hasil
-
Janji<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,
)
Batalkan pendaftaran 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 true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
IDlayanan
string
ID unik layanan yang terdaftar saat ini.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:() => void
Hasil
-
Janji<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.
-
nilai
ArrayBuffer
Nilai yang harus dikirim ke karakteristik jarak jauh sebagai bagian dari permintaan tulis.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:() => void
Hasil
-
Janji<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 deskripsi karakteristik yang ditentukan dari periferal jarak jauh.
Parameter
-
descriptorId
string
ID instance deskripsi karakteristik GATT yang nilainya harus ditulis.
-
nilai
ArrayBuffer
Nilai yang harus dikirim ke deskriptor jarak jauh sebagai bagian dari permintaan tulis.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:() => void
Hasil
-
Janji<void>
Chrome 91 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
Acara
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:peripheral yang disetel ke true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti ini:(request: Request, characteristicId: string) => void
-
minta
-
characteristicId
string
-
onCharacteristicValueChanged
chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
callback: function,
)
Diaktifkan jika nilai karakteristik GATT jarak jauh berubah, baik sebagai akibat dari permintaan baca, atau notifikasi/indikasi perubahan nilai. Peristiwa ini hanya akan dikirim jika aplikasi telah mengaktifkan notifikasi dengan memanggil startCharacteristicNotifications
.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti ini:(characteristic: Characteristic) => void
-
karakteristik
-
onCharacteristicWriteRequest
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
callback: function,
)
Diaktifkan jika 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:peripheral yang disetel ke true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti ini:(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:peripheral yang disetel ke true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti ini:(request: Request, descriptorId: string) => void
-
minta
-
descriptorId
string
-
onDescriptorValueChanged
chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
callback: function,
)
Diaktifkan jika nilai deskripsi karakteristik GATT jarak jauh berubah, biasanya akibat 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 ini:(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:peripheral yang disetel ke true. Izin periferal mungkin hanya tersedia untuk aplikasi tertentu.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti ini:(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 ini:(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 deskriptor yang ditambahkan atau dihapus dari layanan, serta "ServiceChanges" notifikasi dari perangkat jarak jauh.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti ini:(service: Service) => void
-
layanan
-
onServiceRemoved
chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
callback: function,
)
Diaktifkan jika layanan GATT yang sebelumnya ditemukan pada perangkat jarak jauh telah dihapus.