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 gebruiken.

"bluetooth"

Typen

Advertisement

Chroom 47+

Eigenschappen

  • fabrikantData

    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 volgende formaten hebben: 16-bits, 32-bits of 128-bits.

  • solicitUuids

    string[] optioneel

    Lijst met UUID's die moeten worden opgenomen in het veld 'Solicit UUIDs' van de advertentiegegevens. Deze UUID's kunnen de volgende formaten hebben: 16-bits, 32-bits of 128-bits.

  • Soort advertentie.

AdvertisementType

Chroom 47+

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

Enum

"uitzending"

"perifeer"

Characteristic

Eigenschappen

  • instantie-ID

    string optioneel

    Retourneert de identificatie 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 uit te voeren die een kenmerk-ID gebruiken. Aanwezig als deze instance een extern kenmerk vertegenwoordigt.

  • eigenschappen

    Kenmerkeigenschap []

    De eigenschappen van deze eigenschap.

  • dienst

    Service optioneel

    De GATT-dienst waartoe dit kenmerk behoort.

  • uuid

    snaar

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

  • waarde

    ArrayBuffer optioneel

    De momenteel gecachte kenmerkwaarde. 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. Kenmerkmachtigingen worden afgeleid van deze eigenschappen. Raadpleeg de Bluetooth 4.x-specificatie voor de betekenis van elke afzonderlijke eigenschap.

Enum

"uitzending"

"lezen"

"schrijfZonderReactie"

"schrijven"

"melden"

"aanwijzen"

"authenticatedSignedWrites"

"uitgebreideeigenschappen"

"betrouwbaarSchrijven"

"schrijfbareHulpmiddelen"

"encryptRead"

"versleutelenSchrijven"

"versleutelenGeauthenticeerdLezen"

"encryptAuthenticatedWrite"

ConnectProperties

Eigenschappen

  • volhardend

    Booleaanse

    Vlag die aangeeft of er 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

    string optioneel

    Retourneert de id die aan deze descriptor is toegewezen. Gebruik de instance-ID om onderscheid te maken tussen descriptors van een randapparaat met dezelfde UUID en om functieaanroepen te doen die een descriptor-ID accepteren. Aanwezig als deze instance een externe eigenschap vertegenwoordigt.

  • toestemmingen

    DescriptorPermission []

    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 huidige gecachte descriptorwaarde. Deze waarde wordt bijgewerkt wanneer de waarde van de descriptor wordt gelezen.

DescriptorPermission

Chroom 52+

Waarden die mogelijke rechten voor een descriptor vertegenwoordigen. Zie de Bluetooth 4.x-specificatie voor de betekenis van elke afzonderlijke toestemming.

Enum

"lezen"

"schrijven"

"versleuteldLezen"

"versleuteldSchrijven"

"versleuteldGeauthenticeerdGelezen"

"versleuteldGeauthenticeerdSchrijven"

Device

Chroom 52+

Eigenschappen

  • adres

    snaar

    Het adres van het apparaat, in de vorm '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

Chroom 47+

Eigenschappen

  • gegevens

    nummer[]

  • id

    nummer

Notification

Chroom 52+

Eigenschappen

  • moet aangeven

    boolean optioneel

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

  • waarde

    ArrayBuffer

    Nieuwe waarde van het kenmerk.

NotificationProperties

Eigenschappen

  • volhardend

    Booleaanse

    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.

  • aanvraag-ID

    nummer

    Unieke ID voor deze aanvraag. Gebruik deze ID wanneer u op deze aanvraag reageert.

  • waarde

    ArrayBuffer optioneel

    Waarde om te schrijven (indien dit een schrijfverzoek is).

Response

Chroom 52+

Eigenschappen

  • isFout

    Booleaanse

    Als dit een foutmelding is, moet dit waar zijn.

  • aanvraag-ID

    nummer

    ID van het verzoek waarop dit een reactie is.

  • waarde

    ArrayBuffer optioneel

    Antwoordwaarde. Schrijfverzoeken en foutreacties 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 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 uit te voeren die een service-ID gebruiken. Aanwezig als deze instance een externe service vertegenwoordigt.

  • isPrimair

    Booleaanse

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

Brengt een verbinding tot stand tussen de applicatie en het apparaat met het opgegeven adres. Een apparaat kan al verbonden zijn en de GATT-services beschikbaar zijn zonder connect aan te roepen. Een app 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 verbonden is, worden alle GATT-services van het apparaat gedetecteerd na een succesvolle aanroep van 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 ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

createCharacteristic()

BelofteChrome 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 ongeldig is, wordt de lastError ingesteld. Deze functie is alleen beschikbaar als de app zowel de machtiging bluetooth:low_energy als bluetooth:peripheral op true heeft staan. De peripheral-machtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • karakteristiek

    Kenmerkend

    Het kenmerk om te creëren.

  • service-ID

    snaar

    ID van de service waarvoor dit kenmerk moet worden gemaakt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (characteristicId: string) => void

    • kenmerk-ID

      snaar

Retourneren

  • Belofte<string>

    Chroom 91+

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

createDescriptor()

