chroom.bluetoothLowEnergy

Beschrijving

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

Beschikbaarheid

alleen ChromeOS

Manifest

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

"bluetooth"

Soorten

Advertisement

Chrome 47+

Eigenschappen

  • fabrikantgegevens

    Fabrikantgegevens [] 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 "Solicit UUIDs" van de advertentiegegevens. Deze UUID's kunnen de 16-bits, 32-bits of 128-bits indeling hebben.

  • Soort advertentie.

AdvertisementType

Chrome 47+

Type advertentie. Als 'broadcast' is geselecteerd, is het verzonden advertentietype ADV_NONCONN_IND en zendt het apparaat een willekeurig MAC-adres uit. Als 'peripheral' is geselecteerd, is het advertentietype ADV_IND of ADV_SCAN_IND en zendt het apparaat het echte MAC-adres van de Bluetooth-adapter uit.

Enum

"uitzending"

"perifeer"

Characteristic

Eigenschappen

  • instantie-ID

    string optioneel

    Retourneert de identificatiecode 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 als argument accepteren. Aanwezig, als deze instantie een extern kenmerk vertegenwoordigt.

  • eigenschappen

    KarakteristiekeEigenschap []

    De eigenschappen van dit kenmerk.

  • dienst

    Service optioneel

    Tot de GATT-dienst behoort dit kenmerk.

  • uuid

    snaar

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

  • waarde

    ArrayBuffer optioneel

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

CharacteristicProperty

Waarden die de mogelijke eigenschappen van een kenmerk weergeven. De machtigingen voor het kenmerk worden afgeleid uit deze eigenschappen. Raadpleeg de Bluetooth 4.x-specificatie voor de betekenis van elke afzonderlijke eigenschap.

Enum

"uitzending"

"lezen"

"schrijvenZonderRespons"

"schrijven"

"melden"

"aanwijzen"

"authenticatedSignedWrites"

"uitgebreide eigenschappen"

"betrouwbaar schrijven"

"schrijfbare hulpfuncties"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Eigenschappen

  • volhardend

    booleaans

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

Descriptor

Eigenschappen

  • kenmerk

    Kenmerk optioneel

    Het GATT-kenmerk waartoe deze descriptor behoort.

  • instantie-ID

    string optioneel

    Retourneert de identificatiecode 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 als argument accepteren. Aanwezig, als deze instantie een extern kenmerk vertegenwoordigt.

  • toestemmingen

    DescriptorPermission []

    Chrome 52+

    De machtigingen van deze descriptor.

  • uuid

    snaar

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

  • waarde

    ArrayBuffer optioneel

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

DescriptorPermission

Chrome 52+

Waarden die mogelijke machtigingen voor een descriptor vertegenwoordigen. Raadpleeg de Bluetooth 4.x-specificatie voor de betekenis van elke afzonderlijke machtiging.

Enum

"lezen"

"schrijven"

"versleuteld lezen"

"versleuteld schrijven"

"versleuteldGeauthenticeerdLezen"

"encryptedAuthenticatedWrite"

Device

Chrome 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

    string optioneel

    De voor mensen leesbare naam van het apparaat.

ManufacturerData

Chrome 47+

Eigenschappen

  • gegevens

    nummer[]

  • id

    nummer

Notification

Chrome 52+

Eigenschappen

  • zou moeten aangeven

    boolean optioneel

    Optionele vlag om een ​​indicatie in plaats van een melding te verzenden.

  • 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 afgesloten (zie Levenscyclus van de app beheren ). De standaardwaarde is false .

Request

Chrome 52+

Eigenschappen

  • apparaat

    Apparaat

    Apparaat dat dit verzoek verzendt.

  • verzoek-ID

    nummer

    Unieke ID voor dit verzoek. Gebruik deze ID bij het beantwoorden van dit verzoek.

  • waarde

    ArrayBuffer optioneel

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

Response

Chrome 52+

Eigenschappen

  • isError

    booleaans

    Als dit een foutmelding is, moet dit waar zijn.

  • verzoek-ID

    nummer

    Het ID van het verzoek waarop dit een antwoord is.

  • waarde

    ArrayBuffer optioneel

    Responsiewaarde. Schrijfverzoeken en foutmeldingen negeren deze parameter.

Service

Eigenschappen

  • apparaatadres

    string optioneel

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

  • instantie-ID

    string optioneel

    Retourneert de identificatiecode 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 vereisen. Aanwezig, als deze instantie een externe service vertegenwoordigt.

  • isPrimair

    booleaans

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

  • uuid

    snaar

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

