chrome.bluetoothLowEnergy

Açıklama

chrome.bluetoothLowEnergy API, Generic Attribute Profile (GATT) kullanılarak 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 veya daha yeni bir sürüm

Ö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'leri iste" alanına eklenecek UUID'lerin listesi. Bu UUID'ler 16 bit, 32 bit veya 128 bit biçiminde olabilir.

  • Reklam türü.

AdvertisementType

Chrome 47 veya daha yeni bir sürüm

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. "peripheral" 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 birimindeki özellikleri 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 mevcut.

  • 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ıdır.

    Şu anda önbelleğe alınmış ö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. Karakteristik izinler bu özelliklerden çıkarılır. Her bir özelliğin anlamını öğrenmek 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ı kaldırıldığında cihaza bağlantının açık bırakılıp bırakılmadığını belirten işaret (bkz. Uygulama Yaşam Döngüsünü Yönetme). Varsayılan değer false.'dır.

Descriptor

Özellikler

  • özellik

    Özellik isteğe bağlıdır.

    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 birimindeki tanımlayıcıları ayırt etmek ve tanımlayı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.

  • Chrome 52 veya daha yeni bir sürüm

    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ıdır.

    Ş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 veya daha yeni bir sürüm

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

Enum

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 veya daha yeni bir sürüm

Özellikler

  • adres

    dize

    Cihazın adresi, "XX:XX:XX:XX:XX:XX" biçiminde.

  • 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 veya daha yeni bir sürüm

Özellikler

  • aktarma

    number[]

  • id

    sayı

Notification

Chrome 52 veya daha yeni bir sürüm

Özellikler

  • shouldIndicate

    boolean isteğe bağlı

    Bildirim yerine belirti 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ı kaldırıldığında uygulamanın bildirim alıp almayacağını belirten işaret (bkz. Uygulama Yaşam Döngüsünü Yönetme). Varsayılan değer false'dır.

Request

Chrome 52 veya daha yeni bir sürüm

Ö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ıdır.

    Yazılacak değer (bu bir yazma isteğiyse).

Response

Chrome 52 veya daha yeni bir sürüm

Özellikler

  • isError

    boolean

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

  • requestId

    sayı

    Bu yanıtın karşılık verdiği isteğin kimliği.

  • value

    ArrayBuffer isteğe bağlıdır.

    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 bir uzak hizmeti temsil ediyorsa mevcut.

  • instanceId

    dize 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 bir uzak 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 veya daha yeni bir sürüm

Özellikler

  • aktarma

    number[]

  • uuid

    dize

Yöntemler

connect()

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

Uygulama ile belirli adresteki cihaz arasında bağlantı kurar. Bir cihaz, connect işlevi çağrılmadan önceden bağlanmış ve 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 connect başarılı bir şekilde çağrıldıktan sonra cihazın tüm GATT hizmetleri keşfedilir.

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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

createCharacteristic()

Promise Chrome 52 ve sonraki sürümler 
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 kapsamında barındırılmalıdır. Hizmet kimliği geçerli değilse lastError ayarlanır. Bu işlev 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

  • özellik

    Özellik (Characteristic)

    Oluşturulacak özellik.

  • serviceId

    dize

    Bu özelliği oluşturmak için kullanılacak hizmetin kimliği.

  • callback

    işlev isteğe bağlı

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

    (characteristicId: string) => void

    • characteristicId

      dize

İadeler

  • Promise<string>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

createDescriptor()

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

  • 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

    işlev isteğe bağlı

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

    (descriptorId: string) => void

    • descriptorId

      dize

İadeler

  • Promise<string>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

createService()

Promise Chrome 52 ve sonraki sürümler 
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ılabilir olacak şekilde kaydedilebilir. Bu işlev 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

  • hizmet

    Hizmet

    Oluşturulacak hizmet.

  • callback

    işlev isteğe bağlı

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

    (serviceId: string) => void

    • serviceId

      dize

İadeler

  • Promise<string>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

disconnect()

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