BelofteChrome 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 geldig kenmerk. Als de kenmerk-ID ongeldig is, wordt de lastError ingesteld. Deze functie is alleen beschikbaar als de app zowel de bluetooth:low_energy- als de bluetooth:peripheral-machtiging op true heeft staan. De peripheral-machtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • beschrijving

    Beschrijving

    De descriptor om te creëren.

  • kenmerk-ID

    snaar

    ID van het kenmerk waarvoor deze descriptor moet worden gemaakt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (descriptorId: string) => void

    • descriptor-ID

      snaar

Retourneren

  • Belofte<string>

    Chroom 91+

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

createService()

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

Maak een lokaal gehoste GATT-service. Deze service kan worden geregistreerd voor beschikbaarheid op een lokale GATT-server. Deze functie is alleen beschikbaar als de app zowel de machtiging 'bluetooth:low_energy' als de machtiging 'bluetooth:peripheral' op 'true' heeft staan. De machtiging 'peripheral' is mogelijk niet voor alle apps beschikbaar.

Parameters

  • dienst

    Dienst

    De service om te creëren.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (serviceId: string) => void

    • service-ID

      snaar

Retourneren

  • Belofte<string>

    Chroom 91+

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

disconnect()

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

Sluit de verbinding van de app met het apparaat met het opgegeven adres. Let op: dit verbreekt niet altijd de fysieke verbinding zelf, aangezien er mogelijk andere apps met een open verbinding zijn.

Parameters

  • apparaatadres

    snaar

    Het Bluetooth-adres van het externe apparaat.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

getCharacteristic()

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

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

Parameters

  • kenmerk-ID

    snaar

    De instantie-ID van het opgevraagde GATT-kenmerk.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (result: Characteristic) => void

Retourneren

  • Belofte <Kenmerk>

    Chroom 91+

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

getCharacteristics()

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

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

Parameters

  • service-ID

    snaar

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

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (result: Characteristic[]) => void

Retourneren

  • Belofte< Kenmerk []>

    Chroom 91+

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

getDescriptor()

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

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

Parameters

  • descriptor-ID

    snaar

    De instantie-ID van de opgevraagde GATT-kenmerkdescriptor.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (result: Descriptor) => void

Retourneren

  • Belofte< Descriptor >

    Chroom 91+

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

getDescriptors()

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

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

Parameters

  • kenmerk-ID

    snaar

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

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (result: Descriptor[]) => void

Retourneren

  • Belofte< Descriptor []>

    Chroom 91+

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

getIncludedServices()

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

Ontvang een lijst met GATT-diensten die bij de gegeven dienst zijn inbegrepen.

Parameters

  • service-ID

    snaar

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

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (result: Service[]) => void

Retourneren

  • Belofte< Service []>

    Chroom 91+

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

getService()

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

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

Parameters

  • service-ID

    snaar

    De instantie-ID van de aangevraagde GATT-service.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (result: Service) => void

Retourneren

  • Belofte< Service >

    Chroom 91+

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

getServices()

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

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

Opmerking: Als de servicedetectie op het apparaat nog niet is voltooid, retourneert deze API een subset (mogelijk lege) services. Een oplossing is om een tijdsafhankelijke vertraging toe te voegen en/of 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.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (result: Service[]) => void

Retourneren

  • Belofte< Service []>

    Chroom 91+

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

notifyCharacteristicValueChanged()

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

Stel een extern apparaat op de hoogte van een nieuwe waarde voor een kenmerk. Als de vlag 'shouldIndicate' in het meldingsobject op 'true' staat, wordt er een indicatie verzonden in plaats van een melding. Let op: het kenmerk moet de eigenschap 'notify' of 'indicate' correct instellen tijdens het aanmaken om deze aanroep te laten slagen. Deze functie is alleen beschikbaar als de app zowel de machtiging 'bluetooth:low_energy' als de machtiging 'bluetooth:peripheral' op 'true' heeft staan. De perifere machtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • kenmerk-ID

    snaar

    Het kenmerk waarvoor de melding moet worden verzonden.

  • kennisgeving

    Kennisgeving

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

readCharacteristicValue()

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

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

Parameters

  • kenmerk-ID

    snaar

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

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (result: Characteristic) => void

Retourneren

  • Belofte <Kenmerk>

    Chroom 91+

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

readDescriptorValue()

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

Haal de waarde van een opgegeven kenmerkende descriptor op van een extern randapparaat.

Parameters

  • descriptor-ID

    snaar

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

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (result: Descriptor) => void

Retourneren

  • Belofte< Descriptor >

    Chroom 91+

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

registerAdvertisement()

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

Maak een advertentie en registreer deze voor advertenties. Om deze functie aan te roepen, moeten de machtigingen bluetooth:low_energy en bluetooth:peripheral op true staan. Bovendien is deze API alleen beschikbaar voor automatisch gestarte apps in de kioskmodus of door de opdrachtregeloptie '--enable-ble-advertising-in-apps' in te stellen. Zie https://developer.chrome.com/apps/manifest/bluetooth. Opmerking: Op sommige hardware wordt gelijktijdige centrale en perifere modus ondersteund, maar op hardware die dit niet ondersteunt, schakelt deze aanroep het apparaat over naar de perifere modus. In het geval van hardware die zowel de centrale als de perifere modus niet ondersteunt, zal een poging om het apparaat in beide modi te gebruiken leiden tot ongedefinieerd gedrag of ervoor zorgen dat andere applicaties met een centrale rol zich niet correct gedragen (inclusief de detectie van Bluetooth Low Energy-apparaten).

