chrome.bluetoothLowEnergy

Açıklama

chrome.bluetoothLowEnergy API, Genel Özellik Profili (GATT) özelliğini kullanarak Bluetooth Smart (Düşük Enerji) cihazlarıyla iletişim kurmak için kullanılır.

Manifest

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

"bluetooth"

Türler

Advertisement

Chrome 47 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • manufacturerData

    ManufacturerData[] isteğe bağlı

    "Üreticiye Özel Veriler"e dahil edilecek üreticiye özel verilerin listesi reklamcılık verilerinin alanları.

  • serviceData

    ServiceData[] isteğe bağlı

    "Hizmet Verileri"ne dahil edilecek hizmet verilerinin listesi reklamcılık verilerinin alanları.

  • serviceUuids

    string[] isteğe bağlı

    "Hizmet UUID'lerine" dahil edilecek UUID'lerin listesi alanına girmelisiniz. Bu UUID'ler 16 bit, 32 bit veya 128 biçiminde olabilir.

  • solicitUuids

    string[] isteğe bağlı

    "İstek UUID'leri"ne dahil edilecek UUID'lerin listesi alanına girmelisiniz. Bu UUID'ler 16 bit, 32 bit veya 128 biçiminde olabilir.

  • Reklamın türü.

AdvertisementType

Chrome 47 ve sonraki sürümler 'nı inceleyin.

Reklamın türü. "Yayın yapıyorsanız" seçildiğinde, gönderilen reklam türü ADV_NONCONN_IND olur ve cihaz rastgele bir MAC adresi ile yayınlanır. "Çevre birimi" olarak ayarlanırsa reklam türü ADV_IND veya ADV_SCAN_IND olur ve cihaz, gerçek Bluetooth Adaptörün MAC Adresi ile yayın yapar.

Enum

"yayınla"

"çevre birimi"

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 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 bir uzak özelliği temsil ediyorsa mevcut olur.

  • 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ınmış özellik değeri. Bu değer, özelliğin değeri bir bildirim veya gösterge aracılığıyla okunduğunda veya güncellendiğinde güncellenir.

CharacteristicProperty

Bir özelliğin olası özelliklerini temsil eden değerler. Karakteristik izinler, bu mülklerden elde edilir. Her bir mülkün ne anlama geldiğini öğrenmek için lütfen Bluetooth 4.x spesifikasyonuna bakın.

Enum

"yayınla"

"oku"

"WriteWithoutResponse"

"Write"

"bildirimde bulun"

"belirtin"

"authenticatedsigninWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Özellikler

  • kalıcı

    boolean

    Uygulamanın etkinlik sayfası kaldırıldığında cihaz bağlantısının açık kalıp kalmadığını gösteren işaret (Uygulama Yaşam Döngüsünü Yönetme sayfasına göz atın). Varsayılan değer: false.

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. Tanımlayıcıları aynı UUID'ye sahip bir çevre biriminden ayırt etmek ve bir açıklayıcı tanımlayıcı alan işlev çağrıları yapmak için örnek kimliğini kullanın. Bu örnek bir uzak özelliği temsil ediyorsa mevcut olur.

  • Chrome 52 ve sonraki sürümler 'nı inceleyin.

    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ış açıklayıcı değer. Bu değer, açıklayıcının değeri okunduğunda güncellenir.

DescriptorPermission

Chrome 52 ve sonraki sürümler 'nı inceleyin.

Bir açıklayıcıya yönelik olası izinleri temsil eden değerler. İzinlerin ne anlama geldiğini öğrenmek için lütfen Bluetooth 4.x spesifikasyonuna bakın.

Enum

"oku"

"Write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • adres

    dize

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

  • deviceClass

    sayı 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 okunabilen adı.

ManufacturerData

Chrome 47 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • veri

    numara[]

  • id

    sayı

Notification

