chrome.bluetoothLowEnergy

Descrição

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

Disponibilidade

Somente no ChromeOS

Manifesto

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

"bluetooth"

Tipos

Advertisement

Chrome 47+

Propriedades

  • manufacturerData

    ManufacturerData[] opcional

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

  • serviceData

    ServiceData[] opcional

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

  • serviceUuids

    string[] opcional

    Lista de UUIDs a serem incluídos no campo "UUIDs de serviço" dos dados de publicidade. Esses UUIDs podem ser de 16, 32 ou 128 bits.

  • solicitUuids

    string[] opcional

    Lista de UUIDs a serem incluídos no campo "Solicitar UUIDs" dos dados de publicidade. Esses UUIDs podem ser de 16, 32 ou 128 bits.

  • Tipo de anúncio.

AdvertisementType

Chrome 47+

Tipo de anúncio. Se "broadcast" for escolhido, o tipo de anúncio enviado será ADV_NONCONN_IND, e o dispositivo vai transmitir com um endereço MAC aleatório. Se definido como "peripheral", o tipo de anúncio será ADV_IND ou ADV_SCAN_IND, e o dispositivo vai transmitir com o endereço MAC real do adaptador Bluetooth.

Enumeração

"broadcast"

"peripheral"

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 fazer chamadas de função que usam um identificador de característica. Presente, se essa instância representar uma característica remota.

  • propriedades

    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 armazenado em cache no momento. Esse valor é atualizado quando o valor da característica é lido ou atualizado por 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 dessas propriedades. Consulte a especificação do Bluetooth 4.x para saber o significado de cada propriedade individual.

Enumeração

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Propriedades

  • permanente

    booleano

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

Descriptor

Propriedades

  • characteristic

    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 fazer chamadas de função que usam um identificador de descritor. Presente, se essa instância representar uma característica remota.

  • permissões

    DescriptorPermission[]

    Chrome 52+

    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+

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

Enumeração

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52+

Propriedades

  • endereço

    string

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

  • deviceClass

    número optional

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

  • nome

    string opcional

    O nome legível por humanos do dispositivo.

ManufacturerData

Chrome 47+

Propriedades

  • dados

    number[]

  • ID

    número

Notification

Chrome 52+

Propriedades

  • shouldIndicate

    booleano opcional

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

  • valor

    ArrayBuffer

    Novo valor da característica.

NotificationProperties

Propriedades

  • permanente

    booleano

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

Request

Chrome 52+

Propriedades

  • dispositivo

    Dispositivo

    Dispositivo que enviou a solicitação.

  • requestId

    número

    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+

Propriedades

  • isError

    booleano

    Se for uma resposta de erro, o valor será verdadeiro.

  • requestId

    número

    ID da solicitação a que se refere a resposta.

  • valor

    ArrayBuffer opcional

    Valor da resposta. As solicitações de gravação e as respostas de erro vão ignorar 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 essa instância representar um serviço remoto.

  • instanceId

    string opcional

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

  • isPrimary

    booleano

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

  • uuid

    string

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

ServiceData

Chrome 47+

Propriedades

  • dados

    number[]

  • uuid

    string

Métodos

connect()

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

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 uma conexão com o dispositivo seja mantida. Se o dispositivo não estiver conectado, todos os serviços GATT dele serão descobertos após uma chamada bem-sucedida para connect.

Parâmetros

  • deviceAddress

    string

    O endereço Bluetooth do dispositivo remoto em que uma conexão GATT precisa ser aberta.

  • propriedades

    ConnectProperties opcional

    Propriedades da conexão (opcional).

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

createCharacteristic()

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

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, o lastError será definido. Essa função só vai 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

  • characteristic

    Característica

    A característica a ser criada.

  • serviceId

    string

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

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (characteristicId: string) => void

    • characteristicId

      string

Retorna

  • Promise<string>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

createDescriptor()

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

Cria um descritor GATT hospedado localmente. Esse descritor precisa ser 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ó vai 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

    O descritor a ser criado.

  • characteristicId

    string

    ID da característica para a qual o descritor será criado.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (descriptorId: string) => void

    • descriptorId

      string

Retorna

  • Promise<string>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

createService()

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

Criar 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 optional

    O parâmetro callback é semelhante a: 

    (serviceId: string) => void

    • serviceId

      string

Retorna

  • Promise<string>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

disconnect()

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

Fecha a conexão do app com o dispositivo que tem o endereço fornecido. Isso nem sempre destrói o 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 optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getCharacteristic()

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

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

Parâmetros

  • characteristicId

    string

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

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (result: Characteristic) => void

Retorna

  • Promise<Characteristic>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getCharacteristics()

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

Recebe 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 que tem as características que serão retornadas.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (result: Characteristic[]) => void

Retorna

  • Promise<Characteristic[]>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getDescriptor()

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

Recebe o descritor de característica do 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 optional

    O parâmetro callback é semelhante a: 

    (result: Descriptor) => void

Retorna

  • Promise<Descriptor>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getDescriptors()

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

Recebe uma lista de descritores de características GATT que pertencem à característica fornecida.

Parâmetros

  • characteristicId

    string

    O ID da instância da característica GATT que tem os descritores que serão retornados.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (result: Descriptor[]) => void

Retorna

  • Promise<Descriptor[]>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getIncludedServices()

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

Recebe 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 que tem os serviços incluídos que serão retornados.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (result: Service[]) => void

