chrome.bluetoothLowEnergy

Descrição

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

Manifesto

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

"bluetooth"

Tipos

Advertisement

Chrome 47 ou superior

Propriedades

  • manufacturerData

    ManufacturerData[] opcional

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

  • serviceData

    ServiceData[] opcional

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

  • serviceUuids

    string[] opcional

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

  • solicitUuids

    string[] opcional

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

  • Tipo de anúncio.

AdvertisementType

Chrome 47 ou superior

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

Enumeração

"transmissão"

"periférico"

Characteristic

Propriedades

  • instanceId

    string opcional

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

  • properties

    CharacteristicProperty[]

    As propriedades dessa característica.

  • serviço

    Serviço opcional

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

  • uuid

    string

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

  • valor

    ArrayBuffer opcional

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

CharacteristicProperty

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

Enumeração

"transmissão"

"leitura"

"writeWithoutResponse"

"write"

"notificar"

"indicar"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"Auxiliares graváveis"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Propriedades

  • persistente

    booleano

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

Descriptor

Propriedades

  • característica

    Característica opcional

    A característica GATT a que esse descritor pertence.

  • instanceId

    string opcional

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

  • permissões

    DescriptorPermission[]

    Chrome 52 ou superior

    As permissões desse descritor.

  • uuid

    string

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

  • valor

    ArrayBuffer opcional

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

DescriptorPermission

Chrome 52 ou superior

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

Enumeração

"leitura"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 ou superior

Propriedades

  • endereço

    string

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

  • deviceClass

    número opcional

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

  • nome

    string opcional

    O nome legível do dispositivo.

ManufacturerData

Chrome 47 ou superior

Propriedades

  • dados

    número[]

  • id

    number

Notification

Chrome 52 ou superior

Propriedades

  • shouldIndicate

    booleano opcional

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

  • valor

    Buffer de matriz

    Novo valor da característica.

NotificationProperties

Propriedades

  • persistente

    booleano

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

Request

Chrome 52 ou superior

Propriedades

  • dispositivo

    Dispositivo

    Dispositivo que envia esta solicitação.

  • requestId

    number

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

  • valor

    ArrayBuffer opcional

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

Response

Chrome 52 ou superior

Propriedades

  • isError

    booleano

    Se for uma resposta de erro, deve ser verdadeiro.

  • requestId

    number

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

  • valor

    ArrayBuffer opcional

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

Service

Propriedades

  • deviceAddress

    string opcional

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

  • instanceId

    string opcional

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

  • isPrimary

    booleano

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

  • uuid

    string

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

ServiceData

Chrome 47 ou superior

Propriedades

  • dados

    número[]

  • uuid

    string

Métodos

connect()

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

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

Parâmetros

  • deviceAddress

    string

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

  • properties

    ConnectProperties opcional

    Propriedades da conexão (opcional).

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

createCharacteristic()

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

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

Parâmetros

  • característica

    Característica

    A característica a ser criada.

  • serviceId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (characteristicId: string) => void

    • characteristicId

      string

Retorna

  • Promessa<string>

    Chrome 91 ou versões mais recentes

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

createDescriptor()

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

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

Parâmetros

  • descritor

    Descritor

    Descritor a ser criado.

  • characteristicId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (descriptorId: string) => void

    • descriptorId

      string

Retorna

  • Promessa<string>

    Chrome 91 ou versões mais recentes

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

createService()

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

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

Parâmetros

  • serviço

    Serviço

    O serviço a ser criado.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (serviceId: string) => void

    • serviceId

      string

Retorna

  • Promessa<string>

    Chrome 91 ou versões mais recentes

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

disconnect()

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

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

Parâmetros

  • deviceAddress

    string

    O endereço Bluetooth do dispositivo remoto.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

getCharacteristic()

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

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

Parâmetros

  • characteristicId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: Characteristic) => void

Retorna

  • Promessa<Characteristic>

    Chrome 91 ou versões mais recentes

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

getCharacteristics()

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

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

