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 o uso dessa 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ços" 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 estar nos formatos 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 estar nos formatos de 16, 32 ou 128 bits.

  • É o tipo de publicidade.

AdvertisementType

Chrome 47 ou mais recente

É o tipo de publicidade. Se "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 definido como "periférico", o tipo de anúncio será ADV_IND ou ADV_SCAN_IND e o dispositivo será transmitido com o endereço MAC real do adaptador Bluetooth.

Tipo enumerado

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 tenham um identificador de características. Presente, se essa instância representa 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 de 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 propriedades possíveis de uma característica. As permissões de características são inferidas a partir dessas propriedades. Consulte as especificações do Bluetooth 4.x para entender o significado de cada propriedade.

Tipo enumerado

"writeWithoutResponse"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Propriedades

  • permanentes

    boolean

    Sinalização que indica se uma conexão com o dispositivo foi deixada em aberto 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 à qual este 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 tenham um identificador de descritor. Presente, se essa instância representa 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ísticas, por exemplo, 00002902-0000-1000-8000-00805f9b34fb.

  • valor

    ArrayBuffer opcional

    O valor do descritor em cache atualmente. 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 as especificações do Bluetooth 4.x para entender o significado de cada permissão individual.

Tipo enumerado

"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

    número opcional

    A classe do dispositivo, um bit-field definido por http://www.bluetooth.org/en-us/specified/attribution-numbers/baseband.

  • name

    string opcional

    O nome legível do dispositivo.

ManufacturerData

Chrome 47 ou mais recente

Propriedades

  • dados

    Número[]

  • id

    number

Notification

Chrome 52 ou mais recente

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

  • permanentes

    boolean

    Sinalização que indica se o app vai receber notificações quando a página de eventos 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 envia a solicitação.

  • requestId

    number

    ID exclusivo desta solicitação. Use esse ID ao responder a essa 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

    boolean

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

  • requestId

    number

    ID da solicitação à qual esta é 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 a que o serviço GATT pertence. Presente, se a 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 diferenciar serviços de um periférico com o mesmo UUID e fazer chamadas de função que tenham um identificador de serviço. Presente, se a instância representar um serviço remoto.

  • isPrimary

    boolean

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

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 especificado. Um dispositivo pode já estar conectado e os serviços GATT dele estão 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 a 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 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 optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

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

createCharacteristic()

Promessa Chrome 52 ou mais recente 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

Criar uma característica do 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 true. A permissão do 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 o qual criar essa característica.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (characteristicId: string)=>void

    • characteristicId

      string

Retorna

  • Promessa<string>

    Chrome 91 ou mais recente

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

createDescriptor()

Promessa Chrome 52 ou mais recente 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

Criar 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, 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 do periférico 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 criar esse descritor.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (descriptorId: string)=>void

    • descriptorId

      string

Retorna

  • Promessa<string>

    Chrome 91 ou mais recente

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

createService()

Promessa Chrome 52 ou mais recente 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

Crie um serviço GATT hospedado localmente. Esse serviço pode ser registrado para estar 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 do 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 optional

    O parâmetro callback tem esta aparência: 

    (serviceId: string)=>void

    • serviceId

      string

Retorna

  • Promessa<string>

    Chrome 91 ou mais recente

    Promessas são compatíveis apenas com o Manifest 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 com o dispositivo com o endereço fornecido. Isso nem sempre destruirá o link físico em si, 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 tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

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

getCharacteristic()

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

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

Parâmetros

  • characteristicId

    string

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

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (result: Characteristic)=>void

Retorna

  • Promise<Characteristic>

    Chrome 91 ou mais recente

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

getCharacteristics()

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

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

Parâmetros

  • serviceId

    string

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

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (result: Characteristic[])=>void

Retorna

  • Promise<Characteristic[]>

    Chrome 91 ou mais recente

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

getDescriptor()

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

Extrai o descritor de características GATT com o ID de instância fornecido.

Parâmetros

  • descriptorId

    string

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

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (result: Descriptor)=>void

Retorna

  • Promise<Descriptor>

    Chrome 91 ou mais recente

    Promessas são compatíveis apenas com o Manifest 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í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 optional

    O parâmetro callback tem esta aparência: 

    (result: Descriptor[])=>void

Retorna

  • Promise<Descriptor[]>

    Chrome 91 ou mais recente

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

getIncludedServices()

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

Acesse uma lista dos 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 precisam ser retornados.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (result: Service[])=>void

Retorna

  • Prometer<Serviço[]>

    Chrome 91 ou mais recente

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

getService()

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

Consiga o serviço GATT com o ID da 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 tem esta aparência: 

    (result: Service)=>void

Retorna

  • Prometer<Serviço>

    Chrome 91 ou mais recente

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

getServices()

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

Acesse todos os serviços GATT 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 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 optional

    O parâmetro callback tem esta aparência: 

    (result: Service[])=>void

