chroom.bluetoothLowEnergy

Beschrijving

De chrome.bluetoothLowEnergy API wordt gebruikt om te communiceren met Bluetooth Smart (Low Energy) apparaten met behulp van het Generic Attribute Profile (GATT) .

Manifest

De volgende sleutels moeten in het manifest worden gedeclareerd om deze API te kunnen gebruiken.

"bluetooth"

Soorten

Advertisement

Chroom 47+

Eigenschappen

  • fabrikantGegevens

    Fabrikantgegevens [] optioneel

    Lijst met fabrikantspecifieke gegevens die moeten worden opgenomen in de velden "Fabrikantspecifieke gegevens" van de advertentiegegevens.

  • servicegegevens

    ServiceData [] optioneel

    Lijst met servicegegevens die moeten worden opgenomen in de velden "Servicegegevens" van de advertentiegegevens.

  • serviceUids

    tekenreeks[] optioneel

    Lijst met UUID's die moeten worden opgenomen in het veld "Service-UUID's" van de Advertentiegegevens. Deze UUID's kunnen de formaten 16bit, 32bit of 128 hebben.

  • verzoekUuiden

    tekenreeks[] optioneel

    Lijst met UUID's die moeten worden opgenomen in het veld 'Vraag-UUID's' van de Advertentiegegevens. Deze UUID's kunnen de formaten 16bit, 32bit of 128 hebben.

  • Soort advertentie.

AdvertisementType

Chroom 47+

Soort advertentie. Als 'broadcast' wordt gekozen, zal het verzonden advertentietype ADV_NONCONN_IND zijn en zal het apparaat uitzenden met een willekeurig MAC-adres. Indien ingesteld op 'peripheral', zal het advertentietype ADV_IND of ADV_SCAN_IND zijn en zal het apparaat uitzenden met het MAC-adres van de echte Bluetooth-adapter.

Enum

"uitzending"

"perifeer"

Characteristic

Eigenschappen

  • instantie-ID

    tekenreeks optioneel

    Retourneert de ID die aan dit kenmerk is toegewezen. Gebruik de instance-ID om onderscheid te maken tussen kenmerken van een randapparaat met dezelfde UUID en om functieaanroepen te doen die een karakteristieke ID bevatten. Aanwezig, als deze instantie een afgelegen kenmerk vertegenwoordigt.

  • eigenschappen

    KenmerkProperty []

    De eigenschappen van dit kenmerk.

  • dienst

    Dienst optioneel

    De GATT-service waartoe dit kenmerk behoort.

  • uuid

    snaar

    De UUID van het kenmerk, bijvoorbeeld 00002a37-0000-1000-8000-00805f9b34fb.

  • waarde

    ArrayBuffer optioneel

    De momenteel in de cache opgeslagen karakteristieke waarde. Deze waarde wordt bijgewerkt wanneer de waarde van het kenmerk wordt gelezen of bijgewerkt via een melding of indicatie.

CharacteristicProperty

Waarden die de mogelijke eigenschappen van een kenmerk vertegenwoordigen. Karakteristieke machtigingen worden afgeleid van deze eigenschappen. Raadpleeg de Bluetooth 4.x-specificatie om de betekenis van elke individuele eigenschap te zien.

Enum

"uitzending"

"lezen"

"Schrijf zonder antwoord"

"schrijven"

"op de hoogte brengen"

"aanwijzen"

"geverifieerdeSignedWrites"

"uitgebreide eigenschappen"

"betrouwbaarSchrijven"

"schrijfbareHulpmiddelen"

"versleutelenLezen"

"versleutelenSchrijven"

"versleutelenAuthenticatedRead"

"versleutelenAuthenticatedWrite"

ConnectProperties

Eigenschappen

  • volhardend

    Booleaans

    Vlag die aangeeft of een verbinding met het apparaat open blijft wanneer de gebeurtenispagina van de applicatie wordt verwijderd (zie App-levenscyclus beheren ). De standaardwaarde is false.