Parameters

  • advertentie

    Advertentie

    De advertentie om te adverteren.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (advertisementId: number) => void

    • advertentie-ID

      nummer

Retourneren

  • Belofte<nummer>

    Chroom 91+

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

registerService()

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

Registreer de opgegeven 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 machtiging bluetooth:low_energy als bluetooth:peripheral op true heeft staan. De peripheral-machtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • service-ID

    snaar

    Unieke ID van een gemaakte service.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

removeService()

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

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

Parameters

  • service-ID

    snaar

    Unieke ID van een huidige geregistreerde service.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

resetAdvertising()

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

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

Parameters

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

sendRequestResponse()

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

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

Parameters

  • antwoord

    Antwoord

    Het antwoord op het verzoek.

setAdvertisingInterval()

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

Stelt het interval in tussen twee opeenvolgende advertenties. Let op: dit is een 'best effort'. Het werkelijke interval kan aanzienlijk afwijken van de opgegeven intervallen. Op sommige hardware is er een minimuminterval van 100 ms. De minimale en maximale waarden mogen het bereik van de Bluetooth 4.2-specificatie niet overschrijden.

Parameters

  • minInterval

    nummer

    Minimale interval tussen advertenties (in milliseconden). Dit mag niet korter zijn dan 20 ms (volgens de specificatie).

  • maxInterval

    nummer

    Maximale interval tussen advertenties (in milliseconden). Dit mag niet langer zijn dan 10240 ms (volgens de specificatie).

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

startCharacteristicNotifications()

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

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

Parameters

  • kenmerk-ID

    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 ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

stopCharacteristicNotifications()

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

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

Parameters

  • kenmerk-ID

    snaar

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

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

unregisterAdvertisement()

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

Maakt een advertentie ongedaan en stopt de advertentie. Als de advertentie niet wordt ongedaan gemaakt, is de enige manier om de advertentie te stoppen mogelijk het apparaat opnieuw opstarten.

Parameters

  • advertentie-ID

    nummer

    ID van de advertentie waarvan u zich wilt afmelden.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

unregisterService()

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

De registratie van de opgegeven 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 zowel de machtiging bluetooth:low_energy als bluetooth:peripheral op true heeft staan. De peripheral-machtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • service-ID

    snaar

    Unieke ID van een huidige geregistreerde service.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

writeCharacteristicValue()

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

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

Parameters

  • kenmerk-ID

    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 ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

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

writeDescriptorValue()

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

Schrijf de waarde van een opgegeven karakteristieke descriptor van een extern randapparaat.

Parameters

  • descriptor-ID

    snaar

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

  • waarde

    ArrayBuffer

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

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

    Promises 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 verbonden centraal apparaat de waarde van een kenmerk dat geregistreerd is op de lokale GATT-server, wil lezen. Als u lange tijd niet op dit verzoek reageert, kan de verbinding worden verbroken. Deze gebeurtenis is alleen beschikbaar als de app zowel de machtiging bluetooth:low_energy als bluetooth:peripheral op true heeft ingesteld. De peripheral-machtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

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 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 ziet er als volgt uit: 

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

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

Wordt geactiveerd wanneer een verbonden centraal apparaat vraagt om de waarde van een kenmerk te schrijven dat geregistreerd is 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 zowel de machtiging bluetooth:low_energy als bluetooth:peripheral op true heeft staan. De peripheral-machtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

onDescriptorReadRequest

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

Wordt geactiveerd wanneer een verbonden centraal apparaat de waarde van een descriptor die geregistreerd is op de lokale GATT-server, wil lezen. Als u lange tijd niet op dit verzoek reageert, kan de verbinding worden verbroken. Deze gebeurtenis is alleen beschikbaar als de app zowel de machtiging bluetooth:low_energy als bluetooth:peripheral op true heeft staan. De peripheral-machtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • verzoek

      Verzoek

    • descriptor-ID

      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 is vooral bedoeld voor het gemak en wordt altijd verzonden na een succesvolle aanroep van readDescriptorValue .

Parameters

  • terugbellen

    functie

    De callback 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 van een descriptor te schrijven die geregistreerd is 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 zowel de machtiging bluetooth:low_energy als bluetooth:peripheral op true heeft staan. De peripheral-machtiging is mogelijk niet voor alle apps beschikbaar.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • verzoek

      Verzoek

    • descriptor-ID

      snaar

onServiceAdded

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

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

Parameters

  • terugbellen

    functie

    De callback 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 aan de service worden toegevoegd of verwijderd, evenals 'ServiceChanged'-meldingen van het externe apparaat.

Parameters

  • terugbellen

    functie

    De callback 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 ziet er als volgt uit: 

    (service: Service) => void