chrome.bluetoothLowEnergy

Açıklama

chrome.bluetoothLowEnergy API'si, Genel Özellik Profili (GATT) kullanarak Bluetooth Smart (Düşük Enerji) cihazlarla iletişim kurmak için kullanılır.

Kullanılabilirlik

Yalnızca ChromeOS

Manifest

Bu API'yi kullanmak için aşağıdaki anahtarların manifest dosyasında tanımlanması 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ı

    Reklam 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 bit biçiminde olabilir.

  • solicitUuids

    string[] isteğe bağlı

    Reklam verilerinin "UUID'leri iste" alanına dahil edilecek UUID'lerin listesi. Bu UUID'ler 16 bit, 32 bit veya 128 bit biçiminde olabilir.

  • Reklam türü.

AdvertisementType

Chrome 47 ve sonraki sürümler

Reklam türü. "Yayın" seçilirse gönderilen reklam türü ADV_NONCONN_IND olur ve cihaz rastgele bir MAC adresiyle 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 adresiyle yayın yapar.

Enum

"broadcast"

"çevre birimi"

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 ayırt etmek ve özellik tanımlayıcısı alan işlev çağrıları yapmak için örnek kimliğini kullanın. Bu örnek, uzak bir özelliği temsil ediyorsa mevcuttur.

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

    Önbelleğe alınmış mevcut özellik değeri. Bu değer, özelliğin değeri bir bildirim veya gösterge aracılığıyla okunduğunda ya da güncellendiğinde güncellenir.

CharacteristicProperty

Bir özelliğin olası niteliklerini temsil eden değerler. Karakteristik izinler bu özelliklerden çıkarılır. Her bir özelliğin anlamını görmek için lütfen Bluetooth 4.x spesifikasyonuna bakın.

Enum

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Özellikler

  • kalıcı

    boole

    Uygulamanın etkinlik sayfası kaldırıldığında cihaza bağlantının açık bırakılıp bırakılmadığını gösteren işaret (bkz. Uygulama Yaşam Döngüsünü Yönetme). Varsayılan değer: false.

Descriptor

Özellikler

  • characteristic

    Özellik isteğe bağlı

    Bu tanımlayıcının ait olduğu GATT özelliği.

  • instanceId

    string isteğe bağlı

    Bu tanımlayıcıya atanan tanımlayıcıyı döndürür. Aynı UUID'ye sahip bir çevre birimindeki tanımlayıcıları ayırt etmek ve tanımlayıcı kimliği alan işlev çağrıları yapmak için örnek kimliğini kullanın. Bu örnek, uzak bir özelliği temsil ediyorsa mevcuttur.

  • Chrome 52+

    Bu tanımlayıcının izinleri.

  • uuid

    dize

    Özellik tanımlayıcısının UUID'si (ör. 00002902-0000-1000-8000-00805f9b34fb).

  • value

    ArrayBuffer isteğe bağlı

    Şu anda önbelleğe alınmış tanımlayıcı değeri. Bu değer, tanımlayıcının değeri okunduğunda güncellenir.

DescriptorPermission

Chrome 52+

Bir tanımlayıcı için olası izinleri temsil eden değerler. Her bir iznin anlamını görmek için lütfen Bluetooth 4.x spesifikasyonuna bakın.

Enum

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52+

Özellikler

  • adres

    dize

    Cihazın "XX:XX:XX:XX:XX:XX" biçimindeki adresi.

  • deviceClass

    number isteğe bağlı

    Cihazın sınıfı, http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband tarafından tanımlanan bir bit alanıdır.

  • ad

    string isteğe bağlı

    Cihazın insan tarafından okunabilen adı.

ManufacturerData

Chrome 47 ve sonraki sürümler

Özellikler

  • veri

    number[]

  • id

    sayı

Notification

Chrome 52+

Ö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

  • kalıcı

    boole

    Uygulamanın etkinlik sayfası kaldırıldığında uygulamanın bildirim alıp almayacağını belirten işaret (Uygulama Yaşam Döngüsünü Yönetme bölümüne bakın). Varsayılan değer: false.

Request

Chrome 52+

Ö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+

Özellikler

  • isError

    boole

    Bu bir hata yanıtıysa bu değer doğru olmalıdır.

  • requestId

    sayı

    Bu yanıtın ait olduğu 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 mevcuttur.

  • instanceId

    string isteğe bağlı

    Bu hizmete atanan tanımlayıcıyı döndürür. Aynı UUID'ye sahip bir çevre birimindeki hizmetleri ayırt etmek ve hizmet tanımlayıcısı alan işlev çağrıları yapmak için örnek kimliğini kullanın. Bu örnek, uzak bir hizmeti temsil ediyorsa mevcuttur.

  • isPrimary

    boole

    Bu hizmet 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

    number[]

  • uuid

    dize