Descriptor

Eigenschappen

  • karakteristiek

    Kenmerk optioneel

    Het GATT-kenmerk waartoe deze descriptor behoort.

  • instantie-ID

    tekenreeks optioneel

    Retourneert de ID die aan deze descriptor is toegewezen. Gebruik de instantie-ID om onderscheid te maken tussen descriptors van een randapparaat met dezelfde UUID en om functieaanroepen uit te voeren die een descriptor-ID bevatten. Aanwezig, als deze instantie een afgelegen kenmerk vertegenwoordigt.

  • machtigingen

    DescriptorPermissie []

    Chroom 52+

    De machtigingen van deze descriptor.

  • uuid

    snaar

    De UUID van de karakteristieke descriptor, bijvoorbeeld 00002902-0000-1000-8000-00805f9b34fb.

  • waarde

    ArrayBuffer optioneel

    De momenteel in de cache opgeslagen descriptorwaarde. Deze waarde wordt bijgewerkt wanneer de waarde van de descriptor wordt gelezen.

DescriptorPermission

Chroom 52+

Waarden die mogelijke machtigingen voor een descriptor vertegenwoordigen. Raadpleeg de Bluetooth 4.x-specificatie om de betekenis van elke individuele toestemming te zien.

Enum

"lezen"

"schrijven"

"versleuteld lezen"

"gecodeerd schrijven"

"versleuteldAuthenticatedRead"

"versleuteldAuthenticatedWrite"

Device

Chroom 52+

Eigenschappen

  • adres

    snaar

    Het adres van het apparaat, in het formaat 'XX:XX:XX:XX:XX:XX'.

  • apparaatKlasse

    nummer optioneel

    De klasse van het apparaat, een bitveld gedefinieerd door http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

  • naam

    tekenreeks optioneel

    De voor mensen leesbare naam van het apparaat.

ManufacturerData

Chroom 47+

Eigenschappen

  • gegevens

    nummer[]

  • Identiteitskaart

    nummer

Notification

Chroom 52+

Eigenschappen

  • zou moetenaangeven

    Booleaans optioneel

    Optionele vlag voor het versturen van een indicatie in plaats van een melding.

  • waarde

    ArrayBuffer

    Nieuwe waarde van het kenmerk.

NotificationProperties

Eigenschappen

  • volhardend

    Booleaans

    Vlag die aangeeft of de app meldingen moet ontvangen wanneer de gebeurtenispagina van de applicatie wordt verwijderd (zie App-levenscyclus beheren ). De standaardwaarde is false .

Request

Chroom 52+

Eigenschappen

  • apparaat

    Apparaat

    Apparaat dat dit verzoek verzendt.

  • verzoekID

    nummer

    Unieke ID voor dit verzoek. Gebruik deze ID bij het reageren op dit verzoek.

  • waarde

    ArrayBuffer optioneel

    Te schrijven waarde (als dit een schrijfverzoek is).

Response

Chroom 52+

Eigenschappen

  • isFout

    Booleaans

    Als dit een foutreactie is, zou dit waar moeten zijn.

  • verzoekID

    nummer

    Id van het verzoek waarop dit een antwoord is.

  • waarde

    ArrayBuffer optioneel

    Reactiewaarde. Bij schrijfverzoeken en foutreacties wordt deze parameter genegeerd.

Service

Eigenschappen

  • apparaatAdres

    tekenreeks optioneel

    Het apparaatadres van het externe randapparaat waartoe de GATT-service behoort. Aanwezig, als dit exemplaar een externe service vertegenwoordigt.

  • instantie-ID

    tekenreeks optioneel

    Retourneert de ID die aan deze service is toegewezen. Gebruik de instance-ID om onderscheid te maken tussen services van een randapparaat met dezelfde UUID en om functieaanroepen te doen die een service-ID bevatten. Aanwezig, als dit exemplaar een externe service vertegenwoordigt.

  • isPrimair

    Booleaans

    Geeft aan of het type van deze service primair of secundair is.

  • uuid

    snaar

    De UUID van de service, bijvoorbeeld 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chroom 47+

