chrome.bluetoothLowEnergy

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

Bu API'yi kullanmak için aşağıdaki anahtarların manifest'te beyan edilmesi gerekir.

"bluetooth"

Türler

Advertisement

Chrome 47 ve sonraki sürümler

Ö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

Chrome 47 ve sonraki sürümler

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.

  • 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.

  • Chrome 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

Chrome 52 ve sonraki sürümler

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

Chrome 52 ve sonraki sürümler

Ö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

Chrome 47 ve sonraki sürümler

Özellikler

  • veri

    numara[]

  • id

    sayı

Notification

Chrome 52 ve sonraki sürümler

Ö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

Chrome 52 ve sonraki sürümler

Özellikler

  • cihaz

    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

Chrome 52 ve sonraki sürümler

Ö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

Chrome 47 ve sonraki sürümler

Özellikler

  • veri

    numara[]

  • uuid

    dize

Yöntemler

connect()

Söz 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

createCharacteristic()

Promise Chrome 52 ve üstü sürümler 
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

    Özellik

    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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

createDescriptor()

Promise Chrome 52 ve üstü sürümler 
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ı

    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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

createService()

Promise Chrome 52 ve üstü sürümler 
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

    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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

disconnect()

Söz 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getCharacteristic()

Söz 
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

İlerlemeler

  • Promise<Characteristic>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getCharacteristics()

Söz 
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

İlerlemeler

  • Promise<Characteristic[]>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getDescriptor()

Söz 
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

İlerlemeler

  • Promise<Descriptor>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getDescriptors()

Söz 
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

İlerlemeler

  • Promise<Descriptor[]>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getIncludedServices()

Söz 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

İlgili hizmete dahil olan GATT hizmetlerinin listesini alma.

Parametreler

  • serviceId

    dize

    Dahil edilen hizmetlerin 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: Service[])=>void

İlerlemeler

  • Taahhüt<Hizmet[]>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getService()

Söz 
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

İlerlemeler

  • Taahhüt<Hizmet>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getServices()

Söz 
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

  • deviceAddress

    dize

    GATT hizmetlerinin döndürülmesi gereken uzak cihazın Bluetooth adresi.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (result: Service[])=>void

İlerlemeler

  • Taahhüt<Hizmet[]>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

notifyCharacteristicValueChanged()

Promise Chrome 52 ve üstü sürümler 
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

    Bildirim

  • 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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

readCharacteristicValue()

Söz 
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

İlerlemeler

  • Promise<Characteristic>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

readDescriptorValue()

Söz 
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

İlerlemeler

  • Promise<Descriptor>

    Chrome 91 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

registerAdvertisement()

Söz Chrome 47 ve sonraki sürümleri 
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

    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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

registerService()

Promise Chrome 52 ve üstü sürümler 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

removeService()

Promise Chrome 52 ve üstü sürümler 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

resetAdvertising()

Söz Chrome 61 ve üstü 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

sendRequestResponse()

Chrome 52 ve sonraki sürümler 
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

    Yanıt

    İsteğe verilen yanıt.

setAdvertisingInterval()

Söz Chrome 55 ve sonraki sürümler 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

startCharacteristicNotifications()

Söz 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

stopCharacteristicNotifications()

Söz 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

unregisterAdvertisement()

Söz Chrome 47 ve sonraki sürümleri 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

unregisterService()

Promise Chrome 52 ve üstü sürümler 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

writeCharacteristicValue()

Söz 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

writeDescriptorValue()

Söz 
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ümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

Etkinlikler

onCharacteristicReadRequest

Chrome 52 ve sonraki sürümler 
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

      İstek

    • 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

onCharacteristicWriteRequest

Chrome 52 ve sonraki sürümler 
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

      İstek

    • characteristicId

      dize

onDescriptorReadRequest

Chrome 52 ve sonraki sürümler 
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

      İstek

    • 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

onDescriptorWriteRequest

Chrome 52 ve sonraki sürümler 
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

      İstek

    • 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

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

onServiceRemoved

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

Uzak bir cihazda daha önce keşfedilen bir GATT hizmeti kaldırıldığında tetiklenir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (service: Service)=>void