chrome.bluetoothLowEnergy

Descrição

A API chrome.bluetoothLowEnergy é usada para se comunicar com dispositivos Bluetooth inteligentes (de baixa energia) usando o Perfil de atributo genérico (GATT, na sigla em inglês).

Manifesto

As chaves a seguir precisam ser declaradas no manifesto para usar essa API.

"bluetooth"

Tipos

Advertisement

Chrome 47 ou superior

Propriedades

• manufacturerData

  ManufacturerData[] opcional

  Lista de dados específicos do fabricante a serem incluídos em "Dados específicos do fabricante" dos dados de publicidade.

• serviceData

  ServiceData[] opcional

  Lista de dados de serviço a serem incluídos em "Dados de serviço" dos dados de publicidade.

• serviceUuids

  string[] opcional

  Lista de UUIDs a serem incluídos em "UUIDs de serviço" dos dados de publicidade. Esses UUIDs podem estar nos formatos de 16, 32 ou 128 bits.

• solicitUuids

  string[] opcional

  Lista de UUIDs a serem incluídos em "Solicitar UUIDs" dos dados de publicidade. Esses UUIDs podem estar nos formatos de 16, 32 ou 128 bits.

• tipo

  AdvertisementType

  Tipo de anúncio.

AdvertisementType

Chrome 47 ou superior

Tipo de anúncio. Se for "broadcast" for escolhido, o tipo de anúncio enviado será ADV_NONCONN_IND e o dispositivo transmitirá com um endereço MAC aleatório. Se a política for definida como "peripheral", o tipo de anúncio será ADV_IND ou ADV_SCAN_IND, e o dispositivo fará a transmissão com o endereço MAC real do adaptador Bluetooth.

Enumeração

"transmissão"

"periférico"

Characteristic

Propriedades

• instanceId

  string opcional

  Retorna o identificador atribuído a essa característica. Use o ID da instância para distinguir as características de um periférico com o mesmo UUID e para fazer chamadas de função que recebem um identificador de característica. Presente, se a instância representar uma característica remota.

• properties

  CharacteristicProperty[]

  As propriedades dessa característica.

• serviço

  Serviço opcional

  O serviço GATT ao qual essa característica pertence.

• uuid

  string

  O UUID da característica. Por exemplo, 00002a37-0000-1000-8000-00805f9b34fb.

• valor

  ArrayBuffer opcional

  O valor da característica armazenada em cache no momento. Esse valor é atualizado quando o valor da característica é lido ou atualizado por meio de uma notificação ou indicação.

CharacteristicProperty

Valores que representam as possíveis propriedades de uma característica. As permissões de características são inferidas a partir dessas propriedades. Consulte a especificação Bluetooth 4.x para ver o significado de cada propriedade individual.

Enumeração

"transmissão"

"leitura"

"writeWithoutResponse"

"write"

"notificar"

"indicar"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"Auxiliares graváveis"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Propriedades

• persistente

  booleano

  Sinalização que indica se uma conexão com o dispositivo é deixada aberta quando a página de eventos do app é descarregada (consulte Gerenciar o ciclo de vida do app). O valor padrão é false..

Descriptor

Propriedades

• característica

  Característica opcional

  A característica GATT a que esse descritor pertence.

• instanceId

  string opcional

  Retorna o identificador atribuído a esse descritor. Use o ID da instância para distinguir entre descritores de um periférico com o mesmo UUID e para fazer chamadas de função que recebem um identificador de descritor. Presente, se a instância representar uma característica remota.

• permissões

  DescriptorPermission[]

  Chrome 52 ou superior

  As permissões desse descritor.

• uuid

  string

  O UUID do descritor de característica, por exemplo, 00002902-0000-1000-8000-00805f9b34fb.

• valor

  ArrayBuffer opcional

  O valor do descritor armazenado em cache no momento. Esse valor é atualizado quando o valor do descritor é lido.

DescriptorPermission

Chrome 52 ou superior

Valores que representam possíveis permissões para um descritor. Consulte a especificação Bluetooth 4.x para ver o significado de cada permissão individual.

Enumeração

"leitura"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 ou superior