Eigenschappen

  • gegevens

    nummer[]

  • uuid

    snaar

Methoden

connect()

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

Brengt een verbinding tot stand tussen de applicatie en het apparaat met het opgegeven adres. Het kan zijn dat een apparaat al verbonden is en dat de GATT-services beschikbaar zijn zonder connect aan te roepen. Een app die toegang wil krijgen tot de GATT-services van een apparaat moet deze functie echter aanroepen om ervoor te zorgen dat de verbinding met het apparaat behouden blijft. Als het apparaat niet is verbonden, worden alle GATT-services van het apparaat ontdekt na een succesvolle connect .

Parameters

  • apparaatAdres

    snaar

    Het Bluetooth-adres van het externe apparaat waarmee een GATT-verbinding moet worden geopend.

  • eigenschappen

    ConnectProperties optioneel

    Verbindingseigenschappen (optioneel).

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

createCharacteristic()

BeloofChrome 52+
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

Creëer een lokaal gehost GATT-kenmerk. Dit kenmerk moet worden gehost onder een geldige service. Als de service-ID niet geldig is, wordt de lastError ingesteld. Deze functie is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft ingesteld. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • karakteristiek

    Kenmerkend

    Het kenmerk om te creëren.

  • serviceId

    snaar

    ID van de service waarvoor dit kenmerk moet worden gemaakt.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (characteristicId: string) => void

    • karakteristiekId

      snaar

Retouren

  • Beloof<tekenreeks>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

createDescriptor()

BeloofChrome 52+
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

Maak een lokaal gehoste GATT-descriptor. Deze descriptor moet worden gehost onder een geldig kenmerk. Als het kenmerk-ID niet geldig is, wordt de lastError ingesteld. Deze functie is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft ingesteld. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • beschrijving

    Beschrijving

    De descriptor die moet worden gemaakt.

  • karakteristiekId

    snaar

    ID van het kenmerk waarvoor deze descriptor moet worden gemaakt.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (descriptorId: string) => void

    • descriptorId

      snaar

Retouren

  • Beloof<tekenreeks>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

createService()

BeloofChrome 52+
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

Creëer een lokaal gehoste GATT-service. Deze dienst kan worden geregistreerd zodat deze beschikbaar is op een lokale GATT-server. Deze functie is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft ingesteld. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • dienst

    Dienst

    De dienst om te creëren.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (serviceId: string) => void

    • serviceId

      snaar

Retouren

  • Beloof<tekenreeks>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

disconnect()

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

Sluit de verbinding van de app met het apparaat met het opgegeven adres. Houd er rekening mee dat hierdoor niet altijd de fysieke link zelf wordt vernietigd, omdat er mogelijk andere apps zijn met open verbindingen.

Parameters

  • apparaatAdres

    snaar

    Het Bluetooth-adres van het externe apparaat.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

getCharacteristic()

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

Haal het GATT-kenmerk op met de opgegeven instantie-ID die bij de gegeven GATT-service hoort, als het kenmerk bestaat.

Parameters

  • karakteristiekId

    snaar

    De instance-ID van het aangevraagde GATT-kenmerk.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Characteristic) => void

Retouren

  • Belofte< Kenmerk >

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

getCharacteristics()

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

Krijg een lijst met alle ontdekte GATT-kenmerken die bij de gegeven dienst horen.

Parameters

  • serviceId

    snaar

    De exemplaar-ID van de GATT-service waarvan de kenmerken moeten worden geretourneerd.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Characteristic[]) => void

Retouren

  • Belofte< Kenmerk []>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

getDescriptor()

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

Haal de GATT-karakteristieke descriptor op met de opgegeven instantie-ID.

