Esta página faz parte da documentação da plataforma Apps do Chrome, que foi descontinuada em 2020. Ele continua disponível para clientes das edições Enterprise e Education no ChromeOS pelo menos até janeiro de 2025. Saiba mais sobre como migrar seu app.

Esta página foi traduzida pela API Cloud Translation.

chrome.bluetooth

Descrição

Use a API chrome.bluetooth para se conectar a um dispositivo Bluetooth. Todas as funções informam falhas por meio de 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á ou não em processo de descoberta.
nome

string

O nome legível do adaptador.
movidos

booleano

Indica se o adaptador tem ou não energia.

BluetoothFilter

Chrome 67 e versões mais recentes

Propriedades

filterType

FilterType opcional

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

número opcional

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 opcional

Chrome 77 e versões mais recentes

A bateria restante do dispositivo.
conectável

booleano opcional

Chrome 48 e versões mais recentes

Indica se o dispositivo pode ser conectado.
conectado

booleano opcional

Indica se o dispositivo está conectado ao sistema.
contato

booleano opcional

Chrome 48 e versões mais recentes

Indica se o dispositivo está se conectando ao sistema.
deviceClass

número opcional

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

número opcional
inquiryRssi

número opcional

Chrome 44 e versões mais recentes

A intensidade do sinal recebido, em dBm. Esse 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 e versões mais recentes

O nível de potência transmitido. Esse 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.
nome

string opcional

O nome legível do dispositivo.
pareado

booleano opcional

Indica se o dispositivo está pareado ou não com o sistema.
productId

número opcional
transport

Transporte opcional

Chrome 76 e versões mais recentes

O tipo de transporte do dispositivo Bluetooth.
tipo

DeviceType opcional

O tipo do dispositivo, se reconhecido pelo Chrome. Essa informação é extraída 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 é extraída dos dados de EIR e das 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 feito 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.

Enumeração

"computer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 e versões mais recentes

Tipos para filtrar dispositivos Bluetooth.

Enumeração

"all"

"known"

Transport

Chrome 76 e versões mais recentes

Tipo de transporte do dispositivo Bluetooth.

Enumeração

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Autoridades de alocação para IDs de fornecedores.

Enumeração

"bluetooth"

"usb"

Métodos

getAdapterState()

Promessa

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

Receba informações sobre o adaptador Bluetooth.

Parâmetros

callback

função opcional

O parâmetro callback tem este formato:
```
(adapterInfo: AdapterState) => void
```
- adapterInfo
  
  AdapterState
  
  Objeto que contém as informações do adaptador.

Retorna

Promessa<AdapterState>

Chrome 91 e versões mais recentes

As promessas têm suporte apenas para o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getDevice()

Promessa

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

Receber 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 este formato:
```
(deviceInfo: Device) => void
```
- deviceInfo
  
  Dispositivo
  
  Objeto que contém as informações do dispositivo.

Retorna

Promise<Device>

Chrome 91 e versões mais recentes

As promessas têm suporte apenas para 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

filtro

BluetoothFilter opcional

Chrome 67 e versões mais recentes

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 opcional

O parâmetro callback tem este formato:
```
(deviceInfos: Device[]) => void
```
- deviceInfos
  
  Dispositivo[]
  
  Matriz de objeto que contém informações do dispositivo.

Retorna

Promise<Device[]>

Chrome 91 e versões mais recentes

As promessas têm suporte apenas para o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

startDiscovery()

Promessa

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

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

Parâmetros

callback

função opcional

O parâmetro callback tem este formato:
```
() => void
```

Retorna

Promise<void>

Chrome 91 e versões mais recentes

As promessas têm suporte apenas para o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

stopDiscovery()

Promessa

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

Interromper a descoberta.

Parâmetros

callback

função opcional

O parâmetro callback tem este formato:
```
() => void
```

Retorna

Promise<void>

Chrome 91 e versões mais recentes

As promessas têm suporte apenas para o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onAdapterStateChanged

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

É acionado quando o estado do adaptador Bluetooth muda.

Parâmetros

callback

função

O parâmetro callback tem este formato:
```
(state: AdapterState) => void
```
- estado
  
  AdapterState

onDeviceAdded

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

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

Parâmetros

callback

função

O parâmetro callback tem este formato:
```
(device: Device) => void
```
- dispositivo
  
  Dispositivo

onDeviceChanged

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

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

Parâmetros

callback

função

O parâmetro callback tem este formato:
```
(device: Device) => void
```
- dispositivo
  
  Dispositivo

onDeviceRemoved

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

É acionado quando um dispositivo Bluetooth que foi descoberto anteriormente fica 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 este formato:
```
(device: Device) => void
```
- dispositivo
  
  Dispositivo