Açıklama
chrome.bluetoothLowEnergy
API, Genel Özellik Profili (GATT) aracılığıyla Bluetooth Smart (Düşük Enerji) cihazlarıyla iletişim kurmak için kullanılır.
Manifest
Türler
Advertisement
Özellikler
-
manufacturerData
ManufacturerData[] isteğe bağlı
Reklam verilerinin "Üreticiye Özel Veriler" alanlarına dahil edilecek üreticiye özel verilerin listesi.
-
serviceData
ServiceData[] isteğe bağlı
Reklamcılık verilerinin "Hizmet Verileri" alanlarına dahil edilecek hizmet verilerinin listesi.
-
serviceUuids
string[] isteğe bağlı
Reklam Verilerinin "Hizmet UUID'leri" alanına eklenecek UUID'lerin listesi. Bu UUID'ler 16 bit, 32 bit veya 128 biçimlerinde olabilir.
-
solicitUuids
string[] isteğe bağlı
Reklam Verilerinin "UUID iste" alanına eklenecek UUID'lerin listesi. Bu UUID'ler 16 bit, 32 bit veya 128 biçimlerinde olabilir.
-
Reklamın türü.
AdvertisementType
Reklamın türü. 'Yayın' seçilirse, gönderilen reklam türü ADV_NONCONN_IND olur ve cihaz rastgele bir MAC Adresi ile yayın yapar. 'Çevre birimi' olarak ayarlanırsa, reklam türü ADV_IND veya ADV_SCAN_IND olur ve cihaz, gerçek Bluetooth Adaptörü'nün MAC Adresi ile yayın yapar.
Enum
"broadcast"
Characteristic
Özellikler
-
instanceId
string isteğe bağlı
Bu özelliğe atanan tanımlayıcıyı döndürür. Aynı UUID'ye sahip bir çevre biriminin özelliklerini birbirinden ayırt etmek ve karakteristik bir tanımlayıcı alan işlev çağrıları yapmak için örnek kimliğini kullanın. Bu örnek, uzak bir özelliği temsil ediyorsa mevcut kullanın.
-
mülkler
Bu özelliğin özellikleri.
-
hizmet
Hizmet isteğe bağlı
Bu özelliğin ait olduğu GATT hizmeti.
-
uuid
dize
Özelliğin UUID'si, ör. 00002a37-0000-1000-8000-00805f9b34fb.
-
value
ArrayBuffer isteğe bağlı
Mevcut önbelleğe alınmış karakteristik değer. Bu değer, özelliğin değeri bir bildirim veya gösterge aracılığıyla okunduğunda veya güncellendiğinde güncellenir.
CharacteristicProperty
Bir özelliğin olası özelliklerini temsil eden değerler. Karakteristik izinler bu mülklerden tahmin edilir. Her bir özelliğin anlamını görmek için lütfen Bluetooth 4.x spesifikasyonuna bakın.
Enum
"broadcast"
"writeWithoutResponse"
"write"
"extendedProperties"
"reliableWrite"
"writableAuxiliaries"
"encryptRead"
"encryptWrite"
"encryptAuthenticatedRead"
"encryptAuthenticatedWrite"
ConnectProperties
Özellikler
-
inatçı
boolean
Uygulamanın etkinlik sayfası kaldırıldığında cihaz bağlantısının açık kalıp kalmadığını gösteren işaret (Uygulama Yaşam Döngüsünü Yönetme bölümüne bakın). Varsayılan değer:
false.
Descriptor
Özellikler
-
özelliği
Özellik isteğe bağlı
Bu tanımlayıcının ait olduğu GATT özelliği.
-
instanceId
string isteğe bağlı
Bu açıklayıcıya atanan tanımlayıcıyı döndürür. Aynı UUID'ye sahip bir çevre biriminden açıklayıcıları ayırt etmek ve bir açıklayıcı tanımlayıcı alan işlev çağrıları yapmak için örnek kimliğini kullanın. Bu örnek, uzak bir özelliği temsil ediyorsa mevcut kullanın.
-
izinlerChrome 52 ve sonraki sürümler
Bu açıklayıcının izinleri.
-
uuid
dize
Karakteristik açıklayıcının UUID'si, ör. 00002902-0000-1000-8000-00805f9b34fb.
-
value
ArrayBuffer isteğe bağlı
Önbelleğe alınmış olan açıklayıcı değer. Bu değer, açıklayıcının değeri okunduğunda güncellenir.
DescriptorPermission
Bir açıklayıcı için olası izinleri temsil eden değerler. Her bir iznin ne anlama geldiğini görmek için lütfen Bluetooth 4.x spesifikasyonuna bakın.
Enum
"write"
"encryptedRead"
"encryptedWrite"
"encryptedAuthenticatedRead"
"encryptedAuthenticatedWrite"
Device
Özellikler
-
adres
dize
Cihazın "XX:XX:XX:XX:XX:XX" biçimindeki adresi.
-
deviceClass
numara isteğe bağlı
http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband tarafından tanımlanan bit alanı olan cihaz sınıfı.
-
ad
string isteğe bağlı
Cihazın kullanıcılar tarafından okunabilen adı.
ManufacturerData
Özellikler
-
veri
numara[]
-
id
sayı
Notification
Özellikler
-
shouldIndicate
boole isteğe bağlı
Bildirim yerine gösterge göndermek için isteğe bağlı işaret.
-
value
ArrayBuffer
Özelliğin yeni değeri.
NotificationProperties
Özellikler
-
inatçı
boolean
Uygulamanın etkinlik sayfası kaldırıldığında uygulamanın bildirim alıp almayacağını gösteren işaret (bkz. Uygulama Yaşam Döngüsünü Yönetme). Varsayılan değer
false
değeridir.
Request
Özellikler
-
cihaz
Bu isteği gönderen cihaz.
-
requestId
sayı
Bu isteğin benzersiz kimliği. Bu isteğe yanıt verirken bu kimliği kullanın.
-
value
ArrayBuffer isteğe bağlı
Yazılacak değer (bu bir yazma isteğiyse).
Response
Özellikler
-
isError
boolean
Bu bir hata yanıtıysa doğru olmalıdır.
-
requestId
sayı
Bu yanıtın gönderildiği isteğin kimliği.
-
value
ArrayBuffer isteğe bağlı
Yanıt değeri. Yazma istekleri ve hata yanıtları bu parametreyi yoksayar.
Service
Özellikler
-
deviceAddress
string isteğe bağlı
GATT hizmetinin ait olduğu uzak çevre biriminin cihaz adresi. Bu örnek, uzak bir hizmeti temsil ediyorsa mevcut.
-
instanceId
string isteğe bağlı
Bu hizmete atanan tanımlayıcıyı döndürür. Aynı UUID'ye sahip bir çevre biriminden hizmetleri birbirinden ayırt etmek ve bir hizmet tanımlayıcısını alan işlev çağrıları yapmak için örnek kimliğini kullanın. Bu örnek, uzak bir hizmeti temsil ediyorsa mevcut.
-
isPrimary
boolean
Bu hizmetin türünün birincil mi yoksa ikincil mi olduğunu belirtir.
-
uuid
dize
Hizmetin UUID'si, ör. 0000180d-0000-1000-8000-00805f9b34fb.
ServiceData
Özellikler
-
veri
numara[]
-
uuid
dize
Yöntemler
connect()
chrome.bluetoothLowEnergy.connect(
deviceAddress: string,
properties?: ConnectProperties,
callback?: function,
)
Belirtilen adrese sahip uygulama ile cihaz arasında bir bağlantı oluşturur. Bir cihaz zaten bağlanmış ve connect
çağrılmadan cihazın GATT hizmetleri kullanılabilir durumda olabilir. Ancak, bir cihazın GATT hizmetlerine erişmek isteyen bir uygulama, cihazla bağlantının sürdürülmesini sağlamak için bu işlevi çağırmalıdır. Cihaz bağlı değilse cihazın tüm GATT hizmetleri, connect
numaralı telefona yapılan başarılı bir çağrıdan sonra keşfedilir.
Parametreler
-
deviceAddress
dize
GATT bağlantısının açılacağı uzak cihazın Bluetooth adresi.
-
mülkler
ConnectProperties isteğe bağlı
Bağlantı özellikleri (isteğe bağlı).
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
createCharacteristic()
chrome.bluetoothLowEnergy.createCharacteristic(
characteristic: Characteristic,
serviceId: string,
callback?: function,
)
Yerel olarak barındırılan bir GATT özelliği oluşturun. Bu özellik geçerli bir hizmet altında barındırılmalıdır. Hizmet kimliği geçerli değilse lastError ayarlanır. Bu işlev yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
özelliği
Oluşturulacak özellik.
-
serviceId
dize
Bu özelliğin oluşturulacağı hizmetin kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(characteristicId: string) => void
-
characteristicId
dize
-
İlerlemeler
-
Söz<dize>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
createDescriptor()
chrome.bluetoothLowEnergy.createDescriptor(
descriptor: Descriptor,
characteristicId: string,
callback?: function,
)
Yerel olarak barındırılan bir GATT tanımlayıcısı oluşturun. Bu açıklayıcı, geçerli bir özellik altında barındırılmalıdır. Karakteristik kimlik geçerli değilse lastError ayarlanır. Bu işlev yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
açıklayıcı
Oluşturulacak açıklayıcı.
-
characteristicId
dize
Bu açıklayıcının oluşturulacağı özelliğin kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(descriptorId: string) => void
-
descriptorId
dize
-
İlerlemeler
-
Söz<dize>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
createService()
chrome.bluetoothLowEnergy.createService(
service: Service,
callback?: function,
)
Yerel olarak barındırılan bir GATT hizmeti oluşturun. Bu hizmet yerel bir GATT sunucusunda kullanılabilir olmak üzere kaydedilebilir. Bu işlev yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
hizmet
Oluşturulacak hizmet.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(serviceId: string) => void
-
serviceId
dize
-
İlerlemeler
-
Söz<dize>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
disconnect()
chrome.bluetoothLowEnergy.disconnect(
deviceAddress: string,
callback?: function,
)
Uygulamanın belirtilen adrese sahip cihazla bağlantısını kapatır. Açık bağlantıları olan başka uygulamalar olabileceğinden, bunun fiziksel bağlantının kendisini her zaman kaldırmayacağını unutmayın.
Parametreler
-
deviceAddress
dize
Uzak cihazın Bluetooth adresi.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getCharacteristic()
chrome.bluetoothLowEnergy.getCharacteristic(
characteristicId: string,
callback?: function,
)
Söz konusu özellik mevcutsa söz konusu GATT hizmetine ait olan örnek kimliğiyle birlikte GATT özelliğini alın.
Parametreler
-
characteristicId
dize
İstenen GATT özelliğinin örnek kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: Characteristic) => void
-
sonuç
-
İlerlemeler
-
Promise<Characteristic>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getCharacteristics()
chrome.bluetoothLowEnergy.getCharacteristics(
serviceId: string,
callback?: function,
)
Belirli bir hizmete ait keşfedilen tüm GATT özelliklerinin listesini alma.
Parametreler
-
serviceId
dize
Özellikleri döndürülmesi gereken GATT hizmetinin örnek kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: Characteristic[]) => void
-
sonuç
Özellik[]
-
İlerlemeler
-
Promise<Characteristic[]>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getDescriptor()
chrome.bluetoothLowEnergy.getDescriptor(
descriptorId: string,
callback?: function,
)
Verilen örnek kimliğine sahip GATT özellik tanımlayıcısını alın.
Parametreler
-
descriptorId
dize
İstenen GATT özellik tanımlayıcısının örnek kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: Descriptor) => void
-
sonuç
-
İlerlemeler
-
Promise<Descriptor>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getDescriptors()
chrome.bluetoothLowEnergy.getDescriptors(
characteristicId: string,
callback?: function,
)
Belirtilen özelliğe ait GATT özellik tanımlayıcılarının listesini alın.
Parametreler
-
characteristicId
dize
Tanımlayıcılarının döndürülmesi gereken GATT özelliğinin örnek kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: Descriptor[]) => void
-
sonuç
-
İlerlemeler
-
Promise<Descriptor[]>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getIncludedServices()
chrome.bluetoothLowEnergy.getIncludedServices(
serviceId: string,
callback?: function,
)
İlgili hizmete dahil olan GATT hizmetlerinin listesini alma.
Parametreler
İlerlemeler
-
Taahhüt<Hizmet[]>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getService()
chrome.bluetoothLowEnergy.getService(
serviceId: string,
callback?: function,
)
Verilen örnek kimliğiyle GATT hizmetini alın.
Parametreler
-
serviceId
dize
İstenen GATT hizmetinin örnek kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: Service) => void
-
sonuç
-
İlerlemeler
-
Taahhüt<Hizmet>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getServices()
chrome.bluetoothLowEnergy.getServices(
deviceAddress: string,
callback?: function,
)
Belirtilen cihaz adresine sahip uzak cihazda bulunan tüm GATT hizmetlerini al.
Not: Cihazda hizmet keşfi henüz tamamlanmamışsa bu API, hizmetlerin bir alt kümesini (büyük olasılıkla boş) döndürür. Geçici bir çözüm olarak, beklenen sayıda hizmet döndürülünceye kadar zamana dayalı gecikme ve/veya çağrı tekrarlayabilirsiniz.
Parametreler
İlerlemeler
-
Taahhüt<Hizmet[]>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
notifyCharacteristicValueChanged()
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
characteristicId: string,
notification: Notification,
callback?: function,
)
Uzak bir cihaza bir özellik için yeni bir değer bildirir. Bildirim nesnesindeki shouldGösterge bayrağı true (doğru) ise bildirim yerine bir gösterge gönderilir. Bu çağrının başarılı olması için özelliğin, oluşturma sırasında "bilgilendir" veya "göster" mülkünü doğru şekilde ayarlaması gerektiğini unutmayın. Bu işlev yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
characteristicId
dize
Bildirimin gönderileceği özellik.
-
notification
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
readCharacteristicValue()
chrome.bluetoothLowEnergy.readCharacteristicValue(
characteristicId: string,
callback?: function,
)
Uzak çevre biriminden belirtilen bir özelliğin değerini alın.
Parametreler
-
characteristicId
dize
Değeri uzak cihazdan okunması gereken GATT özelliğinin örnek kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: Characteristic) => void
-
sonuç
-
İlerlemeler
-
Promise<Characteristic>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
readDescriptorValue()
chrome.bluetoothLowEnergy.readDescriptorValue(
descriptorId: string,
callback?: function,
)
Uzak bir çevre biriminden, belirtilen bir karakteristik tanımlayıcının değerini alın.
Parametreler
-
descriptorId
dize
Değeri uzak cihazdan okunması gereken GATT özellik tanımlayıcısının örnek kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: Descriptor) => void
-
sonuç
-
İlerlemeler
-
Promise<Descriptor>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
registerAdvertisement()
chrome.bluetoothLowEnergy.registerAdvertisement(
advertisement: Advertisement,
callback?: function,
)
Bir reklam oluşturun ve bunu reklamcılık için kaydedin. Bu işlevi çağırmak için uygulamanın bluetooth:low_energy ve bluetooth:çevre birimi izinlerinin true olarak ayarlanması gerekir. Ayrıca bu API yalnızca Kiosk Modu'nda otomatik olarak başlatılan uygulamalar için veya "--enable-ble-advertising-in-apps" komut satırı anahtarını ayarlayarak kullanılabilir. https://developer.chrome.com/apps/manifest/bluetooth adresine bakın Not: Bazı donanımlarda aynı anda merkezi ve çevre birimi modları desteklenir ancak bunu desteklemeyen donanımlarda bu çağrıyı yaptığınızda cihaz çevre birimi moduna geçer. Hem merkezi hem de çevre birimi modunu desteklemeyen donanımlar söz konusu olduğunda, cihazın her iki modda da kullanılması tanımlanmamış davranışa neden olur veya diğer merkezi rol uygulamalarının düzgün şekilde çalışmasını (Bluetooth Düşük Enerjili cihazların keşfi de dahil) engeller.
Parametreler
-
reklam
Reklamı yapılacak reklam.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(advertisementId: number) => void
-
advertisementId
sayı
-
İlerlemeler
-
Vaat<sayı>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
registerService()
chrome.bluetoothLowEnergy.registerService(
serviceId: string,
callback?: function,
)
Söz konusu hizmeti yerel GATT sunucusuna kaydedin. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
serviceId
dize
Oluşturulan bir hizmetin benzersiz kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
removeService()
chrome.bluetoothLowEnergy.removeService(
serviceId: string,
callback?: function,
)
Belirtilen hizmeti kaldırın ve kayıtlıysa kaydını iptal edin. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
serviceId
dize
Geçerli olarak kayıtlı hizmetin benzersiz kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
resetAdvertising()
chrome.bluetoothLowEnergy.resetAdvertising(
callback?: function,
)
Geçerli cihazdaki reklamları sıfırlar. Bu, kaydı iptal eder ve mevcut tüm reklamları durdurur.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
sendRequestResponse()
chrome.bluetoothLowEnergy.sendRequestResponse(
response: Response,
)
Bir karakteristik veya açıklayıcı okuma/yazma isteği için yanıt gönderir. Bu işlev yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
yanıt
İsteğe verilen yanıt.
setAdvertisingInterval()
chrome.bluetoothLowEnergy.setAdvertisingInterval(
minInterval: number,
maxInterval: number,
callback?: function,
)
Art arda iki reklam arasındaki aralığı belirler. Not: Bunu yapmaya çalışalım. Gerçek aralık, istenen aralıklardan önemli ölçüde farklı olabilir. Bazı donanımlarda minimum 100 ms aralık mevcuttur. Minimum ve maksimum değerler, Bluetooth 4.2 spesifikasyonu tarafından izin verilen aralığı aşamaz.
Parametreler
-
minInterval
sayı
Reklamlar arasındaki minimum aralık (milisaniye cinsinden). Spesifikasyona göre 20 ms'den düşük olamaz.
-
maxInterval
sayı
Reklamlar arasındaki maksimum aralık (milisaniye cinsinden). Bu değer, spesifikasyona göre 10.240 ms'den fazla olamaz.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
startCharacteristicNotifications()
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
characteristicId: string,
properties?: NotificationProperties,
callback?: function,
)
Belirtilen özellikten değer bildirimlerini/göstergelerini etkinleştirin. Etkinleştirildiğinde, bir uygulama onCharacteristicValueChanged
etkinliğini kullanarak bildirimleri dinleyebilir.
Parametreler
-
characteristicId
dize
Bildirimlerin etkinleştirilmesi gereken GATT özelliğinin örnek kimliği.
-
mülkler
NotificationProperties isteğe bağlı
Bildirim oturumu özellikleri (isteğe bağlı).
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
stopCharacteristicNotifications()
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
characteristicId: string,
callback?: function,
)
Belirtilen özellikten değer bildirimlerini/göstergelerini devre dışı bırakın. Başarılı bir aramadan sonra uygulama, bu özellikle ilgili bildirimleri veya belirtileri almayı durdurur.
Parametreler
-
characteristicId
dize
Bu uygulamanın bildirim oturumunun durdurulması gereken GATT özelliğinin örnek kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
unregisterAdvertisement()
chrome.bluetoothLowEnergy.unregisterAdvertisement(
advertisementId: number,
callback?: function,
)
Bir reklamın kaydını iptal eder ve reklamını durdurur. Reklam kaydı iptal edilemezse, reklamı durdurmanın tek yolu cihazı yeniden başlatmak olabilir.
Parametreler
-
advertisementId
sayı
Kaydı iptal edilecek reklamın kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
unregisterService()
chrome.bluetoothLowEnergy.unregisterService(
serviceId: string,
callback?: function,
)
Söz konusu hizmetin yerel GATT sunucusundaki kaydını iptal edin. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
serviceId
dize
Geçerli olarak kayıtlı hizmetin benzersiz kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
writeCharacteristicValue()
chrome.bluetoothLowEnergy.writeCharacteristicValue(
characteristicId: string,
value: ArrayBuffer,
callback?: function,
)
Uzak çevre biriminden belirtilen bir özelliğin değerini yazın.
Parametreler
-
characteristicId
dize
Değerinin yazılması gereken GATT özelliğinin örnek kimliği.
-
value
ArrayBuffer
Yazma isteğinin bir parçası olarak uzak özelliğe gönderilmesi gereken değer.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
writeDescriptorValue()
chrome.bluetoothLowEnergy.writeDescriptorValue(
descriptorId: string,
value: ArrayBuffer,
callback?: function,
)
Uzak bir çevre biriminden belirtilen bir karakteristik tanımlayıcının değerini yazın.
Parametreler
-
descriptorId
dize
Değerinin yazılması gereken GATT özellik tanımlayıcısının örnek kimliği.
-
value
ArrayBuffer
Yazma isteğinin bir parçası olarak uzak tanımlayıcıya gönderilmesi gereken değer.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
Etkinlikler
onCharacteristicReadRequest
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
callback: function,
)
Bağlı bir merkezi cihaz, yerel GATT sunucusunda kayıtlı bir özelliğin değerini okumak istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermemek bağlantınızın kesilmesine neden olabilir. Bu etkinlik yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(request: Request, characteristicId: string) => void
-
istek
-
characteristicId
dize
-
onCharacteristicValueChanged
chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
callback: function,
)
Okuma isteği veya değer değişikliği bildirimi/göstergesi sonucunda uzak bir GATT özelliğinin değeri değiştiğinde tetiklenir. Bu etkinlik yalnızca, uygulama startCharacteristicNotifications
çağrısı yaparak bildirimleri etkinleştirdiyse gönderilir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(characteristic: Characteristic) => void
-
özelliği
-
onCharacteristicWriteRequest
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
callback: function,
)
Bağlı bir merkezi cihaz, yerel GATT sunucusunda kayıtlı bir özelliğin değerini yazmak istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermemek bağlantınızın kesilmesine neden olabilir. Bu etkinlik yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(request: Request, characteristicId: string) => void
-
istek
-
characteristicId
dize
-
onDescriptorReadRequest
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
callback: function,
)
Bağlı bir merkezi cihaz, yerel GATT sunucusunda kayıtlı bir açıklayıcının değerini okumak istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermemek bağlantınızın kesilmesine neden olabilir. Bu etkinlik yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(request: Request, descriptorId: string) => void
-
istek
-
descriptorId
dize
-
onDescriptorValueChanged
chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
callback: function,
)
Uzak bir GATT özellik tanımlayıcısının değeri değiştiğinde (genellikle bir okuma isteği sonucunda) tetiklenir. Bu etkinlik çoğunlukla kolaylık sağlamak için mevcuttur ve her zaman readDescriptorValue
numaralı telefona yapılan başarılı bir aramadan sonra gönderilir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(descriptor: Descriptor) => void
-
açıklayıcı
-
onDescriptorWriteRequest
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
callback: function,
)
Bağlı bir merkezi cihaz, yerel GATT sunucusunda kayıtlı bir tanımlayıcının değerini yazmak istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermemek bağlantınızın kesilmesine neden olabilir. Bu etkinlik yalnızca, uygulamanın hem bluetooth:low_energy hem de bluetooth:çevre birimi izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamaların kullanımına sunulmamış olabilir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(request: Request, descriptorId: string) => void
-
istek
-
descriptorId
dize
-
onServiceAdded
chrome.bluetoothLowEnergy.onServiceAdded.addListener(
callback: function,
)
Uzak bir cihazda yeni bir GATT hizmeti bulunduğunda tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(service: Service) => void
-
hizmet
-
onServiceChanged
chrome.bluetoothLowEnergy.onServiceChanged.addListener(
callback: function,
)
Uzak bir GATT hizmetinin durumu değiştiğinde tetiklenir. Hizmete eklenen veya hizmetten kaldırılan özellikler ve/veya tanımlayıcılar ve uzak cihazdaki "ServiceChanged" bildirimleri de buna dahildir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(service: Service) => void
-
hizmet
-
onServiceRemoved
chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
callback: function,
)
Uzak bir cihazda daha önce keşfedilen bir GATT hizmeti kaldırıldığında tetiklenir.