chrome.bluetooth

Descrição

Use a API chrome.bluetooth para se conectar a um dispositivo Bluetooth. Todas as funções relatam falhas via chrome.runtime.lastError.

Manifesto

As chaves a seguir precisam ser declaradas no manifesto para o uso dessa API.

"bluetooth"

Tipos

AdapterState

Propriedades

  • endereço

    string

    O endereço do adaptador no formato "XX:XX:XX:XX:XX:XX".

  • disponível

    boolean

    Indica se o adaptador está disponível ou não (ativado).

  • descobrindo

    boolean

    Indica se o adaptador está sendo descoberto ou não no momento.

  • name

    string

    Nome legível do adaptador.

  • tecnologia

    boolean

    Indica se o adaptador está conectado a uma fonte de energia.

BluetoothFilter

Chrome 67 ou mais recente

Propriedades

  • filterType

    FilterType opcional

    Tipo de filtro a ser aplicado à lista de dispositivos. O padrão é tudo.

  • limite

    número opcional

    Número máximo de dispositivos bluetoth a serem retornados. O padrão será 0 (sem limite) se não for especificado.

Device

Propriedades

  • endereço

    string

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

  • batteryPercentage

    número opcional

    Chrome 77 ou mais recente

    Bateria restante do dispositivo.

  • conectável

    booleano opcional

    Chrome 48 ou mais recente

    Indica se o dispositivo pode ser conectado.

  • conectado

    booleano opcional

    Indica se o dispositivo está conectado ao sistema no momento.

  • com conexões

    booleano opcional

    Chrome 48 ou mais recente

    Indica se o dispositivo está se conectando ao sistema no momento.

  • deviceClass

    número opcional

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

  • deviceId

    número opcional

  • inquiryRssi

    número opcional

    Chrome 44 ou mais recente

    A intensidade do sinal recebido, em dBm. Este campo está disponível e é válido apenas durante a descoberta. Fora da descoberta, o valor não é especificado.

  • inquiryTxPower

    número opcional

    Chrome 44 ou mais recente

    O nível de potência transmitido. Este campo está disponível apenas para dispositivos LE que incluem esse campo no AD. Ele está disponível e é válido apenas durante a descoberta.

  • name

    string opcional

    O nome legível do dispositivo.

  • pareado

    booleano opcional

    Indica se o dispositivo está pareado com o sistema.

  • productId

    número opcional

  • transport

    Transporte opcional

    Chrome 76 ou mais recente

    O tipo de transporte do dispositivo Bluetooth.

  • digitar

    DeviceType opcional

    O tipo do dispositivo, se reconhecido pelo Chrome. Esse valor é extraído do campo deviceClass e representa apenas uma pequena fração dos tipos de dispositivos possíveis. Em caso de dúvida, use o campo deviceClass diretamente.

  • uuids

    string[] opcional

    UUIDs de protocolos, perfis e serviços anunciados pelo dispositivo. Para dispositivos Bluetooth clássico, essa lista é obtida de dados EIR e tabelas SDP. Para dispositivos de baixa energia, essa lista é extraída dos serviços principais do AD e do GATT. Para dispositivos de modo duplo, isso pode ser obtido em ambos.

  • vendorId

    número opcional

  • vendorIdSource

    VendorIdSource opcional

    O registro do ID do dispositivo, quando disponível.

DeviceType

Tipos de dispositivos comuns reconhecidos pelo Chrome.

Tipo enumerado

"modem"

"carAudio"

"joystick"

"gamepad"

"mouse"

"tablet"

FilterType

Chrome 67 ou mais recente

Tipos para filtrar dispositivos Bluetooth.

Tipo enumerado

Transport

Chrome 76 ou mais recente

Tipo de transporte do dispositivo Bluetooth.

Tipo enumerado

"le"

"dual"

VendorIdSource

Autoridades de alocação para IDs de fornecedores.

Tipo enumerado

"usb"

Métodos

getAdapterState()

Promessa 
chrome.bluetooth.getAdapterState(
  callback?: function,
)

Saiba mais sobre o adaptador Bluetooth.

Parâmetros

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (adapterInfo: AdapterState)=>void

    • adapterInfo

      AdapterState

      Objeto contendo as informações do adaptador.

Retorna

  • Promise<AdapterState>

    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.

getDevice()

Promessa 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
)

Receba informações sobre um dispositivo Bluetooth conhecido pelo sistema.

Parâmetros

  • deviceAddress

    string

    Endereço do dispositivo a ser recebido.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (deviceInfo: Device)=>void

    • deviceInfo

      Dispositivo

      Objeto contendo as informações do dispositivo.

Retorna

  • Prometer<Dispositivo>

    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.

getDevices()

Promessa 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

Receba uma lista de dispositivos Bluetooth conhecidos pelo sistema, incluindo dispositivos pareados e descobertos recentemente.

Parâmetros

  • Função filter

    BluetoothFilter opcional

    Chrome 67 ou mais recente

    Alguns critérios para filtrar a lista de dispositivos Bluetooth retornados. Se o filtro não for definido ou for definido como {}, a lista de dispositivos retornada conterá todos os dispositivos Bluetooth. No momento, só é possível fazer isso no ChromeOS. Para outras plataformas, uma lista completa é retornada.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (deviceInfos: Device[])=>void

    • deviceInfos

      Dispositivo[]

      Matriz de objeto que contém informações do dispositivo.

Retorna

  • Prometer<Dispositivo[]>

    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.

startDiscovery()

Promessa 
chrome.bluetooth.startDiscovery(
  callback?: function,
)

Comece a descoberta. Os dispositivos recém-descobertos serão retornados por meio do evento onDeviceAllowed. Os dispositivos descobertos anteriormente conhecidos pelo adaptador precisam ser recebidos usando getDevices e só serão atualizados usando o evento onDeviceChanged se as informações sobre eles mudarem.

A descoberta não será iniciada se esse aplicativo já tiver chamado startDiscovery. A descoberta pode consumir muitos recursos: o stopDiscovery deve ser chamado o mais rápido possível.

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.

stopDiscovery()

Promessa 
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

Parar descoberta.

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.

Eventos

onAdapterStateChanged

chrome.bluetooth.onAdapterStateChanged.addListener(
  callback: function,
)

Disparado quando o estado do adaptador Bluetooth muda.

Parâmetros

onDeviceAdded

chrome.bluetooth.onDeviceAdded.addListener(
  callback: function,
)

Disparado quando as informações sobre um novo dispositivo Bluetooth estão disponíveis.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (device: Device)=>void

onDeviceChanged

chrome.bluetooth.onDeviceChanged.addListener(
  callback: function,
)

Disparado quando as informações sobre um dispositivo Bluetooth conhecido são alteradas.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (device: Device)=>void

onDeviceRemoved

chrome.bluetooth.onDeviceRemoved.addListener(
  callback: function,
)

Disparado quando um dispositivo Bluetooth descoberto anteriormente ficou fora de alcance por tempo suficiente para ser considerado indisponível novamente e quando um dispositivo pareado é removido.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (device: Device)=>void