Parameters

  • descriptorId

    snaar

    De instantie-ID van de aangevraagde GATT-kenmerkdescriptor.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Descriptor) => void

Retouren

  • Beloof <Descriptor>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

getDescriptors()

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

Ontvang een lijst met GATT-kenmerkbeschrijvingen die bij het gegeven kenmerk horen.

Parameters

  • karakteristiekId

    snaar

    De instantie-ID van het GATT-kenmerk waarvan de descriptors moeten worden geretourneerd.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Descriptor[]) => void

Retouren

  • Beloof < Beschrijving []>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

getIncludedServices()

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

Ontvang een lijst met GATT-services die bij de betreffende service zijn inbegrepen.

Parameters

  • serviceId

    snaar

    De exemplaar-ID van de GATT-service waarvan de inbegrepen services moeten worden geretourneerd.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Service[]) => void

Retouren

  • Beloof < Service []>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

getService()

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

Haal de GATT-service op met de opgegeven instantie-ID.

Parameters

  • serviceId

    snaar

    De exemplaar-ID van de aangevraagde GATT-service.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Service) => void

Retouren

  • Beloof <Service>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

getServices()

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

Haal alle GATT-services op die zijn ontdekt op het externe apparaat met het opgegeven apparaatadres.

Opmerking: als de servicedetectie nog niet is voltooid op het apparaat, retourneert deze API een subset (mogelijk leeg) van services. U kunt dit omzeilen door een op tijd gebaseerde vertraging toe te voegen en/of herhaaldelijk te bellen totdat het verwachte aantal services is geretourneerd.

Parameters

  • apparaatAdres

    snaar

    Het Bluetooth-adres van het externe apparaat waarvan de GATT-services moeten worden geretourneerd.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Service[]) => void

Retouren

  • Beloof < Service []>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

notifyCharacteristicValueChanged()

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

Breng een extern apparaat op de hoogte van een nieuwe waarde voor een kenmerk. Als de vlag ShouldIndicate in het notificatieobject waar is, wordt er een indicatie verzonden in plaats van een notificatie. Let op: het kenmerk moet tijdens het maken de eigenschap 'notify' of 'indicate' correct instellen om deze aanroep te laten slagen. Deze functie is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft ingesteld. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • karakteristiekId

    snaar

    Het kenmerk waarvoor de kennisgeving wordt verzonden.

  • kennisgeving

    Kennisgeving

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

readCharacteristicValue()

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

Haal de waarde van een gespecificeerd kenmerk op van een extern randapparaat.

Parameters

  • karakteristiekId

    snaar

    De instantie-ID van het GATT-kenmerk waarvan de waarde moet worden gelezen vanaf het externe apparaat.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Characteristic) => void

Retouren

  • Belofte< Kenmerk >

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

readDescriptorValue()

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

Haal de waarde van een gespecificeerde karakteristieke descriptor op van een extern randapparaat.

Parameters

  • descriptorId

    snaar

    De instantie-ID van de GATT-kenmerkdescriptor waarvan de waarde moet worden gelezen vanaf het externe apparaat.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Descriptor) => void

Retouren

  • Beloof <Descriptor>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

registerAdvertisement()

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

Maak een advertentie en registreer deze voor adverteren. Om deze functie aan te roepen, moet de app de machtigingen bluetooth:low_energy en bluetooth:peripheral hebben ingesteld op true. Bovendien is deze API alleen beschikbaar voor automatisch gestarte apps in de kioskmodus of door de opdrachtregelschakelaar '--enable-ble-advertising-in-apps' in te stellen. Zie https://developer.chrome.com/apps/manifest/bluetooth Let op: Op sommige hardware worden de centrale en randmodi tegelijkertijd ondersteund, maar op hardware die dit niet ondersteunt, wordt door deze oproep overgeschakeld naar perifere modus. In het geval van hardware die niet zowel de centrale als de perifere modus ondersteunt, zal een poging om het apparaat in beide modi te gebruiken leiden tot ongedefinieerd gedrag of voorkomen dat andere toepassingen met een centrale rol zich correct gedragen (inclusief de ontdekking van Bluetooth Low Energy-apparaten).