Propriedades

• endereço

  string

  O endereço do dispositivo, no formato "XX:XX:XX:XX:XX:XX".

• deviceClass

  número opcional

  A classe do dispositivo, um campo de bit definido por http://www.bluetooth.org/en-us/specification/componentes-numbers/baseband.

• nome

  string opcional

  O nome legível do dispositivo.

ManufacturerData

Chrome 47 ou superior

Propriedades

• dados

  número[]

• id

  number

Notification

Chrome 52 ou superior

Propriedades

• shouldIndicate

  booleano opcional

  Sinalização opcional para enviar uma indicação em vez de uma notificação.

• valor

  Buffer de matriz

  Novo valor da característica.

NotificationProperties

Propriedades

• persistente

  booleano

  Sinalização que indica se o app deve receber notificações quando a página de eventos do app é descarregada (consulte Gerenciar o ciclo de vida do app). O valor padrão é false.

Request

Chrome 52 ou superior

Propriedades

• dispositivo

  Dispositivo

  Dispositivo que envia esta solicitação.

• requestId

  number

  ID exclusivo da solicitação. Use esse ID ao responder a esta solicitação.

• valor

  ArrayBuffer opcional

  Valor a ser gravado (se for uma solicitação de gravação).

Response

Chrome 52 ou superior

Propriedades

• isError

  booleano

  Se for uma resposta de erro, deve ser verdadeiro.

• requestId

  number

  ID da solicitação para a qual é uma resposta.

• valor

  ArrayBuffer opcional

  Valor da resposta. Solicitações de gravação e respostas de erro ignorarão esse parâmetro.

Service

Propriedades

• deviceAddress

  string opcional

  O endereço do dispositivo do periférico remoto ao qual o serviço GATT pertence. Presente, se esta instância representar um serviço remoto.

• instanceId

  string opcional

  Retorna o identificador atribuído a este serviço. Use o ID da instância para distinguir entre serviços de um periférico com o mesmo UUID e para fazer chamadas de função que recebem um identificador de serviço. Presente, se esta instância representar um serviço remoto.

• isPrimary

  booleano

  Indica se o tipo desse serviço é principal ou secundário.

• uuid

  string

  O UUID do serviço, por exemplo, 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47 ou superior

Propriedades

• dados

  número[]

• uuid

  string

Métodos

connect()

Promessa

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

Estabelece uma conexão entre o aplicativo e o dispositivo com o endereço fornecido. Um dispositivo pode já estar conectado e os serviços GATT dele podem estar disponíveis sem chamar connect. No entanto, um app que queira acessar os serviços GATT de um dispositivo precisa chamar essa função para garantir que a conexão com o dispositivo seja mantida. Se o dispositivo não estiver conectado, todos os serviços GATT do dispositivo serão descobertos após uma chamada bem-sucedida para connect.

Parâmetros

• deviceAddress

  string

  O endereço Bluetooth do dispositivo remoto ao qual uma conexão GATT deve ser aberta.

• properties

  ConnectProperties opcional

  Propriedades da conexão (opcional).

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

createCharacteristic()

Promessa Chrome 52 ou versão mais recente

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

Crie uma característica GATT hospedada localmente. Essa característica precisa ser hospedada em um serviço válido. Se o ID do serviço não for válido, lastError será definido. Essa função só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• característica

  Característica

  A característica a ser criada.

• serviceId

  string

  ID do serviço para o qual criar essa característica.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (characteristicId: string) => void

  • characteristicId

    string

Retorna

• Promessa<string>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

createDescriptor()

Promessa Chrome 52 ou versão mais recente

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

Criar um descritor GATT hospedado localmente. Esse descritor precisa estar hospedado em uma característica válida. Se o ID da característica não for válido, o lastError será definido. Essa função só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• descritor

  Descritor

  Descritor a ser criado.

• characteristicId

  string

  ID da característica para a qual criar esse descritor.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (descriptorId: string) => void

  • descriptorId

    string

Retorna

• Promessa<string>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

createService()

Promessa Chrome 52 ou versão mais recente

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

