chrome.bluetoothLowEnergy

Beschrijving

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

Beschikbaarheid

Alleen ChromeOS

Manifest

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

"bluetooth"

Typen

Advertisement

Chrome 47+

Eigenschappen

  • manufacturerData

    ManufacturerData[] optioneel

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

  • serviceData

    ServiceData[] optioneel

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

  • serviceUuids

    string[] optioneel

    Lijst met UUID's die moeten worden opgenomen in het veld Service-UUID's van de advertentiegegevens. Deze UUID's kunnen de indeling 16-bits, 32-bits of 128-bits hebben.

  • solicitUuids

    string[] optioneel

    Lijst met UUID's die moeten worden opgenomen in het veld UUID's aanvragen van de advertentiegegevens. Deze UUID's kunnen de indeling 16-bits, 32-bits of 128-bits hebben.

  • Type advertentie.

AdvertisementType

Chrome 47+

Type advertentie. Als je 'broadcast' kiest, is het verzonden advertentietype ADV_NONCONN_IND en zendt het apparaat uit met een willekeurig MAC-adres. Als je dit instelt op peripheral, is het advertentietype ADV_IND of ADV_SCAN_IND en zendt het apparaat uit met het MAC-adres van de echte bluetooth-adapter.

Enum

"omroepen"

"peripheral"

Characteristic

Eigenschappen

  • instanceId

    tekenreeks optioneel

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

  • property's

    CharacteristicProperty[]

    De eigenschappen van dit kenmerk.

  • service

    Service optioneel

    De GATT-service waartoe dit kenmerk behoort.

  • uuid

    tekenreeks

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

  • waarde

    ArrayBuffer optioneel

    De kenmerkwaarde die op dit moment in het cachegeheugen is opgeslagen. Deze waarde wordt geüpdatet als de waarde van het kenmerk wordt gelezen of geüpdatet via een melding of indicatie.

CharacteristicProperty

Waarden die de mogelijke eigenschappen van een kenmerk vertegenwoordigen. Kenmerkende rechten worden afgeleid van deze eigenschappen. Ga naar de Bluetooth 4.x-specificatie voor de betekenis van elke afzonderlijke property.

Enum

"omroepen"

"read"

"writeWithoutResponse"

'schrijven'

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Eigenschappen

  • persistent

    booleaans

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

Descriptor

Eigenschappen

  • kenmerk

    Kenmerk optioneel

    Het GATT-kenmerk waartoe deze descriptor behoort.

  • instanceId

    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 te doen die een descriptor-ID gebruiken. Aanwezig, als deze instantie een extern kenmerk vertegenwoordigt.

  • Chrome 52+

    De rechten van deze beschrijving.

  • uuid

    tekenreeks

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

  • waarde

    ArrayBuffer optioneel

    De momenteel in het cachegeheugen opgeslagen descriptorwaarde. Deze waarde wordt geüpdatet als de waarde van de descriptor wordt gelezen.

DescriptorPermission

Chrome 52+

Waarden die mogelijke rechten voor een descriptor vertegenwoordigen. Ga naar de Bluetooth 4.x-specificatie voor de betekenis van elk afzonderlijk recht.

Enum

"read"

'schrijven'

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52+

Eigenschappen

  • adres

    tekenreeks

    Het adres van het apparaat, in de indeling XX:XX:XX:XX:XX:XX.

  • deviceClass

    number optioneel

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

  • name

    tekenreeks optioneel

    De door mensen leesbare naam van het apparaat.

ManufacturerData

Chrome 47+

Eigenschappen

  • gegevens

    number[]

  • id

    getal

Notification

Chrome 52+

Eigenschappen

  • shouldIndicate

    booleaans optioneel

    Optionele markering om een indicatie te sturen in plaats van een melding.

  • waarde

    ArrayBuffer

    Nieuwe waarde van het kenmerk.

NotificationProperties

Eigenschappen

  • persistent

    booleaans

    Markering die aangeeft of de app meldingen moet krijgen als de gebeurtenispagina van de app wordt verwijderd (zie Levenscyclus van app beheren). De standaardwaarde is false.