Yöntemler

connect()

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

Uygulama ile belirtilen adrese sahip cihaz arasında bağlantı kurar. Bir cihaz zaten bağlı olabilir ve GATT hizmetleri connect çağrılmadan kullanılabilir. Ancak bir cihazın GATT hizmetlerine erişmek isteyen bir uygulamanın, cihaza bağlantının sürdürüldüğünden emin olmak için bu işlevi çağırması gerekir. Cihaz bağlı değilse connect başarıyla çağrıldıktan sonra cihazın tüm GATT hizmetleri bulunur.

Parametreler

  • deviceAddress

    dize

    GATT bağlantısının açılması gereken uzak cihazın Bluetooth adresi.

  • mülkler

    ConnectProperties isteğe bağlı

    Bağlantı özellikleri (isteğe bağlı).

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

createCharacteristic()

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

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:peripheral izin setleri "true" olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • characteristic

    Özellik

    Oluşturulacak özellik.

  • serviceId

    dize

    Bu özelliğin oluşturulacağı hizmetin kimliği.

  • callback

    function isteğe bağlı

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

    (characteristicId: string) => void

    • characteristicId

      dize

İadeler

  • Promise<string>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

createDescriptor()

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

Yerel olarak barındırılan bir GATT tanımlayıcısı oluşturun. Bu tanımlayıcı, geçerli bir özellik altında barındırılmalıdır. Özellik kimliği geçerli değilse lastError ayarlanır. Bu işlev yalnızca uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izin setleri "true" olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • tanımlayıcı

    Tanımlayıcı

    Oluşturulacak tanımlayıcı.

  • characteristicId

    dize

    Bu tanımlayıcının oluşturulacağı özelliğin kimliği.

  • callback

    function isteğe bağlı

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

    (descriptorId: string) => void

    • descriptorId

      dize

İadeler

  • Promise<string>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

createService()

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

Yerel olarak barındırılan bir GATT hizmeti oluşturun. Bu hizmet, yerel bir GATT sunucusunda kullanılmak üzere kaydedilebilir. Bu işlev yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izin setleri "true" olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • hizmet

    Hizmet

    Oluşturulacak hizmet.

  • callback

    function isteğe bağlı

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

    (serviceId: string) => void

    • serviceId

      dize

İadeler

  • Promise<string>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

disconnect()

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

Uygulamanın, verilen adrese sahip cihazla bağlantısını kapatır. Açık bağlantıları olan başka uygulamalar olabileceğinden, bu işlemin fiziksel bağlantıyı her zaman yok etmeyeceğini unutmayın.

Parametreler

  • deviceAddress

    dize

    Uzak cihazın Bluetooth adresi.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getCharacteristic()

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

Varsa, belirtilen GATT hizmetine ait olan ve belirtilen örnek kimliğine sahip GATT özelliğini alın.

Parametreler

  • characteristicId

    dize

    İstenen GATT özelliğinin örnek kimliği.

  • callback

    function isteğe bağlı

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

    (result: Characteristic) => void

İadeler

  • Promise<Characteristic>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getCharacteristics()

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

Belirli bir hizmete ait tüm keşfedilen GATT özelliklerinin listesini alın.

Parametreler

  • serviceId

    dize

    Özellikleri döndürülmesi gereken GATT hizmetinin örnek kimliği.

  • callback

    function isteğe bağlı

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

    (result: Characteristic[]) => void

İadeler

  • Promise<Characteristic[]>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getDescriptor()

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

Belirtilen örnek kimliğine sahip GATT özellik tanımlayıcısını alır.

Parametreler

  • descriptorId

    dize

    İstenen GATT özellik tanımlayıcısının örnek kimliği.

  • callback

    function isteğe bağlı

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

    (result: Descriptor) => void

İadeler

  • Promise<Descriptor>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getDescriptors()

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

Belirli bir özelliğe ait GATT özellik tanımlayıcılarının listesini alın.

Parametreler

  • characteristicId

    dize

    Tanımlayıcıları döndürülmesi gereken GATT özelliğinin örnek kimliği.

  • callback

    function isteğe bağlı

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

    (result: Descriptor[]) => void

İadeler

  • Promise<Descriptor[]>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getIncludedServices()

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

Belirli bir hizmete dahil edilen GATT hizmetlerinin listesini alın.

