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
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.
-
nome
string
Nome legível do adaptador.
-
tecnologia
boolean
Indica se o adaptador está conectado a uma fonte de energia.
BluetoothFilter
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 a serem devolvidos. 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 recenteBateria restante do dispositivo.
-
conectável
booleano opcional
Chrome 48 ou mais recenteIndica 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 recenteIndica 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 recenteA 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 recenteO 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.
-
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 mais recenteO tipo de transporte do dispositivo Bluetooth.
-
Tipo
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 campodeviceClass
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
Tipos para filtrar dispositivos Bluetooth.
Tipo enumerado
Transport
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()
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
Objeto contendo as informações do adaptador.
-
Retorna
-
Promise<AdapterState>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
getDevice()
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
Objeto contendo as informações do dispositivo.
-
Retorna
-
Prometer<Dispositivo>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
getDevices()
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 mais recenteAlguns 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
Matriz de objeto que contém informações do dispositivo.
-
Retorna
-
Prometer<Dispositivo[]>
Chrome 91 ou mais recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
startDiscovery()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
stopDiscovery()
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 recentePromessas 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
-
callback
função
O parâmetro
callback
tem esta aparência:(state: AdapterState) => void
-
state
-
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
-
dispositivo
-
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
-
dispositivo
-
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
-
dispositivo
-