Request

Chrome 52+

Eigenschappen

  • apparaat

    Apparaat

    Apparaat dat dit verzoek heeft gestuurd.

  • requestId

    getal

    Unieke ID voor dit verzoek. Gebruik deze ID als je op dit verzoek reageert.

  • waarde

    ArrayBuffer optioneel

    De waarde die moet worden geschreven (als dit een schrijfverzoek is).

Response

Chrome 52+

Eigenschappen

  • isError

    booleaans

    Als dit een foutreactie is, moet dit waar zijn.

  • requestId

    getal

    ID van het verzoek waarop dit een reactie is.

  • waarde

    ArrayBuffer optioneel

    Antwoordwaarde. Schrijfverzoeken en foutreacties negeren deze parameter.

Service

Eigenschappen

  • deviceAddress

    tekenreeks optioneel

    Het apparaatadres van het externe randapparaat waartoe de GATT-service behoort. Aanwezig als deze instantie een externe service vertegenwoordigt.

  • instanceId

    tekenreeks optioneel

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

  • isPrimary

    booleaans

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

  • uuid

    tekenreeks

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

ServiceData

Chrome 47+

Eigenschappen

  • gegevens

    number[]

  • uuid

    tekenreeks

Methoden

connect()

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

Hiermee maak je verbinding tussen de app en het apparaat met het opgegeven adres. Een apparaat is misschien al verbonden en de GATT-services zijn beschikbaar zonder connect aan te roepen. Een app die toegang wil tot de GATT-services van een apparaat, moet deze functie aanroepen om 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 geslaagde aanroep naar connect.

Parameters

  • deviceAddress

    tekenreeks

    Het bluetooth-adres van het apparaat op afstand waarmee een GATT-verbinding moet worden geopend.

  • property's

    ConnectProperties optioneel

    Verbindingseigenschappen (optioneel).

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

createCharacteristic()

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

Maak 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 de rechten bluetooth:low_energy en bluetooth:peripheral heeft ingesteld op true. Het recht voor randapparatuur is misschien niet voor alle apps beschikbaar.

Parameters

  • kenmerk

    Kenmerk

    Het kenmerk dat je wilt maken.

  • serviceId

    tekenreeks

    ID van de service waarvoor je dit kenmerk wilt maken.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (characteristicId: string) => void

    • characteristicId

      tekenreeks

Retourzendingen

  • Promise<string>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

createDescriptor()

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

Maak een lokaal gehoste GATT-descriptor. Deze descriptor moet worden gehost onder een geldige eigenschap. Als de kenmerk-ID niet geldig is, wordt de lastError ingesteld. Deze functie is alleen beschikbaar als de app de rechten bluetooth:low_energy en bluetooth:peripheral heeft ingesteld op true. Het recht voor randapparatuur is misschien niet voor alle apps beschikbaar.

Parameters

  • beschrijving

    Descriptor

    De descriptor die moet worden gemaakt.

  • characteristicId

    tekenreeks

    ID van de eigenschap waarvoor deze descriptor moet worden gemaakt.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (descriptorId: string) => void

    • descriptorId

      tekenreeks

Retourzendingen

  • Promise<string>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

createService()

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

Maak een lokaal gehoste GATT-service. Deze service kan worden geregistreerd om beschikbaar te zijn op een lokale GATT-server. Deze functie is alleen beschikbaar als de app de rechten bluetooth:low_energy en bluetooth:peripheral heeft ingesteld op true. Het recht voor randapparatuur is misschien niet voor alle apps beschikbaar.

Parameters

  • service

    Service

    De service die je wilt maken.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (serviceId: string) => void

    • serviceId

      tekenreeks

Retourzendingen

  • Promise<string>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

disconnect()

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

Sluit de verbinding van de app met het apparaat met het opgegeven adres. De fysieke link zelf wordt niet altijd verbroken, omdat er misschien andere apps zijn met open verbindingen.

Parameters

  • deviceAddress

    tekenreeks

    Het bluetooth-adres van het apparaat op afstand.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getCharacteristic()

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

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