Crie um serviço GATT hospedado localmente. Esse serviço pode ser registrado para ficar disponível em um servidor GATT local. Essa função só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• serviço

  Serviço

  O serviço a ser criado.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (serviceId: string) => void

  • serviceId

    string

Retorna

• Promessa<string>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

disconnect()

Promessa

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

Fecha a conexão do app ao dispositivo com o endereço fornecido. Observe que isso nem sempre vai destruir o próprio link físico, já que pode haver outros apps com conexões abertas.

Parâmetros

• deviceAddress

  string

  O endereço Bluetooth do dispositivo remoto.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getCharacteristic()

Promessa

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

Acessa a característica GATT com o ID de instância fornecido que pertence ao serviço GATT determinado, se a característica existir.

Parâmetros

• characteristicId

  string

  O ID da instância da característica GATT solicitada.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (result: Characteristic) => void

  • resultado

    Característica

Retorna

• Promessa<Characteristic>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getCharacteristics()

Promessa

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

Receba uma lista de todas as características GATT descobertas que pertencem ao serviço fornecido.

Parâmetros

• serviceId

  string

  O ID da instância do serviço GATT com as características que precisam ser retornadas.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (result: Characteristic[]) => void

  • resultado

    Característica[]

Retorna

• Promessa<Characteristic[]>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getDescriptor()

Promessa

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

Encontra o descritor de característica GATT com o ID de instância fornecido.

Parâmetros

• descriptorId

  string

  O ID da instância do descritor de característica GATT solicitado.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (result: Descriptor) => void

  • resultado

    Descritor

Retorna

• Promise&lt;Descriptor&gt;

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getDescriptors()

Promessa

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

Extrai uma lista de descritores de característica GATT que pertencem à característica determinada.

Parâmetros

• characteristicId

  string

  O ID da instância da característica GATT cujos descritores precisam ser retornados.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (result: Descriptor[]) => void

  • resultado

    Descritor[]

Retorna

• Promise&lt;Descriptor[]&gt;

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getIncludedServices()

Promessa

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

Extrai uma lista de serviços GATT incluídos pelo serviço fornecido.

Parâmetros

• serviceId

  string

  O ID da instância do serviço GATT cujos serviços incluídos devem ser retornados.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (result: Service[]) => void

  • resultado

    Serviço[]

Retorna

• Promessa <Serviço[]>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getService()

Promessa

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

Acessa o serviço GATT com o ID de instância fornecido.

Parâmetros

• serviceId

  string

  O ID da instância do serviço GATT solicitado.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (result: Service) => void

  • resultado

    Serviço

Retorna

• Promise&lt;Service&gt;

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getServices()

Promessa

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

Acessa todos os serviços GATT que foram descobertos no dispositivo remoto com o endereço do dispositivo especificado.

Observação:se a descoberta do serviço ainda não estiver concluída no dispositivo, essa API vai retornar um subconjunto (possivelmente vazio) de serviços. Uma solução alternativa é adicionar um atraso baseado em tempo e/ou fazer chamadas repetidamente até que o número esperado de serviços seja retornado.

Parâmetros

• deviceAddress

  string

  O endereço Bluetooth do dispositivo remoto cujos serviços GATT devem ser retornados.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (result: Service[]) => void

  • resultado

    Serviço[]

Retorna

• Promessa <Serviço[]>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

notifyCharacteristicValueChanged()

Promessa Chrome 52 ou versão mais recente

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

Notifica um dispositivo remoto sobre um novo valor para uma característica. Se a flag shouldIndique no objeto de notificação for verdadeira, uma indicação será enviada em vez de uma notificação. Observe que a característica precisa definir corretamente a "notificação" ou "indicar" durante a criação dessa chamada. Essa função só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• characteristicId

  string

  A característica para a qual enviar a notificação.

• notificação

  Notificação

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

readCharacteristicValue()

Promessa

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

Recupera o valor de uma característica especificada de um periférico remoto.

Parâmetros

• characteristicId

  string

  O ID da instância da característica GATT cujo valor deve ser lido no dispositivo remoto.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (result: Characteristic) => void

  • resultado

    Característica

Retorna

• Promessa<Characteristic>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

