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.

Disponibilidade

Somente no ChromeOS

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á descobrindo no momento.

  • nome

    string

    O nome legível por humanos do adaptador.

  • com tecnologia

    booleano

    Indica se o adaptador tem energia.

BluetoothFilter

Chrome 67 ou mais recente

Propriedades

  • filterType

    FilterType opcional

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

  • limite

    número 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

    número optional

    Chrome 77 ou mais recente

    A 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.

  • contato

    booleano opcional

    Chrome 48 ou mais recente

    Indica se o dispositivo está se conectando ao sistema.

  • deviceClass

    número optional

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

  • deviceId

    número optional

  • inquiryRssi

    número optional

    Chrome 44+

    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 optional

    Chrome 44+

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

  • nome

    string opcional

    O nome legível por humanos do dispositivo.

  • pareado

    booleano opcional

    Indica se o dispositivo está pareado com o sistema.

  • productId

    número optional

  • transport

    Transporte opcional

    Chrome 76 ou mais recente

    O tipo de transporte do dispositivo Bluetooth.

  • tipo

    DeviceType opcional

    O tipo do dispositivo, se reconhecido pelo Chrome. Isso é obtido do campo deviceClass e representa apenas uma pequena fração dos possíveis tipos de dispositivo. 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 baixa energia, essa lista é obtida dos serviços principais de AD e GATT. Para dispositivos de modo duplo, isso pode ser obtido de ambos.

  • vendorId

    número 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"

"keyboard"

"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()

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

Receber informações sobre o adaptador Bluetooth.

Parâmetros

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (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()

Promessa 
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 acessado.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (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()

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

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

Parâmetros

  • filtro

    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 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 optional

    O parâmetro callback é semelhante a: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Dispositivo[]

      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()

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

Iniciar a descoberta. Os dispositivos recém-descobertos serão retornados pelo evento onDeviceAdded. Os 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 o aplicativo já tiver chamado startDiscovery. A descoberta pode consumir muitos recursos: stopDiscovery precisa ser chamado assim que possível.

Parâmetros

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<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()

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

Interromper a descoberta.

Parâmetros

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<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,
)

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

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (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 é semelhante a: 

    (device: Device) => void

onDeviceRemoved

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

Disparado quando um dispositivo Bluetooth que foi descoberto anteriormente está 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 é semelhante a: 

    (device: Device) => void