Parameters

  • advertentie

    Advertentie

    De advertentie om te adverteren.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (advertisementId: number) => void

    • advertentieId

      nummer

Retouren

  • Beloof<nummer>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

registerService()

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

Registreer de gegeven service bij de lokale GATT-server. Als de service-ID ongeldig is, wordt de lastError ingesteld. Deze functie is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft ingesteld. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • serviceId

    snaar

    Unieke ID van een gemaakte dienst.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

removeService()

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

Verwijder de opgegeven service en maak de registratie ongedaan als deze geregistreerd was. Als de service-ID ongeldig is, wordt de lastError ingesteld. Deze functie is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft ingesteld. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • serviceId

    snaar

    Unieke ID van een huidige geregistreerde dienst.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

resetAdvertising()

BeloofChrome 61+
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Reset reclame op het huidige apparaat. Het zal de registratie ongedaan maken en alle bestaande advertenties stoppen.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

sendRequestResponse()

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

Verzendt een antwoord voor een lees-/schrijfverzoek voor een kenmerk of descriptor. Deze functie is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft ingesteld. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • antwoord

    Antwoord

    Het antwoord op het verzoek.

setAdvertisingInterval()

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

Stel het interval in tussen twee opeenvolgende advertenties. Let op: Dit is een inspanning. Het werkelijke interval kan niet triviaal afwijken van de gevraagde intervallen. Op sommige hardware is er een minimuminterval van 100 ms. De minimum- en maximumwaarden mogen het bereik dat is toegestaan ​​door de Bluetooth 4.2-specificatie niet overschrijden.

Parameters

  • minInterval

    nummer

    Minimale interval tussen advertenties (in milliseconden). Dit kan niet lager zijn dan 20 ms (volgens de specificaties).

  • maxInterval

    nummer

    Maximaal interval tussen advertenties (in milliseconden). Dit kan niet meer zijn dan 10240 ms (volgens de specificaties).

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

startCharacteristicNotifications()

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

Schakel waardemeldingen/indicaties van het opgegeven kenmerk in. Eenmaal ingeschakeld, kan een toepassing naar meldingen luisteren met behulp van de gebeurtenis onCharacteristicValueChanged .

Parameters

  • karakteristiekId

    snaar

    De instantie-ID van het GATT-kenmerk waarvoor meldingen moeten worden ingeschakeld.

  • eigenschappen

    NotificationProperties optioneel

    Eigenschappen van meldingssessie (optioneel).

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

stopCharacteristicNotifications()

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

Schakel waardemeldingen/indicaties van het opgegeven kenmerk uit. Na een succesvolle oproep ontvangt de applicatie geen meldingen/indicaties van dit kenmerk.

Parameters

  • karakteristiekId

    snaar

    De instantie-ID van het GATT-kenmerk waarop de meldingssessie van deze app moet worden gestopt.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

unregisterAdvertisement()

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

Maakt de registratie van een advertentie ongedaan en stopt de reclame ervan. Als de advertentie zich niet kan afmelden, is de enige manier om de reclame te stoppen mogelijk het opnieuw opstarten van het apparaat.

Parameters

  • advertentieId

    nummer

    Id van de advertentie om u af te melden.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

unregisterService()

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

Maak de registratie van de gegeven service ongedaan bij de lokale GATT-server. Als de service-ID ongeldig is, wordt de lastError ingesteld. Deze functie is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft ingesteld. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • serviceId

    snaar

    Unieke ID van een huidige geregistreerde dienst.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

writeCharacteristicValue()

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

Schrijf de waarde van een gespecificeerd kenmerk van een extern randapparaat.