readDescriptorValue()

Promessa

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

Recupera o valor de um descritor de característica especificado de um periférico remoto.

Parâmetros

• descriptorId

  string

  O ID da instância do descritor de característica GATT cujo valor deve ser lido no dispositivo remoto.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (result: Descriptor) => void

  • resultado

    Descritor

Retorna

• Promise&lt;Descriptor&gt;

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

registerAdvertisement()

Promessa Chrome 47 ou superior

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

Criar um anúncio e registrá-lo para publicidade. Para chamar essa função, o app precisa ter as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. Além disso, essa API só está disponível para aplicativos iniciados automaticamente no modo quiosque ou ao configurar "--enable-ble-advertising-in-apps" comutador de linha de comando. Consulte https://developer.chrome.com/apps/manifest/bluetooth Observação: em alguns hardwares, os modos central e de periféricos são compatíveis ao mesmo tempo, mas em hardwares que não permitem isso, essa chamada vai mudar o dispositivo para o modo periférico. No caso de hardware que não suporta os modos central e periférico, tentar usar o dispositivo em ambos os modos levará a um comportamento indefinido ou impedirá que outros aplicativos de função central se comportem corretamente (incluindo a descoberta de dispositivos Bluetooth de baixa energia).

Parâmetros

• publicidade

  Publicidade

  O anúncio a ser anunciado.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (advertisementId: number) => void

  • advertisementId

    number

Retorna

• Promise&lt;number&gt;

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

registerService()

Promessa Chrome 52 ou versão mais recente

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

Registra o serviço fornecido no servidor GATT local. Se o ID do serviço for inválido, o lastError será definido. Essa função só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• serviceId

  string

  ID exclusivo de um serviço criado.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeService()

Promessa Chrome 52 ou versão mais recente

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

Remova o serviço especificado, cancelando o registro caso tenha sido registrado. Se o ID do serviço for inválido, o lastError será definido. Essa função só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• serviceId

  string

  ID exclusivo de um serviço atualmente registrado.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

resetAdvertising()

Promessa Chrome 61 ou versões mais recentes

chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Redefine a publicidade no dispositivo atual. Ele cancelará o registro e interromperá todos os anúncios existentes.

Parâmetros

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

sendRequestResponse()

Chrome 52 ou superior

chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

Envia uma resposta para uma solicitação de leitura/gravação de característica ou descritor. Essa função só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• resposta

  Resposta

  A resposta à solicitação.

setAdvertisingInterval()

Promessa Chrome 55 ou versão mais recente

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

É o intervalo entre duas divulgações consecutivas. Observação: isso é o máximo possível. O intervalo real pode não ser muito diferente dos intervalos solicitados. Em alguns hardwares, há um intervalo mínimo de 100 ms. Os valores mínimo e máximo não podem ultrapassar o alcance permitido pela especificação do Bluetooth 4.2.

Parâmetros

• minInterval

  number

  Intervalo mínimo entre anúncios (em milissegundos). Esse limite não pode ser inferior a 20 ms (de acordo com a especificação).

• maxInterval

  number

  Intervalo máximo entre anúncios (em milissegundos). Isso não pode ser maior que 10.240 ms (de acordo com a especificação).

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

startCharacteristicNotifications()

Promessa

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

Ativa notificações/indicações de valor da característica especificada. Depois de ativada, um aplicativo pode detectar notificações usando o evento onCharacteristicValueChanged.

Parâmetros

• characteristicId

  string

  O ID da instância da característica GATT em que as notificações precisam ser ativadas.

• properties

  NotificationProperties opcional

  Propriedades da sessão de notificação (opcional).

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

stopCharacteristicNotifications()

Promessa

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

Desativar notificações/indicações de valor da característica especificada. Após uma chamada bem-sucedida, o aplicativo deixará de receber notificações/indicações dessa característica.

Parâmetros

• characteristicId

  string

  O ID da instância da característica GATT em que a sessão de notificação desse app precisa ser interrompida.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

unregisterAdvertisement()

Promessa Chrome 47 ou superior

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