Chrome 52 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • shouldIndicate

    boole isteğe bağlı

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

  • value

    DiziArabelleği

    Ö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ı gösteren işaret (Uygulama Yaşam Döngüsü Yönetimi'ne bakın). Varsayılan değer false değeridir.

Request

Chrome 52 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • cihaz

    Cihaz

    Bu isteği gönderen cihaz.

  • requestId

    sayı

    Bu isteğin benzersiz kimliği. Bu isteğe yanıt verirken bu kimliği kullanın.

  • value

    ArrayBuffer isteğe bağlı

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

Response

Chrome 52 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • isError

    boolean

    Hata yanıtıysa doğru olmalıdır.

  • requestId

    sayı

    Bunun yanıt 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

    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. Hizmetleri aynı UUID'ye sahip bir çevre biriminden 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.

  • Birincil

    boolean

    Bu hizmetin türünün birincil mi yoksa ikincil mi olduğunu belirtir.

  • Uuid

    dize

    Hizmetin UUID'si, ör. 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • veri

    numara[]

  • Uuid

    dize

Yöntemler

connect()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

Uygulama ile cihaz arasında, verilen adresle bağlantı kurar. Bir cihaz zaten bağlı olabilir ve bu cihazın GATT hizmetleri connect çağrılmadan kullanılabilir. Ancak bir cihazın GATT hizmetlerine erişmek isteyen bir uygulama, cihazla bağlantının sürdürülmesini sağlamak için bu işlevi çağırmalıdır. Cihaz bağlı değilse cihazın tüm GATT hizmetleri, connect numaralı telefona başarılı bir çağrıdan sonra keşfedilir.

Parametreler

  • deviceAddress

    dize

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

  • mülkler

    ConnectProperties isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

createCharacteristic()

Söz 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 uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • özellik

    Özellik

    İçerik üretme özelliği.

  • hizmet kimliği

    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<dize>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

createDescriptor()

Söz Chrome 52 ve sonraki sürümler 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

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

Parametreler

  • açıklayıcı

    Açıklayı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<dize>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

createService()

Söz 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ılabilir olmak üzere kaydedilebilir. Bu işlev yalnızca uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi 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

    • hizmet kimliği

      dize

İadeler

  • Promise<dize>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

disconnect()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

Uygulamanın belirtilen adrese sahip cihazla bağlantısını kapatır. Açık bağlantıları olan başka uygulamalar olabileceğinden, bunun her zaman fiziksel bağlantının kendisini yok etmeyeceğ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

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getCharacteristic()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

Belirli bir GATT hizmetine ait örnek kimliğiyle GATT özelliğini elde edin (özellik mevcutsa).

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

İadeler

  • Promise<Karakteristik>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getCharacteristics()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

Belirli bir hizmete ait, keşfedilen tüm GATT özelliklerinin listesini alma.

Parametreler

  • hizmet kimliği

    dize

    Özellikleri döndürülecek 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

İadeler

  • Vaat<Karakter[]>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getDescriptor()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

Verilen örnek kimliğine sahip GATT özelliği tanımlayıcıyı alın.

Parametreler

  • descriptorId

    dize

    İstenen GATT özelliği tanımlayıcısı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

İadeler

  • Promise&lt;Descriptor&gt;

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getDescriptors()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

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

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

İadeler

  • Promise&lt;Descriptor[]&gt;

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getIncludedServices()

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

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

Parametreler

  • hizmet kimliği

    dize

    Dahil edilen hizmetlerinin 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

İadeler

  • Promise<Hizmet[]>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getService()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

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

Parametreler

  • hizmet kimliği

    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

İadeler

  • Promise&lt;Service&gt;

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getServices()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

Belirtilen cihaz adresiyle uzak cihazda bulunan tüm GATT hizmetlerini alma.

Not: Cihazda hizmet keşfi henüz tamamlanmadıysa bu API, hizmetlerin bir alt kümesini (büyük olasılıkla boş) döndürür. Geçici bir çözüm olarak, beklenen sayıda hizmet verilene kadar zamana dayalı gecikme ve/veya arama tekrarı yapılabilir.

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

İadeler

  • Promise<Hizmet[]>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

notifyCharacteristicValueChanged()

Söz Chrome 52 ve sonraki sürümler 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

Uzak cihaza bir özellik için yeni bir değer bildirir. Bildirim nesnesindeki "Beyan" işareti, "true" (doğru) değerine ayarlanırsa bildirim yerine bir gösterge gönderilir. Özelliğin "bildirim gönder"i doğru bir şekilde ayarlaması gerektiğini unutmayın. veya "belirtin" özelliğini kullanarak çağrının başarılı olmasını sağlayın. Bu işlev yalnızca uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevre birimi 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

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

readCharacteristicValue()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

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

Parametreler

  • characteristicId

    dize

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

  • geri çağırma

    işlev isteğe bağlı

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

    (result: Characteristic) => void

İadeler

  • Promise<Karakteristik>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

readDescriptorValue()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

Uzak bir çevre biriminden belirtilen bir özellik tanımlayıcı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.

  • geri çağırma

    işlev isteğe bağlı

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

    (result: Descriptor) => void

İadeler

  • Promise&lt;Descriptor&gt;

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

registerAdvertisement()

Söz Chrome 47 ve sonraki sürümler 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Bir reklam oluşturma ve onu reklam için kaydetme. Bu işlevi çağırmak için uygulamanın bluetooth:low_energy ve bluetooth:peripheral izinlerinin "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" ayarlanarak kullanılabilir. komut satırı anahtarı. 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ımda bu çağrı yapıldığında cihaz çevre birimi moduna geçirilir. Hem merkezi modu hem de çevre birimi modunu desteklemeyen donanımlar söz konusu olduğunda, cihazı her iki modda da kullanmaya çalışmak, tanımlanmamış davranışa 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 bulunması dahil).

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&lt;number&gt;

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

registerService()

Söz 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 uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • hizmet kimliği

    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

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

removeService()