Parameters

  • karakteristiekId

    snaar

    De instantie-ID van het GATT-kenmerk waarnaar de waarde moet worden geschreven.

  • waarde

    ArrayBuffer

    De waarde die als onderdeel van de schrijfaanvraag naar het externe kenmerk moet worden verzonden.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

writeDescriptorValue()

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

Schrijf de waarde van een gespecificeerde karakteristieke descriptor vanaf een extern randapparaat.

Parameters

  • descriptorId

    snaar

    De instantie-ID van de GATT-kenmerkdescriptor waarnaar de waarde moet worden geschreven.

  • waarde

    ArrayBuffer

    De waarde die naar de externe descriptor moet worden verzonden als onderdeel van de schrijfaanvraag.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

Evenementen

onCharacteristicReadRequest

Chroom 52+
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Wordt geactiveerd wanneer een aangesloten centraal apparaat vraagt ​​om de waarde te lezen van een kenmerk dat is geregistreerd op de lokale GATT-server. Als u langere tijd niet op dit verzoek reageert, kan dit leiden tot het verbreken van de verbinding. Deze gebeurtenis is alleen beschikbaar als voor de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral zijn ingesteld op true. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • verzoek

      Verzoek

    • karakteristiekId

      snaar

onCharacteristicValueChanged

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

Wordt geactiveerd wanneer de waarde van een extern GATT-kenmerk verandert, hetzij als gevolg van een leesverzoek, hetzij als een melding/indicatie van een waardewijziging. Deze gebeurtenis wordt alleen verzonden als de app meldingen heeft ingeschakeld door startCharacteristicNotifications aan te roepen.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

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

Wordt geactiveerd wanneer een aangesloten centraal apparaat vraagt ​​om de waarde te schrijven van een kenmerk dat is geregistreerd op de lokale GATT-server. Als u langere tijd niet op dit verzoek reageert, kan dit leiden tot het verbreken van de verbinding. Deze gebeurtenis is alleen beschikbaar als voor de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral zijn ingesteld op true. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • verzoek

      Verzoek

    • karakteristiekId

      snaar

onDescriptorReadRequest

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

Wordt geactiveerd wanneer een aangesloten centraal apparaat vraagt ​​om de waarde te lezen van een descriptor die is geregistreerd op de lokale GATT-server. Als u langere tijd niet op dit verzoek reageert, kan dit leiden tot het verbreken van de verbinding. Deze gebeurtenis is alleen beschikbaar als voor de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral zijn ingesteld op true. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • verzoek

      Verzoek

    • descriptorId

      snaar

onDescriptorValueChanged

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

Wordt geactiveerd wanneer de waarde van een externe GATT-kenmerkdescriptor verandert, meestal als gevolg van een leesverzoek. Deze gebeurtenis bestaat voornamelijk voor het gemak en wordt altijd verzonden na een succesvolle aanroep naar readDescriptorValue .

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

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

Wordt geactiveerd wanneer een verbonden centraal apparaat vraagt ​​om de waarde te schrijven van een descriptor die is geregistreerd op de lokale GATT-server. Als u langere tijd niet op dit verzoek reageert, kan dit leiden tot het verbreken van de verbinding. Deze gebeurtenis is alleen beschikbaar als voor de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral zijn ingesteld op true. De randmachtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • verzoek

      Verzoek

    • descriptorId

      snaar

onServiceAdded

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

Wordt geactiveerd wanneer er een nieuwe GATT-service is ontdekt op een extern apparaat.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (service: Service) => void

onServiceChanged

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

Wordt geactiveerd wanneer de status van een externe GATT-service verandert. Dit omvat alle kenmerken en/of beschrijvingen die worden toegevoegd aan of verwijderd uit de service, evenals "ServiceChanged"-meldingen van het externe apparaat.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (service: Service) => void

onServiceRemoved

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

Wordt geactiveerd wanneer een GATT-service die eerder op een extern apparaat is ontdekt, is verwijderd.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (service: Service) => void