chrome.bluetooth

Descrição

Use a API chrome.bluetooth para se conectar a um dispositivo Bluetooth. Todas as funções informam falhas usando 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).

  • descobrindo

    booleano

    Indica se o adaptador está fazendo uma descoberta.

  • nome

    string

    O nome legível do adaptador.

  • tecnologia

    booleano

    Indica se o adaptador está conectado à energia.

BluetoothFilter

Chrome 67 ou mais recente

Propriedades

  • filterType

    FilterType opcional

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

  • limite

    number optional

    Número máximo de dispositivos Bluetooth a serem retornados. O padrão é 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

    number optional

    Chrome 77 ou mais recente

    A bateria restante do dispositivo.

  • connectable

    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.

  • contato

    booleano opcional

    Chrome 48 ou mais recente

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

  • deviceClass

    number optional

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

  • deviceId

    number optional

  • inquiryRssi

    number optional

    Chrome 44 ou mais recente

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

  • inquiryTxPower

    number optional

    Chrome 44 ou mais recente

    O nível de potência transmitida. Esse campo está disponível apenas para dispositivos LE que o incluem no AD. Ele fica disponível e é válido apenas 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

    number optional

  • transport

    Transporte opcional

    Chrome 76 ou mais recente

    O tipo de transporte do dispositivo Bluetooth.

  • tipo

    DeviceType opcional

    O tipo de dispositivo, se reconhecido pelo Chrome. Ele é obtido 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ássicos, essa lista é obtida de dados EIR e tabelas SDP. Para dispositivos de baixo consumo de energia, essa lista é obtida dos serviços principais de AD e GATT. Para dispositivos de modo duplo, isso pode ser obtido de ambos.

  • vendorId

    number optional

  • vendorIdSource

    VendorIdSource opcional

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

DeviceType

Tipos de dispositivos comuns reconhecidos pelo Chrome.

Enumeração

"computador"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"teclado"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 ou mais recente

Tipos para filtrar dispositivos Bluetooth.

Enumeração

"all"

"conhecido"

Transport

Chrome 76 ou mais recente

Tipo de transporte do dispositivo Bluetooth.

Enumeração

"invalid"

"clássico"

"le"

"dual"

VendorIdSource

Autoridades de alocação para IDs de fornecedor.

Enumeração

"bluetooth"

"usb"

Métodos

getAdapterState()

Promise 
chrome.bluetooth.getAdapterState(
  callback?: function,
): Promise<AdapterState>

Receba 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+

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

getDevice()

Promise 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
): Promise<Device>

Recebe 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+

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

getDevices()

Promise 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
): Promise<Device[]>

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

Parâmetros

  • filtrar

    BluetoothFilter opcional

    Chrome 67 ou mais recente

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Device[]

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

Retorna

  • Promise<Device[]>

    Chrome 91+

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

startDiscovery()

Promise 
chrome.bluetooth.startDiscovery(
  callback?: function,
): Promise<void>

Inicie a descoberta. Os dispositivos descobertos recentemente serão retornados pelo evento onDeviceAdded. Os dispositivos descobertos anteriormente e já conhecidos pelo adaptador precisam ser obtidos 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. Portanto, chame stopDiscovery assim que possível.

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<void>

    Chrome 91+

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

stopDiscovery()

Promise 
chrome.bluetooth.stopDiscovery(
  callback?: function,
): Promise<void>

Parar a descoberta.

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<void>

    Chrome 91+

    As promessas só são compatíveis 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,
)

Acionado 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 mudam.

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 que foi descoberto anteriormente ficou fora do 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