Parameters

  • characteristicId

    tekenreeks

    De instantie-ID van het aangevraagde GATT-kenmerk.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (result: Characteristic) => void

Retourzendingen

  • Promise<Characteristic>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getCharacteristics()

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

Krijg een lijst met alle ontdekte GATT-kenmerken die bij de aangegeven service horen.

Parameters

  • serviceId

    tekenreeks

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

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (result: Characteristic[]) => void

Retourzendingen

  • Promise<Characteristic[]>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getDescriptor()

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

Haal de GATT-kenmerkdescriptor op met de aangegeven instantie-ID.

Parameters

  • descriptorId

    tekenreeks

    De instantie-ID van de aangevraagde GATT-kenmerkdescriptor.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (result: Descriptor) => void

Retourzendingen

  • Promise<Descriptor>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getDescriptors()

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

Krijg een lijst met GATT-kenmerkdescriptors die bij het gegeven kenmerk horen.

Parameters

  • characteristicId

    tekenreeks

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

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (result: Descriptor[]) => void

Retourzendingen

  • Promise<Descriptor[]>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getIncludedServices()

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

Krijg een lijst met GATT-services die zijn opgenomen in de gegeven service.

Parameters

  • serviceId

    tekenreeks

    De instantie-ID van de GATT-service waarvan de opgenomen services moeten worden geretourneerd.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (result: Service[]) => void

Retourzendingen

  • Promise<Service[]>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getService()

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

De GATT-service met de aangegeven instantie-ID ophalen.

Parameters

  • serviceId

    tekenreeks

    De instantie-ID van de aangevraagde GATT-service.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (result: Service) => void

Retourzendingen

  • Promise<Service>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getServices()

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

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

Opmerking: Als de servicedetectie nog niet is afgerond op het apparaat, retourneert deze API een subset (mogelijk leeg) van services. Een tijdelijke oplossing is om een op tijd gebaseerde vertraging toe te voegen en/of herhaaldelijk aan te roepen totdat het verwachte aantal services wordt geretourneerd.

Parameters

  • deviceAddress

    tekenreeks

    Het bluetooth-adres van het apparaat op afstand waarvan de GATT-services moeten worden geretourneerd.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (result: Service[]) => void

Retourzendingen

  • Promise<Service[]>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

notifyCharacteristicValueChanged()

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

Een apparaat op afstand op de hoogte stellen van een nieuwe waarde voor een kenmerk. Als de vlag shouldIndicate in het meldingsobject waar is, wordt er een indicatie gestuurd in plaats van een melding. De eigenschap moet de property 'notify' of 'indicate' correct instellen tijdens het maken om deze aanroep te laten slagen. Deze functie is alleen beschikbaar als de app de rechten bluetooth:low_energy en bluetooth:peripheral heeft ingesteld op true. Het recht voor randapparatuur is misschien niet voor alle apps beschikbaar.

Parameters

  • characteristicId

    tekenreeks

    Het kenmerk waarvoor de melding moet worden gestuurd.

  • melding

    Melding

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

readCharacteristicValue()

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

De waarde van een opgegeven kenmerk ophalen van een extern randapparaat.

Parameters

  • characteristicId

    tekenreeks

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

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (result: Characteristic) => void

Retourzendingen

  • Promise<Characteristic>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

readDescriptorValue()

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

Haal de waarde van een opgegeven kenmerkdescriptor op van een extern randapparaat.

Parameters

  • descriptorId

    tekenreeks

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

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (result: Descriptor) => void

Retourzendingen

  • Promise<Descriptor>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

registerAdvertisement()

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