Söz Chrome 52 ve sonraki sürümler 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Belirtilen hizmet kaldırılır ve kayıtlıysa kaydı iptal edilir. Hizmet kimliği geçersizse lastError ayarlanır. Bu işlev yalnızca uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • hizmet kimliği

    dize

    Şu anda kayıtlı olan hizmetin benzersiz kimliği.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

resetAdvertising()

Söz Chrome 61 ve sonraki sürümler 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Mevcut cihazda reklamları sıfırlar. Kaydı iptal eder ve mevcut tüm reklamları durdurur.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

sendRequestResponse()

Chrome 52 ve sonraki sürümler 'nı inceleyin.
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

Bir özellik veya açıklayıcı okuma/yazma isteği için yanıt gönderir. Bu işlev yalnızca uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • yanıt

    Yanıt

    İsteğe verilen yanıt.

setAdvertisingInterval()

Söz Chrome 55 ve sonraki sürümler 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

Ardışık iki reklam arasındaki aralıktır. Not: Bu en iyi çabadır. Gerçek aralık, istenen aralıklardan çok büyük ölçüde farklı olabilir. Bazı donanımlarda minimum 100 ms'lik bir aralık vardır. 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).

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

startCharacteristicNotifications()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

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

Parametreler

  • characteristicId

    dize

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

  • mülkler

    NotificationProperties isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

stopCharacteristicNotifications()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

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.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

unregisterAdvertisement()

Söz Chrome 47 ve sonraki sürümler 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

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

Parametreler

  • advertisementId

    sayı

    Kaydı iptal edilecek reklamın kimliği.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

unregisterService()

Söz 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 uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true olarak ayarlanmışsa kullanılabilir. Çevre birimi izni tüm uygulamalarda kullanılamayabilir.

Parametreler

  • hizmet kimliği

    dize

    Şu anda kayıtlı olan hizmetin benzersiz kimliği.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

writeCharacteristicValue()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

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

Parametreler

  • characteristicId

    dize

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

  • value

    DiziArabelleği

    Yazma isteğinin bir parçası olarak 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

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

writeDescriptorValue()

Söz 'nı inceleyin.
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

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

Parametreler

  • descriptorId

    dize

    Değerinin yazılması gereken GATT özelliği tanımlayıcısının örnek kimliği.

  • value

    DiziArabelleği

    Yazma isteğinin bir parçası olarak 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

  • Taahhüt<void>

    Chrome 91 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

Etkinlikler

onCharacteristicReadRequest

Chrome 52 ve sonraki sürümler 'nı inceleyin.
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Bağlı bir merkezi cihaz, yerel GATT sunucusunda kayıtlı bir özelliğin değerini okumak istediğinde tetiklenir. Bu isteğe uzun süre yanıt vermemek, bağlantının kesilmesine neden olabilir. Bu etkinlik yalnızca uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi 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 okuma isteği veya bir değer değişikliği bildirimi/göstergesi nedeniyle uzak bir GATT özelliğinin değeri değiştiğinde tetiklenir. Bu etkinlik yalnızca uygulama, startCharacteristicNotifications çağrısı yapılarak bildirimleri etkinleştirdiyse gönderilir.

Parametreler

  • geri çağırma

    işlev

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

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome 52 ve sonraki sürümler 'nı inceleyin.
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Bağlı bir merkezi cihaz, yerel GATT sunucusunda kayıtlı bir özelliğin değerini yazma isteğinde bulunduğunda tetiklenir. Bu isteğe uzun süre yanıt vermezseniz bağlantı kesilebilir. Bu etkinlik yalnızca uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi 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 sonraki sürümler 'nı inceleyin.
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 vermezseniz bağlantı kesilebilir. Bu etkinlik yalnızca uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi 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,
)

Uzak GATT karakteristik tanımlayıcısının değeri, genellikle bir okuma isteği sonucunda değiştiğinde tetiklenir. Bu etkinlik, çoğunlukla kolaylık sağlamak amacıyla düzenlenir ve her zaman readDescriptorValue numaralı telefona 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

onDescriptorWriteRequest

Chrome 52 ve sonraki sürümler 'nı inceleyin.
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Bağlı bir merkezi cihaz, yerel GATT sunucusuna kayıtlı bir tanımlayıcının değerini yazma isteğinde bulunduğunda tetiklenir. Bu isteğe uzun süre yanıt vermemek, bağlantının kesilmesine neden olabilir. Bu etkinlik yalnızca uygulamanın hem bluetooth:low_energy hem de bluetooth:peripheral izinleri true olarak ayarlandıysa kullanılabilir. Çevre birimi 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

onServiceChanged

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

Uzak GATT hizmetinin durumu değiştiğinde tetiklenir. Buna, "ServiceChanged" ile birlikte hizmete eklenen veya hizmetten kaldırılan tüm özellikler ve/veya tanımlayıcılar dahildir. uzak cihazdan bildirim gönderir.

Parametreler

  • geri çağırma

    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 GATT hizmeti kaldırıldığında tetiklenir.

Parametreler

  • geri çağırma

    işlev

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

    (service: Service) => void