Cancela o registro de um anúncio e interrompe sua publicidade. Caso o anúncio não seja registrado, a única maneira de interromper a publicidade talvez seja reiniciar o dispositivo.

Parâmetros

• advertisementId

  number

  ID do anúncio a ser cancelado.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

unregisterService()

Promessa Chrome 52 ou versão mais recente

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

Cancelar o registro do serviço fornecido no servidor GATT local. Se o ID do serviço for inválido, o lastError será definido. Essa função só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• serviceId

  string

  ID exclusivo de um serviço atualmente registrado.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

writeCharacteristicValue()

Promessa

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

Gravar o valor de uma característica especificada de um periférico remoto.

Parâmetros

• characteristicId

  string

  O ID da instância da característica GATT em que o valor será gravado.

• valor

  Buffer de matriz

  O valor que deve ser enviado à característica remota como parte da solicitação de gravação.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

writeDescriptorValue()

Promessa

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

Gravar o valor de um descritor de característica específico de um periférico remoto.

Parâmetros

• descriptorId

  string

  O ID da instância do descritor de característica GATT em que o valor será gravado.

• valor

  Buffer de matriz

  O valor que deve ser enviado ao descritor remoto como parte da solicitação de gravação.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Retorna

• Promessa<void>

  Chrome 91 ou versões mais recentes

  As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onCharacteristicReadRequest

Chrome 52 ou superior

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

Disparado quando um dispositivo central conectado solicita a leitura do valor de uma característica registrada no servidor GATT local. Não responder a essa solicitação por muito tempo pode levar a uma desconexão. Esse evento só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

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

  • solicitação

    Solicitação

  • characteristicId

    string

onCharacteristicValueChanged

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

Disparado quando o valor de uma característica GATT remota muda como resultado de uma solicitação de leitura ou de uma notificação/indicação de alteração de valor. Esse evento só será enviado se o aplicativo tiver ativado as notificações chamando startCharacteristicNotifications.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (characteristic: Characteristic) => void

  • característica

    Característica

onCharacteristicWriteRequest

Chrome 52 ou superior

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

Disparado quando um dispositivo central conectado solicita a gravação do valor de uma característica registrada no servidor GATT local. Não responder a essa solicitação por muito tempo pode levar a uma desconexão. Esse evento só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

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

  • solicitação

    Solicitação

  • characteristicId

    string

onDescriptorReadRequest

Chrome 52 ou superior

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

Disparado quando um dispositivo central conectado solicita a leitura do valor de um descritor registrado no servidor GATT local. Não responder a essa solicitação por muito tempo pode levar a uma desconexão. Esse evento só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

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

  • solicitação

    Solicitação

  • descriptorId

    string

onDescriptorValueChanged

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

Disparado quando o valor de um descritor de característica GATT remoto é alterado, geralmente como resultado de uma solicitação de leitura. Esse evento existe principalmente para conveniência e sempre será enviado após uma chamada bem-sucedida para readDescriptorValue.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (descriptor: Descriptor) => void

  • descritor

    Descritor

onDescriptorWriteRequest

Chrome 52 ou superior

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

Disparado quando um dispositivo central conectado solicita a gravação do valor de um descritor registrado no servidor GATT local. Não responder a essa solicitação por muito tempo pode levar a uma desconexão. Esse evento só estará disponível se o app tiver as permissões bluetooth:low_energy e bluetooth:peripheral definidas como verdadeiras. A permissão de periféricos pode não estar disponível para todos os apps.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

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

  • solicitação

    Solicitação

  • descriptorId

    string

onServiceAdded

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

Disparado quando um novo serviço GATT é descoberto em um dispositivo remoto.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (service: Service) => void

  • serviço

    Serviço

onServiceChanged

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

Disparado quando o estado de um serviço GATT remoto é alterado. Isso envolve quaisquer características e/ou descritores que são adicionados ou removidos do serviço, assim como "ServiceChanged" notificações do dispositivo remoto.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (service: Service) => void

  • serviço

    Serviço

onServiceRemoved

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

Disparado quando um serviço GATT descoberto anteriormente em um dispositivo remoto é removido.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (service: Service) => void

  • serviço

    Serviço