Retorna

  • Promise<Service[]>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getService()

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

Recebe 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 optional

    O parâmetro callback é semelhante a: 

    (result: Service) => void

Retorna

  • Promise<Service>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getServices()

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

Receba todos os serviços GATT que foram descobertos no dispositivo remoto com o endereço de dispositivo fornecido.

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

Parâmetros

  • deviceAddress

    string

    O endereço Bluetooth do dispositivo remoto com os serviços GATT que serão retornados.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (result: Service[]) => void

Retorna

  • Promise<Service[]>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

notifyCharacteristicValueChanged()

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

Notifica um dispositivo remoto sobre um novo valor para uma característica. Se a flag shouldIndicate no objeto de notificação for verdadeira, uma indicação será enviada em vez de uma notificação. A característica precisa definir corretamente a propriedade "notify" ou "indicate" durante a criação para que essa chamada seja bem-sucedida. Essa função só vai 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 a notificação será enviada.

  • notificação

    Notificação

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

readCharacteristicValue()

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

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 que tem o valor que será lido do dispositivo remoto.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (result: Characteristic) => void

Retorna

  • Promise<Characteristic>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

readDescriptorValue()

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

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 do GATT cujo valor deve ser lido no dispositivo remoto.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (result: Descriptor) => void

Retorna

  • Promise<Descriptor>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

registerAdvertisement()

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

Crie um anúncio e registre-o para publicidade. Para chamar essa função, o app precisa ter as permissões bluetooth:low_energy e bluetooth:peripheral definidas como true. Além disso, essa API só está disponível para apps iniciados automaticamente no modo quiosque ou definindo a chave de linha de comando "--enable-ble-advertising-in-apps". Consulte https://developer.chrome.com/apps/manifest/bluetooth. Observação: em alguns hardwares, os modos central e periférico são compatíveis ao mesmo tempo, mas em hardwares que não são compatíveis, essa chamada vai mudar o dispositivo para o modo periférico. No caso de hardware que não oferece suporte aos modos central e periférico, tentar usar o dispositivo em ambos os modos vai 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

    Anúncio

    O anúncio a ser divulgado.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (advertisementId: number) => void

    • advertisementId

      número

Retorna

  • Promise<number>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

registerService()

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

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 optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeService()

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

Remover o serviço especificado, cancelando o registro dele, se houver. 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 registrado no momento.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

resetAdvertising()

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

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

Parâmetros

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

sendRequestResponse()

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

Envia uma resposta para uma solicitação de leitura/gravação de característica ou descritor. Essa função só vai 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()

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

Define o intervalo entre dois anúncios consecutivos. Observação: essa é uma tentativa de melhor esforço. O intervalo real pode variar de forma não trivial em relação aos intervalos solicitados. Em alguns hardwares, há um intervalo mínimo de 100 ms. Os valores mínimo e máximo não podem exceder o intervalo permitido pela especificação do Bluetooth 4.2.

Parâmetros

  • minInterval

    número

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

  • maxInterval

    número

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

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

startCharacteristicNotifications()

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

Ativa notificações/indicações de valor da característica especificada. Depois de ativado, 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.

  • propriedades

    NotificationProperties opcional

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

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

stopCharacteristicNotifications()

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

Desativa as notificações/indicações de valor da característica especificada. Após uma chamada bem-sucedida, o aplicativo vai parar 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 do app precisa ser interrompida.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

unregisterAdvertisement()

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

Cancela o registro de um anúncio e interrompe a publicidade dele. Se o anúncio não cancelar o registro, a única maneira de interromper a publicidade pode ser reiniciar o dispositivo.

Parâmetros

  • advertisementId

    número

    ID do anúncio a ser cancelado.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

unregisterService()

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

Cancela 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 registrado no momento.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

writeCharacteristicValue()

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

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

Parâmetros

  • characteristicId

    string

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

  • valor

    ArrayBuffer

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

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

writeDescriptorValue()

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

Grava 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 do GATT em que o valor será gravado.

  • valor

    ArrayBuffer

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

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onCharacteristicReadRequest

Chrome 52+ 
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. Se você não responder a essa solicitação por muito tempo, a conexão poderá ser encerrada. Esse evento só vai 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 é semelhante a: 

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

onCharacteristicValueChanged

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

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

Parâmetros

onCharacteristicWriteRequest

Chrome 52+ 
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. Se você não responder a essa solicitação por muito tempo, a conexão poderá ser encerrada. Esse evento só vai 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 é semelhante a: 

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

onDescriptorReadRequest

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

Acionado quando um dispositivo central conectado solicita a leitura do valor de um descritor registrado no servidor GATT local. Se você não responder a essa solicitação por muito tempo, a conexão poderá ser encerrada. Esse evento só vai 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 é semelhante a: 

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

onDescriptorValueChanged

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

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

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

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

Acionado quando um dispositivo central conectado solicita a gravação do valor de um descritor registrado no servidor GATT local. Se você não responder a essa solicitação por muito tempo, a conexão poderá ser encerrada. Esse evento só vai 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 é semelhante a: 

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

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 é semelhante a: 

    (service: Service) => void

onServiceChanged

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

Acionado quando o estado de um serviço GATT remoto muda. Isso envolve todas as características e/ou descritores adicionados ou removidos do serviço, bem como as notificações "ServiceChanged" do dispositivo remoto.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (service: Service) => void

onServiceRemoved

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

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

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (service: Service) => void