chrome.bluetoothLowEnergy

Descrição

A API chrome.bluetoothLowEnergy é usada para se comunicar com dispositivos Bluetooth Smart (baixa energia) usando o Perfil de Atributo Genérico (GATT).

Manifesto

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

"bluetooth"

Tipos

Advertisement

Chrome 47 ou mais recente

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

AdvertisementType

Chrome 47 ou mais recente

Tipo de publicidade. 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 do adaptador Bluetooth real.

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 entre características de um periférico com o mesmo UUID e fazer chamadas de função que recebem um identificador de característica. Presente se esta instância representar uma característica remota.

  • properties

    CharacteristicProperty[]

    As propriedades dessa característica.

  • serviço

    Serviço opcional

    O serviço GATT a que 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 atualmente em cache. 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 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"

"ler"

"writeWithoutResponse"

"write"

"notify"

"indicar"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Propriedades

  • persistente

    booleano

    Flag que indica se uma conexão com o dispositivo fica 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

  • característica

    Característica opcional

    A característica GATT a que este descritor pertence.

  • instanceId

    string opcional

    Retorna o identificador atribuído a este 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 recebem um identificador de descritor. Presente se esta instância representar uma característica remota.

  • permissões

    DescriptorPermission[]

    Chrome 52 ou mais recente

    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 mais recente

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

Enumeração

"ler"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 ou mais recente

Propriedades

  • endereço

    string

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

  • deviceClass

    number 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 do dispositivo.

ManufacturerData

Chrome 47 ou mais recente

Propriedades

  • dados

    number[]

  • ID

    número

Notification

Chrome 52 ou mais recente

Propriedades

  • shouldIndicate

    booleano opcional

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

  • valor

    ArrayBuffer

    Novo valor da característica.

NotificationProperties

Propriedades

  • persistente

    booleano

    Flag que indica se o app vai receber notificações quando a página de eventos do aplicativo for descarregada. Consulte Gerenciar o ciclo de vida do app. O valor padrão é false.

Request

Chrome 52 ou mais recente

Propriedades

  • dispositivo

    Dispositivo

    Dispositivo que enviou esta solicitação.

  • requestId

    número

    ID exclusivo para esta 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 mais recente

Propriedades

  • isError

    booleano

    Se for uma resposta de erro, esse valor será "true".

  • requestId

    número

    ID da solicitação a que esta é uma 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 a que 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 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 de serviço é primário ou secundário.

  • uuid

    string

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

ServiceData

Chrome 47 ou mais recente

Propriedades

  • dados

    number[]

  • uuid

    string

Métodos

connect()

Promise 
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 especificado. Um dispositivo pode já estar conectado e ter os serviços GATT disponíveis sem chamar connect. No entanto, um app que quer 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 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

  • Promise<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 ou mais recente 
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ó estará disponível se o app tiver as permissões "bluetooth:low_energy" e "bluetooth:peripheral" definidas como "true". A permissão de periférico 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 criar essa característica.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (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 ou mais recente 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
): Promise<string>

Crie 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ó estará disponível se o app tiver as permissões "bluetooth:low_energy" e "bluetooth:peripheral" definidas como "true". A permissão de periférico pode não estar disponível para todos os apps.

Parâmetros

  • descritor

    Descriptor

    O descritor a ser criado.

  • characteristicId

    string

    ID da característica para criar este descritor.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (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 ou mais recente 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

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 "true". A permissão de periférico 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

  • 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()

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

Fecha a conexão do app com o dispositivo no endereço especificado. 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 opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<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()

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

Recebe a característica GATT com o ID de instância especificado que pertence ao serviço GATT especificado, 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

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

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

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

Parâmetros

  • serviceId

    string

    O ID da instância do serviço GATT cujas características serão retornadas.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

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

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

Recebe o descritor de característica GATT com o ID da instância especificado.

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

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

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

Receba uma lista de descritores de características GATT que pertencem à característica especificada.

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

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

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

Recebe uma lista de serviços GATT incluídos pelo serviço especificado.

Parâmetros

  • serviceId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

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

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

Recebe o serviço GATT com o ID da instância especificado.

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

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

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

Recebe todos os serviços GATT descobertos no dispositivo remoto com o endereço de dispositivo especificado.

Observação:se a descoberta de serviços 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 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 cujos serviços GATT precisam ser retornados.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (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 ou mais recente 
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ó estará disponível se o app tiver as permissões "bluetooth:low_energy" e "bluetooth:peripheral" definidas como "true". A permissão de periférico pode não estar disponível para todos os apps.

Parâmetros

  • characteristicId

    string

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

  • notificação

    Notificação

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<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()

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

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

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (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 ou mais recente 
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 está disponível apenas para apps iniciados automaticamente no modo quiosque ou definindo a opção 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. No entanto, em hardwares que não oferecem suporte a isso, fazer 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 nos dois modos vai resultar em um comportamento indefinido ou impedir que outros aplicativos de função central funcionem corretamente, incluindo a descoberta de dispositivos Bluetooth de baixa energia.

Parâmetros

  • publicidade

    Publicidade

    O anúncio a ser veiculado.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (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 ou mais recente 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

Registra o serviço especificado com o 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 "true". A permissão de periférico 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

  • Promise<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 ou mais recente 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

Remove o serviço especificado, cancelando o registro dele, se ele tiver 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 "true". A permissão de periférico 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 opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<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()

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

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

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<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 ou mais recente 
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ó estará disponível se o app tiver as permissões "bluetooth:low_energy" e "bluetooth:peripheral" definidas como "true". A permissão de periférico pode não estar disponível para todos os apps.

Parâmetros

  • resposta

    Resposta

    A resposta à solicitação.

setAdvertisingInterval()

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

Define o intervalo entre dois anúncios consecutivos. Observação: isso é feito da melhor forma possível. O intervalo real pode variar de forma não trivial dos 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). 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 mais que 10.240 ms (de acordo com a especificação).

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<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()

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

Ativa as 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.

  • 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

  • Promise<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()

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

Desativa as notificações/indicações de valor da característica especificada. Depois de uma chamada bem-sucedida, o aplicativo para 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 deste app deve ser interrompida.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<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 ou mais recente 
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 for cancelado, a única maneira de interromper a publicidade será reiniciar o dispositivo.

Parâmetros

  • advertisementId

    número

    ID do anúncio a ser cancelado.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<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 ou mais recente 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

Cancela o registro do serviço especificado 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 "true". A permissão de periférico 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 opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<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()

Promise 
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 GATT cujo valor precisa ser gravado.

  • valor

    ArrayBuffer

    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

  • Promise<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()

Promise 
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 GATT cujo valor precisa ser gravado.

  • valor

    ArrayBuffer

    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

  • Promise<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 ou mais recente 
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 "true". A permissão de periférico 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

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 ou mais recente 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Disparado quando um dispositivo central conectado solicita gravar o 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 "true". A permissão de periférico 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

onDescriptorReadRequest

Chrome 52 ou mais recente 
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 "true". A permissão de periférico 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

onDescriptorValueChanged

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

Disparado quando o valor de um descritor de característica GATT remota 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 tem esta aparência: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52 ou mais recente 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Disparado quando um dispositivo central conectado solicita gravar o 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 "true". A permissão de periférico 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

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

onServiceChanged

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

Disparado 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 notificações "ServiceChanged" do dispositivo remoto.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (service: Service) => void

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