Parametreler

  • serviceId

    dize

    Dahil edilen hizmetleri döndürülecek GATT hizmetinin örnek kimliği.

  • callback

    function isteğe bağlı

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

    (result: Service[]) => void

İadeler

  • Promise<Service[]>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getService()

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

Belirtilen örnek kimliğine sahip GATT hizmetini alın.

Parametreler

  • serviceId

    dize

    İstenen GATT hizmetinin örnek kimliği.

  • callback

    function isteğe bağlı

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

    (result: Service) => void

İadeler

  • Promise<Service>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getServices()

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

Belirtilen cihaz adresine sahip uzak cihazda bulunan tüm GATT hizmetlerini alın.

Not: Cihazda hizmet keşfi henüz tamamlanmadıysa bu API, hizmetlerin bir alt kümesini (muhtemelen boş) döndürür. Bu sorunu çözmek için zamana dayalı bir gecikme ekleyebilir ve/veya beklenen hizmet sayısı döndürülene kadar tekrar tekrar çağrı yapabilirsiniz.

Parametreler

  • deviceAddress

    dize

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

  • callback

    function isteğe bağlı

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

    (result: Service[]) => void

İadeler

  • Promise<Service[]>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

notifyCharacteristicValueChanged()

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

Uzak bir cihaza bir özelliğin yeni değerini bildirme. Bildirim nesnesindeki shouldIndicate işareti doğruysa 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 "notify" veya "indicate" özelliğini doğru şekilde ayarlaması gerektiğini unutmayın. Bu işlev yalnızca uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izin setleri "true" olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • characteristicId

    dize

    Bildirimin gönderileceği özellik.

  • bildirim

    Bildirim

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

readCharacteristicValue()

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

Uzak bir çevre biriminden belirtilen özelliğin değerini alma

Parametreler

  • characteristicId

    dize

    Değeri uzak cihazdan okunması gereken GATT özelliğinin örnek kimliği.

  • callback

    function isteğe bağlı

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

    (result: Characteristic) => void

İadeler

  • Promise<Characteristic>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

readDescriptorValue()

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

Uzak bir çevre biriminden belirtilen özellik tanımlayıcısının değerini alır.

Parametreler

  • descriptorId

    dize

    Değeri uzak cihazdan okunması gereken GATT özellik tanımlayıcısının örnek kimliği.

  • callback

    function isteğe bağlı

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

    (result: Descriptor) => void

İadeler

  • Promise<Descriptor>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

registerAdvertisement()

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

Reklam oluşturun ve reklamı reklam yayınlama için kaydedin. Bu işlevi çağırmak için uygulamanın bluetooth:low_energy ve bluetooth:peripheral izin setlerinin "true" olarak ayarlanması gerekir. Ayrıca bu API, yalnızca Kiosk Modu'nda otomatik olarak başlatılan uygulamalarda veya "--enable-ble-advertising-in-apps" komut satırı anahtarı ayarlanarak kullanılabilir. https://developer.chrome.com/apps/manifest/bluetooth adresine bakın. Not: Bazı donanımlarda merkezi ve çevre birimi modları aynı anda desteklenir ancak bunu desteklemeyen donanımlarda bu çağrının yapılması cihazı çevre birimi moduna geçirir. Hem merkezi hem de çevre birimi modunu desteklemeyen donanımlarda, cihazı her iki modda da kullanmaya çalışmak, tanımlanmamış davranışlara yol açar veya diğer merkezi rol uygulamalarının (Bluetooth Düşük Enerji cihazlarının keşfi dahil) doğru şekilde davranmasını engeller.

Parametreler

  • reklam

    Reklam

    Reklamı yapılacak reklam.

  • callback

    function isteğe bağlı

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

    (advertisementId: number) => void

    • advertisementId

      sayı

İadeler

  • Promise<number>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

registerService()

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

Belirtilen hizmeti yerel GATT sunucusuna kaydeder. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izin setleri "true" olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • serviceId

    dize

    Oluşturulan hizmetin benzersiz kimliği.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeService()

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

Belirtilen hizmeti kaldırır ve kayıtlıysa kaydını siler. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izin setleri "true" olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • serviceId

    dize

    Kayıtlı mevcut bir hizmetin benzersiz kimliği.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

resetAdvertising()

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

Mevcut cihazda reklamları sıfırlar. Mevcut tüm reklamların kaydı silinir ve durdurulur.

Parametreler

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

sendRequestResponse()

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

Bir özellik veya tanımlayı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:peripheral izin setleri "true" olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • gönderin

    Yanıt

    İsteğe verilen yanıt.

setAdvertisingInterval()

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