ServiceData

Chrome 47+

Eigenschappen

  • gegevens

    nummer[]

  • uuid

    snaar

Methoden

connect()

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

Legt een verbinding tot stand tussen de applicatie en het apparaat met het opgegeven adres. Een apparaat kan al verbonden zijn en de GATT-services kunnen beschikbaar zijn zonder dat de connect hoeft te worden aangeroepen. Een applicatie die echter toegang wil tot de GATT-services van een apparaat, moet deze functie 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 aanroep van connect .

Parameters

  • apparaatadres

    snaar

    Het Bluetooth-adres van het externe apparaat waarmee een GATT-verbinding tot stand moet worden gebracht.

  • eigenschappen

    ConnectProperties optioneel

    Verbindingseigenschappen (optioneel).

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

createCharacteristic()

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

Maak een lokaal gehoste GATT-karakteristiek aan. Deze karakteristiek moet worden gehost onder een geldige service. Als de service-ID niet geldig is, wordt de parameter `lastError` ingesteld. Deze functie is alleen beschikbaar als de app zowel de machtigingen `bluetooth:low_energy` als `bluetooth:peripheral` op `true` heeft staan. De machtiging voor randapparatuur is mogelijk niet voor alle apps beschikbaar.

Parameters

  • kenmerk

    Kenmerkend

    Het kenmerk om te creëren.

  • serviceId

    snaar

    ID van de service waarvoor dit kenmerk moet worden aangemaakt.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (characteristicId: string) => void

    • kenmerkID

      snaar

Retourneert

  • Belofte<string>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

createDescriptor()

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

Maak een lokaal gehoste GATT-descriptor aan. Deze descriptor moet worden gehost onder een geldige characteristic. Als de characteristic-ID niet geldig is, wordt de parameter `lastError` ingesteld. Deze functie is alleen beschikbaar als de app zowel de machtigingen `bluetooth:low_energy` als `bluetooth:peripheral` op `true` heeft staan. De machtiging voor randapparatuur is mogelijk niet voor alle apps beschikbaar.

Parameters

  • beschrijving

    Beschrijving

    De beschrijving die moet worden aangemaakt.

  • kenmerkID

    snaar

    ID van het kenmerk waarvoor deze descriptor moet worden aangemaakt.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (descriptorId: string) => void

    • descriptorId

      snaar

Retourneert

  • Belofte<string>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

createService()

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

Maak een lokaal gehoste GATT-service aan. Deze service kan worden geregistreerd om beschikbaar te zijn 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 machtiging voor randapparatuur is mogelijk niet voor alle apps beschikbaar.

Parameters

  • dienst

    Dienst

    De dienst om te creëren.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (serviceId: string) => void

    • serviceId

      snaar

Retourneert

  • Belofte<string>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

disconnect()

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

Verbreekt de verbinding van de app met het apparaat met het opgegeven adres. Houd er rekening mee dat dit niet altijd de fysieke verbinding zelf verbreekt, omdat er mogelijk andere apps met open verbindingen actief zijn.

Parameters

  • apparaatadres

    snaar

    Het Bluetooth-adres van het externe apparaat.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getCharacteristic()

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

Haal de GATT-eigenschap op die bij de opgegeven instantie-ID hoort en die is gekoppeld aan de opgegeven GATT-service, indien de eigenschap bestaat.

Parameters

  • kenmerkID

    snaar

    De instantie-ID van het gevraagde GATT-kenmerk.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Characteristic) => void

Retourneert

  • Belofte< Kenmerk >

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getCharacteristics()

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

Verkrijg een lijst van alle gevonden GATT-kenmerken die bij de betreffende dienst horen.

Parameters

  • serviceId

    snaar

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

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Characteristic[]) => void

Retourneert

  • Belofte< Kenmerk []>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getDescriptor()

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

Haal de GATT-karakteristiekbeschrijving op met de gegeven instantie-ID.

Parameters

  • descriptorId

    snaar

    De instantie-ID van de gevraagde GATT-karakteristiekbeschrijving.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Descriptor) => void

Retourneert

  • Promise< Descriptor >

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getDescriptors()

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

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

Parameters

  • kenmerkID

    snaar

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

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Descriptor[]) => void

Retourneert

  • Promise< Descriptor []>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getIncludedServices()

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

Vraag een lijst op van GATT-diensten die onder de opgegeven dienst vallen.

Parameters

  • serviceId

    snaar

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

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Service[]) => void

Retourneert

  • Promise< Service []>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getService()

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

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