Parâmetros

  • serviceId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: Characteristic[]) => void

Retorna

  • Promessa<Characteristic[]>

    Chrome 91 ou versões mais recentes

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

getDescriptor()

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

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

Parâmetros

  • descriptorId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: Descriptor) => void

Retorna

  • Promise&lt;Descriptor&gt;

    Chrome 91 ou versões mais recentes

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

getDescriptors()

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

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

Parâmetros

  • characteristicId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: Descriptor[]) => void

Retorna

  • Promise&lt;Descriptor[]&gt;

    Chrome 91 ou versões mais recentes

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

getIncludedServices()

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

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

Parâmetros

  • serviceId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: Service[]) => void

Retorna

  • Promessa <Serviço[]>

    Chrome 91 ou versões mais recentes

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

getService()

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

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

Parâmetros

  • serviceId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: Service) => void

Retorna

  • Promise&lt;Service&gt;

    Chrome 91 ou versões mais recentes

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

getServices()

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

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

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

Parâmetros

  • deviceAddress

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: Service[]) => void

Retorna

  • Promessa <Serviço[]>

    Chrome 91 ou versões mais recentes

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

notifyCharacteristicValueChanged()

Promessa Chrome 52 ou versão mais recente 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

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

Parâmetros

  • characteristicId

    string

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

  • notificação

    Notificação

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

readCharacteristicValue()

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

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

Parâmetros

  • characteristicId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: Characteristic) => void

Retorna

  • Promessa<Characteristic>

    Chrome 91 ou versões mais recentes

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

readDescriptorValue()

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

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

Parâmetros

  • descriptorId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: Descriptor) => void

Retorna

  • Promise&lt;Descriptor&gt;

    Chrome 91 ou versões mais recentes

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

registerAdvertisement()

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

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

Parâmetros

  • publicidade

    Publicidade

    O anúncio a ser anunciado.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (advertisementId: number) => void

    • advertisementId

      number

Retorna

  • Promise&lt;number&gt;

    Chrome 91 ou versões mais recentes

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

registerService()

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

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

Parâmetros

  • serviceId

    string

    ID exclusivo de um serviço criado.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

removeService()

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

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

Parâmetros

  • serviceId

    string

    ID exclusivo de um serviço atualmente registrado.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

resetAdvertising()

Promessa Chrome 61 ou versões mais recentes 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

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

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

sendRequestResponse()

Chrome 52 ou superior 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

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

Parâmetros

  • resposta

    Resposta

    A resposta à solicitação.

setAdvertisingInterval()

Promessa Chrome 55 ou versão mais recente 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

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

Parâmetros

  • minInterval

    number

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

  • maxInterval

    number

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

startCharacteristicNotifications()

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

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

Parâmetros

  • characteristicId

    string

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

  • properties

    NotificationProperties opcional

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

stopCharacteristicNotifications()

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

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

Parâmetros

  • characteristicId

    string

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

unregisterAdvertisement()

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

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

Parâmetros

  • advertisementId

    number

    ID do anúncio a ser cancelado.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

unregisterService()

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

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

Parâmetros

  • serviceId

    string

    ID exclusivo de um serviço atualmente registrado.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

writeCharacteristicValue()

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

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

Parâmetros

  • characteristicId

    string

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

  • valor

    Buffer de matriz

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

writeDescriptorValue()

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

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

Parâmetros

  • descriptorId

    string

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

  • valor

    Buffer de matriz

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 91 ou versões mais recentes

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

Eventos

onCharacteristicReadRequest

Chrome 52 ou superior 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

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

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

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

onCharacteristicValueChanged

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

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

Parâmetros

onCharacteristicWriteRequest

Chrome 52 ou superior 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

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

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

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

onDescriptorReadRequest

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

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

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

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

onDescriptorValueChanged

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

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

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

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

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

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

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

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 é alterado. Isso envolve quaisquer características e/ou descritores que são adicionados ou removidos do serviço, assim como "ServiceChanged" notificações do dispositivo remoto.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (service: Service) => void

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