Retorna

  • Prometer<Serviço[]>

    Chrome 91 ou mais recente

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

notifyCharacteristicValueChanged()

Promessa Chrome 52 ou 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 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 do periférico 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 optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

    Promessas são compatíveis apenas com o Manifest 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 optional

    O parâmetro callback tem esta aparência: 

    (result: Characteristic)=>void

Retorna

  • Promise<Characteristic>

    Chrome 91 ou mais recente

    Promessas são compatíveis apenas com o Manifest 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ísticas especificado de um periférico remoto.

Parâmetros

  • descriptorId

    string

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

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (result: Descriptor)=>void

Retorna

  • Promise<Descriptor>

    Chrome 91 ou mais recente

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

registerAdvertisement()

Promessa Chrome 47+ 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Criar um anúncio e registrá-lo para fins de 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 aplicativos iniciados automaticamente no modo quiosque ou pela configuração da chave da linha de comando "--enable-ble-advertising-in-apps". Consulte https://developer.chrome.com/apps/manifest/Bluetooth Observação: em alguns modos de hardware, central e periférico ao mesmo tempo, há suporte, mas em hardwares que não têm suporte, essa chamada coloca o dispositivo no modo periférico. No caso de um hardware que não oferece suporte aos modos central e periférico, a tentativa de usar o dispositivo nos dois modos causa um comportamento indefinido ou impede que outros aplicativos com 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 optional

    O parâmetro callback tem esta aparência: 

    (advertisementId: number)=>void

    • advertisementId

      number

Retorna

  • Prometer<número>

    Chrome 91 ou mais recente

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

registerService()

Promessa Chrome 52 ou mais recente 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

Registre 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 true. A permissão do 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 optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

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

removeService()

Promessa Chrome 52 ou mais recente 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Remove 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 true. A permissão do periférico pode não estar disponível para todos os apps.

Parâmetros

  • serviceId

    string

    ID exclusivo de um serviço registrado atualmente.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

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

resetAdvertising()

Promessa Chrome 61 ou mais recente 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Redefine a publicidade no dispositivo atual. Isso cancelará a inscrição e interromperá todos os anúncios existentes.

Parâmetros

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

    Promessas são compatíveis apenas 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,
)

Envia uma resposta para uma solicitação de leitura/gravação de característica ou de 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 do periférico pode não estar disponível para todos os apps.

Parâmetros

  • resposta

    Resposta

    A resposta à solicitação.

setAdvertisingInterval()

Promessa Chrome 55+ 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

Define o intervalo entre dois anúncios consecutivos. Observação: isso é tudo o que você precisa. O intervalo real pode variar não trivialmente 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

    number

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

  • maxInterval

    number

    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 tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

    Promessas são compatíveis apenas 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,
)

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

Parâmetros

  • characteristicId

    string

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

  • properties

    NotificationProperties opcional

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

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

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

stopCharacteristicNotifications()

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

Desativa 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 do GATT em que a sessão de notificação desse app deve ser interrompida.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

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

unregisterAdvertisement()

Promessa Chrome 47+ 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

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 é reiniciar o dispositivo.

Parâmetros

  • advertisementId

    number

    ID do anúncio a ser cancelado.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

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

unregisterService()

Promessa Chrome 52 ou mais recente 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

Cancele o registro do serviço fornecido 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 do periférico pode não estar disponível para todos os apps.

Parâmetros

  • serviceId

    string

    ID exclusivo de um serviço registrado atualmente.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

    Promessas são compatíveis apenas 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,
)

Grave o valor de uma característica específica de um periférico remoto.

Parâmetros

  • characteristicId

    string

    O ID da instância da característica GATT cujo valor deve ser gravado.

  • valor

    ArrayBuffer

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

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

    Promessas são compatíveis apenas 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,
)

Escreve o valor de um descritor de características especificado de um periférico remoto.

Parâmetros

  • descriptorId

    string

    O ID da instância do descritor de características GATT cujo valor deve ser gravado.

  • valor

    ArrayBuffer

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

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 91 ou mais recente

    Promessas são compatíveis apenas 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. Deixar de responder a esta solicitação por muito tempo pode levar à 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 do 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 remota do GATT muda, 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 a gravação do valor de uma característica registrada no servidor GATT local. Deixar de responder a esta solicitação por muito tempo pode levar à 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 do 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. Deixar de responder a esta solicitação por muito tempo pode levar à 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 do 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ísticas GATT remoto é alterado, geralmente como resultado de uma solicitação de leitura. Esse evento existe principalmente para conveniência e sempre é 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 a gravação do valor de um descritor registrado no servidor GATT local. Deixar de responder a esta solicitação por muito tempo pode levar à 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 do 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 foi 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 é alterado. Isso envolve quaisquer características e/ou descritores que sejam 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 foi removido.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (service: Service)=>void