Parameters

  • serviceId

    snaar

    De instantie-ID van de aangevraagde GATT-service.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Service) => void

Retourneert

  • Belofte< Service >

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getServices()

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

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

Let op: als de service discovery op het apparaat nog niet voltooid is, retourneert deze API een subset (mogelijk leeg) van services. Een mogelijke oplossing is om een ​​vertraging in te bouwen en/of de API herhaaldelijk aan te roepen totdat het verwachte aantal services is geretourneerd.

Parameters

  • apparaatadres

    snaar

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

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Service[]) => void

Retourneert

  • Promise< Service []>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

notifyCharacteristicValueChanged()

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

Een extern apparaat op de hoogte stellen van een nieuwe waarde voor een kenmerk. Als de vlag `shouldIndicate` in het notificatieobject is ingesteld op `true`, wordt er een indicatie verzonden in plaats van een notificatie. Let op: het kenmerk moet de eigenschap `notify` of `indicate` correct instellen tijdens het aanmaken om deze functie 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 machtiging voor randapparatuur is mogelijk niet voor alle apps beschikbaar.

Parameters

  • kenmerkID

    snaar

    Het kenmerk waarvoor de melding moet worden verzonden.

  • kennisgeving

    Kennisgeving

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

readCharacteristicValue()

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

De waarde van een gespecificeerde eigenschap ophalen van een extern randapparaat.

Parameters

  • kenmerkID

    snaar

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

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Characteristic) => void

Retourneert

  • Belofte< Kenmerk >

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

readDescriptorValue()

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

De waarde van een specifieke kenmerkdescriptor ophalen van een extern randapparaat.

Parameters

  • descriptorId

    snaar

    De instantie-ID van de GATT-karakteristiekbeschrijving waarvan de waarde van het externe apparaat moet worden uitgelezen.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: Descriptor) => void

Retourneert

  • Promise< Descriptor >

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

registerAdvertisement()

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

Maak een advertentie aan en registreer deze voor advertenties. Om deze functie aan te roepen, moet de app de machtigingen bluetooth:low_energy en bluetooth:peripheral op true hebben staan. Deze API is bovendien alleen beschikbaar voor automatisch gestarte apps in kioskmodus of door de opdrachtregelparameter '--enable-ble-advertising-in-apps' in te stellen. Zie https://developer.chrome.com/apps/manifest/bluetooth. Opmerking: Op sommige hardware worden de centrale en perifere modus tegelijkertijd ondersteund, maar op hardware die dit niet ondersteunt, zal deze aanroep het apparaat overschakelen naar de perifere modus. In het geval van hardware die niet zowel de centrale als de perifere modus ondersteunt, zal het proberen om het apparaat in beide modi te gebruiken leiden tot onvoorspelbaar gedrag of voorkomen dat andere centrale applicaties correct werken (inclusief het detecteren van Bluetooth Low Energy-apparaten).

Parameters

  • advertentie

    Advertentie

    De advertentie om te adverteren.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (advertisementId: number) => void

    • advertentie-ID

      nummer

Retourneert

  • Belofte<nummer>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

registerService()

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

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

Parameters

  • serviceId

    snaar

    Unieke ID van een aangemaakte service.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

removeService()

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

Verwijder de opgegeven service en deregistreer deze indien deze geregistreerd was. Als de service-ID ongeldig is, wordt de parameter `lastError` ingesteld. Deze functie is alleen beschikbaar als de app zowel de machtigingen `bluetooth:low_energy` als `bluetooth:peripheral` op `true` heeft staan. De machtiging voor randapparatuur is mogelijk niet voor alle apps beschikbaar.

Parameters

  • serviceId

    snaar

    Unieke ID van een actuele, geregistreerde dienst.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

resetAdvertising()

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

Hiermee worden de advertenties op het huidige apparaat gereset. Alle bestaande advertenties worden verwijderd en gestopt.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

sendRequestResponse()

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

Verstuurt een reactie op een verzoek om een ​​kenmerk of beschrijving te lezen/schrijven. Deze functie is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral heeft ingesteld. De machtiging voor randapparatuur is mogelijk niet voor alle apps beschikbaar.

Parameters

  • antwoord

    Antwoord

    Het antwoord op het verzoek.

setAdvertisingInterval()

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

Hiermee wordt het interval tussen twee opeenvolgende advertenties ingesteld. Let op: dit is een schatting. Het werkelijke interval kan aanzienlijk afwijken van de gevraagde intervallen. Op sommige hardware geldt een minimuminterval van 100 ms. De minimum- en maximumwaarden mogen het bereik dat is toegestaan ​​volgens de Bluetooth 4.2-specificatie niet overschrijden.