Uygulamanın, belirtilen 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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getCharacteristic()

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

Özellik varsa, verilen GATT hizmetine ait olan ve verilen örnek kimliğine sahip GATT özelliğini alır.

Parametreler

  • characteristicId

    dize

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

  • callback

    işlev isteğe bağlı

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

    (result: Characteristic) => void

İadeler

  • Promise<Characteristic>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getCharacteristics()

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

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

Parametreler

  • serviceId

    dize

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

  • callback

    işlev isteğe bağlı

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

    (result: Characteristic[]) => void

İadeler

  • Promise<Characteristic[]>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getDescriptor()

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

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

Parametreler

  • descriptorId

    dize

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

  • callback

    işlev isteğe bağlı

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

    (result: Descriptor) => void

İadeler

  • Promise<Descriptor>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getDescriptors()

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

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

Parametreler

  • characteristicId

    dize

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

  • callback

    işlev isteğe bağlı

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

    (result: Descriptor[]) => void

İadeler

  • Promise<Descriptor[]>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getIncludedServices()

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

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

Parametreler

  • serviceId

    dize

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

  • callback

    işlev isteğe bağlı

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

    (result: Service[]) => void

İadeler

  • Promise<Service[]>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getService()

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

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

Parametreler

  • serviceId

    dize

    İstenen GATT hizmetinin örnek kimliği.

  • callback

    işlev isteğe bağlı

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

    (result: Service) => void

İadeler

  • Promise<Service>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getServices()

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

Belirli bir cihaz adresiyle uzak cihazda keşfedilen 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 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

    işlev isteğe bağlı

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

    (result: Service[]) => void

İadeler

  • Promise<Service[]>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

notifyCharacteristicValueChanged()

Promise Chrome 52 ve sonraki sürümler 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

Uzak cihazı bir özelliğin yeni değeri hakkında bilgilendirin. 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 oluşturma sırasında özelliğin "notify" (bildir) veya "indicate" (göster) özelliğinin doğru şekilde ayarlanması gerektiğini unutmayın. Bu işlev 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

  • characteristicId

    dize

    Bildirimin gönderileceği özellik.

  • bildirim

    Bildirim

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

readCharacteristicValue()

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

Uzak bir çevre biriminden belirtilen bir özelliğin değerini alın.

Parametreler

  • characteristicId

    dize

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

  • callback

    işlev isteğe bağlı

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

    (result: Characteristic) => void

İadeler

  • Promise<Characteristic>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

readDescriptorValue()

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

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

Parametreler

  • descriptorId

    dize

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

  • callback

    işlev isteğe bağlı

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

    (result: Descriptor) => void

İadeler

  • Promise<Descriptor>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

registerAdvertisement()

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

Bir reklam oluşturun ve reklam için kaydedin. Bu işlevi çağırmak için uygulamada bluetooth:low_energy ve bluetooth:peripheral izinleri true olarak ayarlanmalıdır. 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 adresini inceleyin. Not: Bazı donanımlarda merkezi ve çevre birimi modları aynı anda desteklenir ancak bu özelliği 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 doğru şekilde çalışmasını engeller (Bluetooth Düşük Enerji cihazlarının keşfi dahil).

Parametreler

  • reklam

    Reklam

    Reklamı yapılacak reklam.

  • callback

    işlev isteğe bağlı

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

    (advertisementId: number) => void

    • advertisementId

      sayı

İadeler

  • Promise<number>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

registerService()

Promise Chrome 52 ve sonraki sürümler 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

Belirtilen hizmeti yerel GATT sunucusuna kaydedin. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev 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

  • serviceId

    dize

    Oluşturulan bir hizmetin benzersiz kimliği.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeService()

Promise Chrome 52 ve sonraki sürümler 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

Belirtilen hizmeti kaldırır ve kayıtlıysa hizmetin 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 izinleri doğru 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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

resetAdvertising()

Promise Chrome 61 ve sonraki sürümler 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