Maak een advertentie en registreer deze voor advertenties. Als je deze functie wilt aanroepen, moeten de rechten bluetooth:low_energy en bluetooth:peripheral van de app zijn ingesteld op waar. Daarnaast is deze API alleen beschikbaar voor automatisch gestarte apps in de kioskmodus of door de opdrachtregeloptie '--enable-ble-advertising-in-apps' in te stellen. Ga naar https://developer.chrome.com/apps/manifest/bluetooth Opmerking: Op sommige hardware worden de centrale en randapparaatmodus tegelijkertijd ondersteund, maar op hardware die dit niet ondersteunt, wordt het apparaat overgezet naar de randapparaatmodus als je deze aanroep doet. In het geval van hardware die niet zowel de centrale als de randmodus ondersteunt, leidt een poging om het apparaat in beide modi te gebruiken tot ongedefinieerd gedrag of wordt voorkomen dat andere apps met een centrale rol zich correct gedragen (waaronder de detectie van Bluetooth Low Energy-apparaten).

Parameters

  • advertentie

    Advertentie

    De advertentie om te adverteren.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (advertisementId: number) => void

    • advertisementId

      getal

Retourzendingen

  • Promise<number>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

registerService()

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

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 de rechten bluetooth:low_energy en bluetooth:peripheral heeft ingesteld op true. Het recht voor randapparatuur is misschien niet voor alle apps beschikbaar.

Parameters

  • serviceId

    tekenreeks

    De unieke ID van een gemaakte service.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

removeService()

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

Verwijder de opgegeven service en maak de registratie ongedaan als deze was geregistreerd. Als de service-ID ongeldig is, wordt de lastError ingesteld. Deze functie is alleen beschikbaar als de app de rechten bluetooth:low_energy en bluetooth:peripheral heeft ingesteld op true. Het recht voor randapparatuur is misschien niet voor alle apps beschikbaar.

Parameters

  • serviceId

    tekenreeks

    De unieke ID van een huidige geregistreerde service.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

resetAdvertising()

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

Hiermee wordt advertenties op het huidige apparaat gereset. De registratie wordt ongedaan gemaakt en alle bestaande advertenties worden gestopt.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

sendRequestResponse()

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

Stuurt een reactie op een lees-/schrijfverzoek voor een kenmerk of descriptor. Deze functie is alleen beschikbaar als de app de rechten bluetooth:low_energy en bluetooth:peripheral heeft ingesteld op true. Het recht voor randapparaten is misschien niet voor alle apps beschikbaar.

Parameters

  • reactie

    Reactie

    De reactie op het verzoek.

setAdvertisingInterval()

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

Hiermee stelt u het interval tussen 2 opeenvolgende advertenties in. Opmerking: Dit is een beste inspanning. Het werkelijke interval kan aanzienlijk afwijken van de gevraagde intervallen. Op sommige hardware is er een minimuminterval van 100 ms. De minimum- en maximumwaarden mogen niet hoger zijn dan het bereik dat is toegestaan volgens de Bluetooth 4.2-specificatie.

Parameters

  • minInterval

    getal

    Minimuminterval tussen advertenties (in milliseconden). Dit mag niet lager zijn dan 20 ms (volgens de specificatie).

  • maxInterval

    getal

    Maximuminterval tussen advertenties (in milliseconden). Dit mag niet meer dan 10.240 ms zijn (volgens de specificatie).

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

startCharacteristicNotifications()

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

Zet waardemeldingen/-indicaties aan voor het aangegeven kenmerk. Nadat je dit hebt aangezet, kan een app naar meldingen luisteren via de gebeurtenis onCharacteristicValueChanged.

Parameters

  • characteristicId

    tekenreeks

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

  • property's

    NotificationProperties optioneel

    Eigenschappen van meldingssessie (optioneel).

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

stopCharacteristicNotifications()

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

Zet waardemeldingen/-indicaties van het aangegeven kenmerk uit. Na een geslaagde aanroep krijgt de app geen meldingen/indicaties meer van dit kenmerk.

Parameters

  • characteristicId

    tekenreeks

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

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

unregisterAdvertisement()

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

Maakt de registratie van een advertentie ongedaan en stopt de advertentie. Als de registratie van de advertentie niet ongedaan kan worden gemaakt, is de enige manier om de advertentie te stoppen het apparaat opnieuw op te starten.

Parameters

  • advertisementId

    getal

    ID van de advertentie waarvan de registratie ongedaan moet worden gemaakt.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

unregisterService()

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