Birbirini takip eden iki reklam arasındaki aralığı ayarlar. Not: Bu, en iyi sonuçtur. Gerçek aralık, istenen aralıklardan önemli ölçüde farklı olabilir. Bazı donanımlarda minimum aralık 100 ms'dir. Minimum ve maksimum değerler, Bluetooth 4.2 spesifikasyonunun izin verdiği aralığı aşamaz.

Parametreler

  • minInterval

    sayı

    Reklamlar arasındaki minimum aralık (milisaniye cinsinden). Bu değer 20 ms'den düşük olamaz (spesifikasyona göre).

  • maxInterval

    sayı

    Reklamlar arasındaki maksimum aralık (milisaniye cinsinden). Bu değer 10.240 ms'den fazla olamaz (spesifikasyona göre).

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

startCharacteristicNotifications()

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

Belirtilen özellikten değer bildirimlerini/göstergelerini etkinleştirir. Etkinleştirildikten sonra 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ı).

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

stopCharacteristicNotifications()

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

Belirtilen özellikten değer bildirimlerini/göstergelerini devre dışı bırakın. Başarılı bir çağrıdan sonra uygulama, bu özellikten bildirim/gösterge almayı durdurur.

Parametreler

  • characteristicId

    dize

    Bu uygulamanın bildirim oturumunun durdurulması gereken GATT özelliğinin örnek kimliği.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

unregisterAdvertisement()

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

Bir reklamın kaydını iptal eder ve bildirmesini durdurur. Reklamın kaydı silinemezse reklamı durdurmanın tek yolu cihazı yeniden başlatmak olabilir.

Parametreler

  • advertisementId

    sayı

    Kaydı iptal edilecek reklamın kimliği.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

unregisterService()

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

Belirtilen hizmetin yerel GATT sunucusundaki kaydını siler. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izin setleri "true" olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • serviceId

    dize

    Kayıtlı mevcut bir hizmetin benzersiz kimliği.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

writeCharacteristicValue()

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

Uzak bir çevre biriminden belirtilen özelliğin değerini yazma.

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.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

writeDescriptorValue()

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

Uzak çevre biriminden belirtilen bir özellik tanımlayıcısının değerini yazma

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.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onCharacteristicReadRequest

Chrome 52+ 
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 verilmemesi bağlantının kesilmesine neden olabilir. Bu etkinlik yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izinleri doğru olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • callback

    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,
)

Uzak bir GATT özelliğinin değeri, okuma isteği veya değer değişikliği bildirimi/göstergesi sonucunda değiştiğinde tetiklenir. Bu etkinlik yalnızca uygulama, startCharacteristicNotifications yöntemini çağırarak bildirimleri etkinleştirdiyse gönderilir.

Parametreler

  • callback

    işlev

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

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

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

Bağlı bir merkezi cihaz, yerel GATT sunucusunda kayıtlı bir özelliğin değerini yazmayı istediğinde tetiklenir. Bu isteğe uzun süre yanıt verilmemesi bağlantının kesilmesine neden olabilir. Bu etkinlik yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izinleri doğru olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • callback

    işlev

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

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

    • istek

      İstek

    • characteristicId

      dize

onDescriptorReadRequest

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

Bağlı bir merkezi cihaz, yerel GATT sunucusunda kayıtlı bir tanımlayıcının değerini okumak istediğinde tetiklenir. Bu isteğe uzun süre yanıt verilmemesi bağlantının kesilmesine neden olabilir. Bu etkinlik yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izinleri doğru olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • callback

    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 GATT özellik tanımlayıcısının değeri değiştiğinde (genellikle okuma isteği sonucunda) tetiklenir. Bu etkinlik çoğunlukla kolaylık sağlamak için kullanılır ve her zaman readDescriptorValue için başarılı bir çağrıdan sonra gönderilir.

Parametreler

  • callback

    işlev

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

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

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

Bağlı bir merkezi cihaz, yerel GATT sunucusunda kayıtlı bir tanımlayıcının değerini yazmayı istediğinde tetiklenir. Bu isteğe uzun süre yanıt verilmemesi bağlantının kesilmesine neden olabilir. Bu etkinlik yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izinleri doğru olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • callback

    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 keşfedildiğinde tetiklenir.

Parametreler

  • callback

    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. Bu, hizmete eklenen veya hizmetten kaldırılan tüm özellikleri ve/veya tanımlayıcıları ve uzak cihazdan gelen "ServiceChanged" bildirimlerini içerir.

Parametreler

  • callback

    işlev

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

    (service: Service) => void

onServiceRemoved

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

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

Parametreler

  • callback

    işlev

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

    (service: Service) => void