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
Tipos
Advertisement
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.
-
digitar
É o tipo de publicidade.
AdvertisementType
É 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
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õesChrome 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
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
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
Propriedades
-
dados
Número[]
-
id
number
Notification
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
Propriedades
-
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
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
Propriedades
-
dados
Número[]
-
uuid
string
Métodos
connect()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
createCharacteristic()
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
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
createDescriptor()
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
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
createService()
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
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
disconnect()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
getCharacteristic()
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
-
resultado
-
Retorna
-
Promise<Characteristic>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
getCharacteristics()
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
-
resultado
-
Retorna
-
Promise<Characteristic[]>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
getDescriptor()
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
-
resultado
-
Retorna
-
Promise<Descriptor>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
getDescriptors()
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
-
resultado
-
Retorna
-
Promise<Descriptor[]>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
getIncludedServices()
chrome.bluetoothLowEnergy.getIncludedServices(
serviceId: string,
callback?: function,
)
Acesse uma lista dos serviços GATT incluídos pelo serviço fornecido.
Parâmetros
Retorna
-
Prometer<Serviço[]>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
getService()
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
-
resultado
-
Retorna
-
Prometer<Serviço>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
getServices()
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
Retorna
-
Prometer<Serviço[]>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
notifyCharacteristicValueChanged()
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
-
callback
função optional
O parâmetro
callback
tem esta aparência:() => void
Retorna
-
Promise<void>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
readCharacteristicValue()
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
-
resultado
-
Retorna
-
Promise<Characteristic>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
readDescriptorValue()
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
-
resultado
-
Retorna
-
Promise<Descriptor>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
registerAdvertisement()
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
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
registerService()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
removeService()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
resetAdvertising()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
sendRequestResponse()
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
A resposta à solicitação.
setAdvertisingInterval()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
startCharacteristicNotifications()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
stopCharacteristicNotifications()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
unregisterAdvertisement()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
unregisterService()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
writeCharacteristicValue()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
writeDescriptorValue()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
Eventos
onCharacteristicReadRequest
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
-
request
-
characteristicId
string
-
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
-
callback
função
O parâmetro
callback
tem esta aparência:(characteristic: Characteristic) => void
-
característica
-
onCharacteristicWriteRequest
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
-
request
-
characteristicId
string
-
onDescriptorReadRequest
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
-
request
-
descriptorId
string
-
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
-
descritor
-
onDescriptorWriteRequest
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
-
request
-
descriptorId
string
-
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
-
serviço
-
onServiceChanged
chrome.bluetoothLowEnergy.onServiceChanged.addListener(
callback: function,
)
Disparado quando o estado de um serviço GATT remoto é alterado. Isso envolve quaisquer características e/ou descritores que 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
-
serviço
-
onServiceRemoved
chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
callback: function,
)
Disparado quando um serviço GATT descoberto anteriormente em um dispositivo remoto foi removido.