chrome.bluetoothLowEnergy

Açıklama

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

Manifest

Bu API'yi kullanmak için aşağıdaki anahtarlar manifest dosyasında beyan edilmelidir.

"bluetooth"

Türler

Advertisement

Chrome 47 ve sonraki sürümler

Özellikler

• manufacturerData

  ManufacturerData[] isteğe bağlı

  Reklam verilerinin "Üreticiye Özgü Veriler" alanlarına eklenecek üreticiye özgü 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 iste" alanına eklenecek UUID'lerin listesi. Bu UUID'ler 16 bit, 32 bit veya 128 bit biçiminde olabilir.

• tür

  AdvertisementType

  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. "Periferik" 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"

"peripheral"

Characteristic

Özellikler

• instanceId

  dize isteğe bağlı

  Bu özelliğe atanan tanımlayıcıyı döndürür. Aynı UUID'ye sahip bir çevre biriminde bulunan özellikleri ayırt etmek ve özellik 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 mevcuttur.

• mülkler

  CharacteristicProperty[]

  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ı

  Şu anda önbelleğe alınan ö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ı özelliklerini temsil eden değerler. Özellik izinleri bu özelliklerden türetilir. 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ı

  boolean

  Uygulamanın etkinlik sayfası yüklenmediğinde cihazla bağlantının açık bırakılıp bırakılmayacağını belirten işaret (Uygulama Yaşam Döngüsünü Yönetme bölümüne bakın). Varsayılan değer false.'tür.

Descriptor

Özellikler

• özellik

  Özellik isteğe bağlı

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

• instanceId

  dize isteğe bağlı

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

• izinler

  DescriptorPermission[]

  Chrome 52 ve üzeri sürümler

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

• uuid

  dize

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

• value

  ArrayBuffer isteğe bağlı

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

DescriptorPermission

Chrome 52 ve sonraki sürümler

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 ve üzeri sürümler

Özellikler

• adres

  dize

  Cihazın, "XX:XX:XX:XX:XX:XX" biçiminde 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ı.

• ad

  dize isteğe bağlı

  Cihazın kullanıcılar tarafından okunabilir adı.

ManufacturerData

Chrome 47 ve sonraki sürümler

Özellikler

• veri

  number[]

• id

  sayı

Notification

Chrome 52 ve sonraki sürümler

Özellikler

• shouldIndicate

  boole isteğe bağlı

  Bildirim yerine bir gösterge göndermek için isteğe bağlı işaret.

• value

  ArrayBuffer

  Özelliğin yeni değeri.

NotificationProperties

Özellikler

• kalıcı

  boolean

  Uygulamanın etkinlik sayfası yüklenmediğinde 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 ve üzeri sürümler

Özellikler

• cihaz

  Cihaz

  Bu isteği gönderen cihaz.

• requestId

  sayı

  Bu istek için benzersiz kimlik. 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 üzeri sürümler

Özellikler

• isError

  boolean

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

• requestId

  sayı

  Yanıtın verildiğ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

  dize isteğe bağlı

  GATT hizmetinin ait olduğu uzak çevre biriminin cihaz adresi. Bu örnek uzak bir hizmeti temsil ediyorsa mevcuttur.

• instanceId

  dize isteğe bağlı

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

• isPrimary

  boolean

  Bu hizmetin türünü birincil veya ikincil olarak 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()

Promise

chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

Uygulama ile belirtilen adrese sahip cihaz arasında bağlantı oluşturur. Bir cihaz zaten bağlı olabilir ve connect çağrılmadan GATT hizmetleri kullanılabilir durumda olabilir. Ancak bir cihazın GATT hizmetlerine erişmek isteyen bir uygulama, cihazla bağlantının korunduğundan emin olmak için bu işlevi çağırmalıdır. Cihaz bağlı değilse connect çağrısı başarılı bir şekilde yapı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ı).

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

  Sözler 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 ve sonraki 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 uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevresel birim izni tüm uygulamalarda kullanılamayabilir.

Parametreler

• özellik

  Özellik

  Oluşturulacak özellik.

• serviceId

  dize

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

• geri çağırma

  işlev 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

  Sözler 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 ve sonraki 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 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 uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevresel birim 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.

• geri çağırma

  işlev 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

  Sözler 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 ve sonraki 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ılacak şekilde kaydedilebilir. Bu işlev yalnızca uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevresel birim izni tüm uygulamalarda kullanılamayabilir.

Parametreler

• hizmet

  Hizmet

  Oluşturulacak hizmet.

• geri çağırma

  işlev 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

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

disconnect()

Promise

chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

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

Parametreler

• deviceAddress

  dize

  Uzak cihazın Bluetooth adresi.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

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

getCharacteristic()

Promise

chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

Varsa belirli bir GATT hizmetine ait belirli bir örnek kimliğiyle GATT özelliğini alın.

Parametreler

• characteristicId

  dize

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

• geri çağırma

  işlev isteğe bağlı

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

  (result: Characteristic) => void

  • sonuç

    Özellik

İadeler

• Promise<Characteristic>

  Chrome 91 ve sonraki sürümler

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