De registratie van de aangegeven service bij de lokale GATT-server ongedaan maken. Als de service-ID ongeldig is, wordt de lastError ingesteld. Deze functie is alleen beschikbaar als de app de rechten bluetooth:low_energy en bluetooth:peripheral heeft ingesteld op true. Het recht voor randapparaten is misschien niet voor alle apps beschikbaar.

Parameters

  • serviceId

    tekenreeks

    De unieke ID van een huidige geregistreerde service.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

writeCharacteristicValue()

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

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

Parameters

  • characteristicId

    tekenreeks

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

  • waarde

    ArrayBuffer

    De waarde die naar het externe kenmerk moet worden gestuurd als onderdeel van het schrijfverzoek.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

writeDescriptorValue()

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

Schrijf de waarde van een gespecificeerde kenmerkdescriptor van een extern randapparaat.

Parameters

  • descriptorId

    tekenreeks

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

  • waarde

    ArrayBuffer

    De waarde die naar de externe descriptor moet worden gestuurd als onderdeel van het schrijfverzoek.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Evenementen

onCharacteristicReadRequest

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

Wordt geactiveerd als een verbonden centraal apparaat een verzoek indient om de waarde te lezen van een kenmerk dat is geregistreerd op de lokale GATT-server. Als u lange tijd niet op dit verzoek reageert, kan de verbinding worden verbroken. Deze gebeurtenis is alleen beschikbaar als de app de rechten bluetooth:low_energy en bluetooth:peripheral op true heeft staan. Het recht voor randapparaten is misschien niet voor alle apps beschikbaar.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • verzoek

      Verzoek

    • characteristicId

      tekenreeks

onCharacteristicValueChanged

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

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

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

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

Wordt geactiveerd als een verbonden centraal apparaat vraagt om de waarde van een kenmerk te schrijven dat is geregistreerd op de lokale GATT-server. Als je lange tijd niet op dit verzoek reageert, kan de verbinding worden verbroken. Deze gebeurtenis is alleen beschikbaar als de app de rechten bluetooth:low_energy en bluetooth:peripheral op true heeft staan. Het recht voor randapparatuur is misschien niet voor alle apps beschikbaar.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • verzoek

      Verzoek

    • characteristicId

      tekenreeks

onDescriptorReadRequest

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

Wordt geactiveerd als een verbonden centraal apparaat een verzoek indient om de waarde te lezen van een descriptor die is geregistreerd op de lokale GATT-server. Als je lange tijd niet op dit verzoek reageert, kan de verbinding worden verbroken. Deze gebeurtenis is alleen beschikbaar als de app de rechten bluetooth:low_energy en bluetooth:peripheral op true heeft staan. Het recht voor randapparatuur is misschien niet voor alle apps beschikbaar.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • verzoek

      Verzoek

    • descriptorId

      tekenreeks

onDescriptorValueChanged

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

Wordt geactiveerd als de waarde van een externe GATT-kenmerkdescriptor verandert, meestal als gevolg van een leesverzoek. Deze gebeurtenis is voornamelijk bedoeld voor het gemak en wordt altijd gestuurd na een geslaagde aanroep van readDescriptorValue.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

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

Wordt geactiveerd wanneer een verbonden centraal apparaat verzoekt om de waarde te schrijven van een descriptor die is geregistreerd op de lokale GATT-server. Als je lange tijd niet op dit verzoek reageert, kan de verbinding worden verbroken. Deze gebeurtenis is alleen beschikbaar als de app de rechten bluetooth:low_energy en bluetooth:peripheral op true heeft staan. Het recht voor randapparatuur is misschien niet voor alle apps beschikbaar.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • verzoek

      Verzoek

    • descriptorId

      tekenreeks

onServiceAdded

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

Wordt geactiveerd als er een nieuwe GATT-service is ontdekt op een apparaat op afstand.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (service: Service) => void

onServiceChanged

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

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

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (service: Service) => void

onServiceRemoved

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

Wordt geactiveerd als een GATT-service die eerder is ontdekt op een apparaat op afstand, is verwijderd.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (service: Service) => void