Mevcut cihazdaki reklamları sıfırlar. Kaydı silinir ve mevcut tüm reklamlar durdurulur.

Parametreler

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

sendRequestResponse()

Chrome 52 veya daha yeni bir sürüm 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
): void

Okuma/yazma isteği yapılan bir özellik veya tanımlayıcı için yanıt gönderir. Bu işlev 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

  • 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,
): Promise<void>

Birbirini izleyen iki reklam arasındaki aralığı ayarlar. Not: Bu, en iyi girişimdir. 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, spesifikasyona göre 20 ms'den düşük olamaz.

  • maxInterval

    sayı

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

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

startCharacteristicNotifications()

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

Belirtilen özellikten değer bildirimlerini/göstergelerini etkinleştirin. Etkinleştirildikten sonra bir uygulama, onCharacteristicValueChanged etkinliğini kullanarak bildirimleri dinleyebilir.

Parametreler

  • characteristicId

    dize

    Bildirimlerin etkinleştirilmesi gereken GATT karakteristiğinin örnek kimliği.

  • mülkler

    NotificationProperties isteğe bağlı

    Bildirim oturumu özellikleri (isteğe bağlı).

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

stopCharacteristicNotifications()

Promise 
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 görüşmenin ardından uygulama, bu özellikten bildirim/gösterge almayı durdurur.

Parametreler

  • characteristicId

    dize

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

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

unregisterAdvertisement()

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

Bir reklamın kaydını siler ve reklamını durdurur. Reklamın kaydı silinmezse reklamı durdurmanın tek yolu cihazı yeniden başlatmak olabilir.

Parametreler

  • advertisementId

    sayı

    Kaydı silinecek reklamın kimliği.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

unregisterService()

Promise Chrome 52 ve sonraki sürümler 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

Belirtilen hizmetin kaydını yerel GATT sunucusundan silin. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev 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

  • serviceId

    dize

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

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

writeCharacteristicValue()

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

Uzak bir çevresel birimden belirtilen özelliğin değerini yazın.

Parametreler

  • characteristicId

    dize

    Değerinin yazılması gereken GATT karakteristiğinin örnek kimliği.

  • value

    ArrayBuffer

    Yazma isteğinin bir parçası olarak uzak özelliğe gönderilmesi gereken değer.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

writeDescriptorValue()

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

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

Parametreler

  • descriptorId

    dize

    Değerinin yazılması gereken GATT karakteristik 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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Etkinlikler

onCharacteristicReadRequest

Chrome 52 veya daha yeni bir sürüm 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Bağlı bir merkezi cihaz, yerel GATT sunucusuna kaydedilmiş bir özelliğin değerini okumak istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermemek bağlantının kesilmesine neden olabilir. Bu etkinlik yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true 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 GATT karakteristiğ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 işlevini ç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 veya daha yeni bir sürüm 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Bağlı bir merkezi cihaz, yerel GATT sunucusuna kaydedilen bir özelliğin değerini yazmayı istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermemek bağlantının kesilmesine neden olabilir. Bu etkinlik yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true 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 veya daha yeni bir sürüm 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Bağlı bir merkezi cihaz, yerel GATT sunucusuna kayıtlı bir tanımlayıcının değerini okumak istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermemek bağlantının kesilmesine neden olabilir. Bu etkinlik yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true 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,
)

Genellikle bir okuma isteği sonucunda, uzak GATT karakteristik tanımlayıcısının değeri değiştiğinde tetiklenir. Bu etkinlik, çoğunlukla kolaylık sağlamak amacıyla oluşturulur ve her zaman readDescriptorValue başarılı bir şekilde çağrıldıktan sonra gönderilir.

Parametreler

  • callback

    işlev

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

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52 veya daha yeni bir sürüm 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Bağlı bir merkezi cihaz, yerel GATT sunucusuna kaydedilen bir tanımlayıcının değerini yazmak istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermemek bağlantının kesilmesine neden olabilir. Bu etkinlik yalnızca uygulamada hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true 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 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ı, ayrıca 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