getCharacteristics()

Promise

chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

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

Parametreler

• serviceId

  dize

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

• geri çağırma

  işlev isteğe bağlı

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

  (result: Characteristic[]) => void

  • sonuç

    Characteristic[]

İadeler

• Promise<Characteristic[]>

  Chrome 91 ve sonraki sürümler

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

getDescriptor()

Promise

chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

Belirtilen örnek kimliğiyle GATT özellik tanımlayıcısını alın.

Parametreler

• descriptorId

  dize

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

• geri çağırma

  işlev isteğe bağlı

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

  (result: Descriptor) => void

  • sonuç

    Tanımlayıcı

İadeler

• Promise<Descriptor>

  Chrome 91 ve sonraki sürümler

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

getDescriptors()

Promise

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

  işlev isteğe bağlı

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

  (result: Descriptor[]) => void

  • sonuç

    Tanımlayıcı[]

İadeler

• Promise<Descriptor[]>

  Chrome 91 ve sonraki sürümler

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

getIncludedServices()

Promise

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

Belirtilen hizmet tarafından dahil edilen GATT hizmetlerinin listesini alın.

Parametreler

• serviceId

  dize

  Dahil edilen hizmetlerin döndürülmesi gereken GATT hizmetinin örnek kimliği.

• geri çağırma

  işlev isteğe bağlı

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

  (result: Service[]) => void

  • sonuç

    Hizmet[]

İadeler

• Promise<Service[]>

  Chrome 91 ve sonraki sürümler

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

getService()

Promise

chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

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

Parametreler

• serviceId

  dize

  İstenen GATT hizmetinin örnek kimliği.

• geri çağırma

  işlev isteğe bağlı

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

  (result: Service) => void

  • sonuç

    Hizmet

İadeler

• Promise<Service>

  Chrome 91 ve sonraki sürümler

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

getServices()

Promise

chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

Belirtilen cihaz adresiyle 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 (boş olabilir) döndürür. Bu sorunun geçici çözümü, zamana dayalı bir gecikme eklemek ve/veya beklenen hizmet sayısı döndürülene kadar tekrar tekrar çağrı yapmaktır.

Parametreler

• deviceAddress

  dize

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

• geri çağırma

  işlev isteğe bağlı

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

  (result: Service[]) => void

  • sonuç

    Hizmet[]

İadeler

• Promise<Service[]>

  Chrome 91 ve sonraki sürümler

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

chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

Bir uzak cihazı, bir özellik için yeni bir değerden haberdar edin. Bildirim nesnesinde 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şturulma sırasında "notify" veya "indicate" özelliğini doğru şekilde ayarlamasının gerektiğini unutmayın. Bu işlev yalnızca uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevresel birim izni tüm uygulamalarda kullanılamayabilir.

Parametreler

• characteristicId

  dize

  Bildirimin gönderileceği özellik.

• bildirim

  Bildirim

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

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

readCharacteristicValue()

Promise

chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

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

Parametreler

• characteristicId

  dize

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

• geri çağırma

  işlev isteğe bağlı

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

  (result: Characteristic) => void

  • sonuç

    Özellik

İadeler

• Promise<Characteristic>

  Chrome 91 ve sonraki sürümler

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

readDescriptorValue()

Promise

chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

Belirtilen bir özellik tanımlayıcısının değerini uzak bir çevre birimden alma.

Parametreler

• descriptorId

  dize

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

• geri çağırma

  işlev isteğe bağlı

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

  (result: Descriptor) => void

  • sonuç

    Tanımlayıcı

İadeler

• Promise<Descriptor>

  Chrome 91 ve sonraki sürümler

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

chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Reklam oluşturun ve reklam için kaydedin. Bu işlevin çağrılabilmesi için uygulamada bluetooth:low_energy ve bluetooth:peripheral izinlerinin true olarak ayarlanmış olması gerekir. Ayrıca bu API, yalnızca Kiosk modunda 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ıyı yapmak 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ış bir davranışa neden olur veya diğer merkezi rol uygulamalarının (Bluetooth Düşük Enerji cihazlarının bulunması dahil) doğru şekilde çalışmasını engeller.

Parametreler

• reklam

  Reklam

  Reklamı yapılacak reklam.

• geri çağırma

  işlev 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

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

chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

Belirtilen hizmeti yerel GATT sunucusuna kaydedin. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev yalnızca uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevresel birim izni tüm uygulamalarda kullanılamayabilir.

Parametreler

• serviceId

  dize

  Oluşturulan hizmetin benzersiz kimliği.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

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

chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Kayıtlıysa kaydını iptal ederek belirtilen hizmeti kaldırın. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev yalnızca uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevresel birim izni tüm uygulamalarda kullanılamayabilir.

Parametreler

• serviceId

  dize

  Mevcut kayıtlı bir hizmetin benzersiz kimliği.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

  Sözler 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 ve üzeri sürümler

chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Mevcut cihazdaki reklamcılığı sıfırlar. Bu işlem, mevcut tüm reklamların kaydını iptal eder ve reklamları durdurur.