Parameters

  • minInterval

    nummer

    Minimale interval tussen advertenties (in milliseconden). Deze mag niet lager zijn dan 20 ms (conform de specificaties).

  • maxInterval

    nummer

    Maximale interval tussen advertenties (in milliseconden). Deze mag niet meer dan 10240 ms bedragen (conform de specificaties).

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

startCharacteristicNotifications()

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

Schakel waarde-notificaties/indicaties van het opgegeven kenmerk in. Zodra dit is ingeschakeld, kan een applicatie luisteren naar notificaties via de onCharacteristicValueChanged -gebeurtenis.

Parameters

  • kenmerkID

    snaar

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

  • eigenschappen

    NotificationProperties optioneel

    Sessie-eigenschappen voor notificaties (optioneel).

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

stopCharacteristicNotifications()

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

Schakel waarde-notificaties/indicaties van het opgegeven kenmerk uit. Na een succesvolle oproep ontvangt de applicatie geen notificaties/indicaties meer van dit kenmerk.

Parameters

  • kenmerkID

    snaar

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

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

unregisterAdvertisement()

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

Hiermee wordt een advertentie uitgeschreven en stopt de bijbehorende reclame. Als het uitschrijven van de advertentie niet lukt, is het herstarten van het apparaat mogelijk de enige manier om de reclame te stoppen.

Parameters

  • advertentie-ID

    nummer

    ID van de advertentie om uit te schrijven.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

unregisterService()

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

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

Parameters

  • serviceId

    snaar

    Unieke ID van een actuele, geregistreerde dienst.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

writeCharacteristicValue()

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

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

Parameters

  • kenmerkID

    snaar

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

  • waarde

    ArrayBuffer

    De waarde die als onderdeel van het schrijfverzoek naar de externe eigenschap moet worden verzonden.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

writeDescriptorValue()

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

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

Parameters

  • descriptorId

    snaar

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

  • waarde

    ArrayBuffer

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

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 91+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

Evenementen

onCharacteristicReadRequest

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

Deze gebeurtenis wordt geactiveerd wanneer een verbonden centraal apparaat een verzoek indient om de waarde van een kenmerk te lezen dat is geregistreerd op de lokale GATT-server. Als er lange tijd niet op dit verzoek wordt gereageerd, kan dit leiden tot een verbroken verbinding. Deze gebeurtenis is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft staan. De machtiging voor randapparatuur is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onCharacteristicValueChanged

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

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

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

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

Deze gebeurtenis wordt geactiveerd wanneer een verbonden centraal apparaat een verzoek indient om de waarde van een kenmerk te schrijven dat is geregistreerd op de lokale GATT-server. Als er lange tijd niet op dit verzoek wordt gereageerd, kan dit leiden tot een verbroken verbinding. Deze gebeurtenis is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft staan. De machtiging voor randapparatuur is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onDescriptorReadRequest

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

Deze gebeurtenis wordt geactiveerd wanneer een verbonden centraal apparaat een verzoek indient om de waarde van een descriptor te lezen die is geregistreerd op de lokale GATT-server. Als er lange tijd niet op dit verzoek wordt gereageerd, kan dit leiden tot een verbroken verbinding. Deze gebeurtenis is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft staan. De machtiging voor randapparatuur is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbelverzoek

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

Deze gebeurtenis wordt geactiveerd wanneer de waarde van een externe GATT-karakteristiekbeschrijving verandert, meestal als gevolg van een leesverzoek. Deze gebeurtenis is er vooral voor het gemak en wordt altijd verzonden na een succesvolle aanroep van readDescriptorValue .

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

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

Deze gebeurtenis wordt geactiveerd wanneer een verbonden centraal apparaat een verzoek indient om de waarde van een descriptor te schrijven die is geregistreerd op de lokale GATT-server. Als er lange tijd niet op dit verzoek wordt gereageerd, kan dit leiden tot een verbroken verbinding. Deze gebeurtenis is alleen beschikbaar als de app zowel de machtigingen bluetooth:low_energy als bluetooth:peripheral op true heeft staan. De machtiging voor randapparatuur is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbelverzoek

    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 een nieuwe GATT-service is ontdekt op een extern apparaat.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (service: Service) => void

onServiceChanged

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

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

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (service: Service) => void

onServiceRemoved

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

Deze functie wordt geactiveerd wanneer een GATT-service die eerder op een extern apparaat was gedetecteerd, is verwijderd.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (service: Service) => void