chrome.bluetooth

Descrição

Use a API chrome.bluetooth para se conectar a um dispositivo Bluetooth. Todas as funções informam falhas por meio do chrome.runtime.lastError.

Manifesto

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

"bluetooth"

Tipos

AdapterState

Propriedades

  • endereço

    string

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

  • disponível

    booleano

    Indica se o adaptador está disponível (ou seja, ativado).

  • descobrir

    booleano

    Indica se o adaptador está detectando ou não.

  • nome

    string

    O nome legível do adaptador.

  • alimentado

    booleano

    Indica se o adaptador tem energia ou não.

BluetoothFilter

Chrome 67 ou superior

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 Bluetooth para retorno. O padrão é 0 (sem limite) quando não é 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 superior

    A bateria restante do dispositivo.

  • conectável

    booleano opcional

    Chrome 48 ou superior

    Indica se o dispositivo pode ser conectado.

  • conectado

    booleano opcional

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

  • contato

    booleano opcional

    Chrome 48 ou superior

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

  • deviceClass

    número opcional

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

  • deviceId

    número opcional

  • inquiryRssi

    número opcional

    Chrome 44 ou superior

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

  • inquiryTxPower

    número opcional

    Chrome 44 ou superior

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

  • nome

    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 versão mais recente

    O tipo de transporte do dispositivo Bluetooth.

  • tipo

    DeviceType opcional

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

  • uuids

    string[] opcional

    UUIDs de protocolos, perfis e serviços divulgados pelo dispositivo. Para dispositivos Bluetooth clássicos, essa lista é obtida de dados EIR e tabelas SDP. Para dispositivos de baixa energia, essa lista é obtida dos serviços principais do AD e GATT. Para dispositivos de modo dual, ele pode ser obtido de 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.

Enumeração

"computador"

"telefone"

"modem"

"áudio"

"carAudio"

"vídeo"

"periférico"

"joystick"

"gamepad"

"teclado"

"mouse"

"tablet"

"TecladoMouseCombo"

FilterType

Chrome 67 ou superior

Tipos para filtrar dispositivos Bluetooth.

Enumeração

"todos"

"conhecidos"

Transport

Chrome 76 ou versão mais recente

Tipo de transporte do dispositivo Bluetooth.

Enumeração

"inválido"

"clássico"

"le"

"dual"

VendorIdSource

Autoridades de alocação para IDs de fornecedores.

Enumeração

"Bluetooth"

"usb"

Métodos

getAdapterState()

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

Veja informações sobre o adaptador Bluetooth.

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Objeto que contém as informações do adaptador.

Retorna

  • Promise<AdapterState>

    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.

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 opcional

    O parâmetro callback tem esta aparência: 

    (deviceInfo: Device) => void

    • deviceInfo

      Dispositivo

      Objeto que contém as informações do dispositivo.

Retorna

  • Promise<Device>

    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.

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

  • filtro

    BluetoothFilter opcional

    Chrome 67 ou superior

    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 retornados vai conter todos os dispositivos Bluetooth. No momento, isso só é compatível com o ChromeOS. Para outras plataformas, uma lista completa será retornada.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Dispositivo[]

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

Retorna

  • Promessa<Dispositivo[]>

    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.

startDiscovery()

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

Inicie a descoberta. Os dispositivos recém-descobertos serão retornados pelo evento onDeviceAdded. Dispositivos descobertos anteriormente que já são conhecidos pelo adaptador precisam ser acessados 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 este aplicativo já tiver chamado startDiscovery. A descoberta pode consumir muitos recursos: stopDiscovery deve ser chamado o mais rápido possível.

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.

stopDiscovery()

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

Interromper descoberta.

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.

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