Parametreler

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

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

sendRequestResponse()

Chrome 52 ve üzeri sürümler

chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

Bir özellik veya tanımlayıcı okuma/yazma isteği için yanıt gönderir. Bu işlev yalnızca uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevresel birim izni tüm uygulamalarda kullanılamayabilir.

Parametreler

• gönderin

  Yanıt

  İsteğe verilen yanıt.

setAdvertisingInterval()

Promise Chrome 55 ve sonraki sürümler

chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

Art arda gelen iki reklam arasındaki aralığı ayarlar. Not: Bu işlem, en iyi şekilde yapılır. 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 (özelliğe göre).

• maxInterval

  sayı

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

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

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

startCharacteristicNotifications()

Promise

chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

Belirtilen özellikten değer bildirimlerini/belirtmelerini etkinleştirin. 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ı).

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

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

stopCharacteristicNotifications()

Promise

chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

Belirtilen özellikteki değer bildirimlerini/belirtmelerini devre dışı bırakır. Başarılı bir aramadan sonra uygulama, bu özellikten bildirim/işaret almayı durdurur.

Parametreler

• characteristicId

  dize

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

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

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

chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

Reklamın kaydını siler ve reklamını durdurur. Reklamın kaydı silinemezse reklamcılığı durdurmanın tek yolu cihazı yeniden başlatmaktır.

Parametreler

• advertisementId

  sayı

  Kaydı iptal edilecek reklamın kimliği.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

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

chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

Belirtilen hizmetin yerel GATT sunucusundaki kaydını iptal edin. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev yalnızca uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevresel birim izni tüm uygulamalarda kullanılamayabilir.

Parametreler

• serviceId

  dize

  Mevcut kayıtlı bir hizmetin benzersiz kimliği.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

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

writeCharacteristicValue()

Promise

chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

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

Parametreler

• characteristicId

  dize

  Değeri yazılacak GATT özelliğinin örnek kimliği.

• value

  ArrayBuffer

  Yazma isteği kapsamında uzak özelliğe gönderilmesi gereken değer.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

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

writeDescriptorValue()

Promise

chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

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

Parametreler

• descriptorId

  dize

  Değeri yazılacak GATT özellik tanımlayıcının örnek kimliği.

• value

  ArrayBuffer

  Yazma isteği kapsamında uzak tanımlayıcıya gönderilmesi gereken değer.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

  Sözler 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 ve üzeri sürümler

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

Bağlı bir merkezi cihaz, yerel GATT sunucusuna kayıtlı bir özelliğin değerini okumayı istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermemeniz bağlantının kesilmesine neden olabilir. Bu etkinlik yalnızca uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevresel birim izni tüm uygulamalarda kullanılamayabilir.

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

Bir uzak GATT özelliğinin değeri, okuma isteği veya değer değişikliği bildirimi/işareti sonucunda değiştiğinde tetiklenir. Bu etkinlik yalnızca uygulama startCharacteristicNotifications çağrısını yaparak bildirimleri etkinleştirdiyse gönderilir.

Parametreler

• geri çağırma

  işlev

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

  (characteristic: Characteristic) => void

  • özellik

    Özellik

onCharacteristicWriteRequest

Chrome 52 ve üzeri sürümler

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

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

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 üzeri sürümler

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

Bağlı bir merkezi cihaz, yerel GATT sunucusuna kayıtlı bir tanımlayıcı değerini okumayı istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermezseniz bağlantınız kesilebilir. Bu etkinlik yalnızca uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevresel birim izni tüm uygulamalarda kullanılamayabilir.

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

Genellikle bir okuma isteği sonucunda uzak GATT özellik tanımlayıcısının değeri değiştiğinde tetiklenir. Bu etkinlik çoğunlukla kolaylık sağlamak için mevcuttur ve her zaman readDescriptorValue adresine yapılan başarılı bir çağrıdan sonra gönderilir.

Parametreler

• geri çağırma

  işlev

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

  (descriptor: Descriptor) => void

  • tanımlayıcı

    Tanımlayıcı

onDescriptorWriteRequest

Chrome 52 ve sonraki sürümler

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

Bağlı bir merkezi cihaz, yerel GATT sunucusuna kayıtlı bir tanımlayıcı değerini yazmayı istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermezseniz bağlantınız kesilebilir. Bu etkinlik yalnızca uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevresel cihaz izni tüm uygulamalarda kullanılamayabilir.

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

Parametreler

• geri çağırma

  işlev

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

  (service: Service) => void

  • hizmet

    Hizmet

onServiceChanged

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

Uzak bir GATT hizmetinin durumu değiştiğinde tetiklenir. Buna, hizmete eklenen veya hizmetten kaldırılan tüm özellikler ve/veya tanımlayıcıların yanı sıra uzak cihazdan gelen "ServiceChanged" bildirimleri dahildir.

Parametreler

• geri çağırma

  işlev

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

  (service: Service) => void

  • hizmet

    Hizmet

onServiceRemoved

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

Daha önce uzak bir cihazda 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

  • hizmet

    Hizmet