Açıklama
Bluetooth cihaza bağlanmak için chrome.bluetooth
API'yi kullanın. Tüm işlevler, hataları chrome.runtime.lastError üzerinden bildirir.
Manifest
Türler
AdapterState
Özellikler
-
adres
dize
Adaptörün "XX:XX:XX:XX:XX:XX" biçimindeki adresi.
-
mevcut
boolean
Bağdaştırıcının kullanılabilir (etkin) olup olmadığını belirtir.
-
keşfetme
boolean
Bağdaştırıcının o anda keşif yapıp yapmadığını belirtir.
-
ad
dize
Bağdaştırıcının kullanıcılar tarafından okunabilen adı.
-
destekli
boolean
Adaptörde güç olup olmadığını belirtir.
BluetoothFilter
Özellikler
-
filterType
FilterType isteğe bağlı
Cihaz listesine uygulanacak filtre türü. Varsayılan değer "Tümü"dür.
-
sınır
numara isteğe bağlı
Döndürülecek maksimum Bluetooth cihaz sayısı. Belirtilmemesi halinde varsayılan değer 0'dır (sınır yok).
Device
Özellikler
-
adres
dize
Cihazın "XX:XX:XX:XX:XX:XX" biçimindeki adresi.
-
batteryPercentage
numara isteğe bağlı
Chrome 77 ve sonraki sürümlerCihazın kalan pil seviyesi.
-
bağlanabilir
boole isteğe bağlı
Chrome 48 ve sonraki sürümlerCihazın bağlanıp bağlanmadığını gösterir.
-
bağlandı
boole isteğe bağlı
Cihazın o anda sisteme bağlı olup olmadığını belirtir.
-
aktarmalı
boole isteğe bağlı
Chrome 48 ve sonraki sürümlerCihazın o anda sisteme bağlanıp bağlanmadığını belirtir.
-
deviceClass
numara isteğe bağlı
http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband tarafından tanımlanan bit alanı olan cihaz sınıfı.
-
deviceId
numara isteğe bağlı
-
inquiryRssi
numara isteğe bağlı
Chrome 44 ve sonraki sürümlerdBm cinsinden alınan sinyal gücü. Bu alan yalnızca keşif sırasında kullanılabilir ve geçerlidir. Keşif dışında değeri belirtilmemiş.
-
inquiryTxPower
numara isteğe bağlı
Chrome 44 ve sonraki sürümlerİletilen güç seviyesi. Bu alan yalnızca AD'de bu alanı içeren LE cihazları için kullanılabilir. Yalnızca keşif sırasında kullanılabilir ve geçerlidir.
-
ad
string isteğe bağlı
Cihazın kullanıcılar tarafından okunabilen adı.
-
eşlendi
boole isteğe bağlı
Cihazın sistemle eşlenip eşlenmediğini belirtir.
-
productId
numara isteğe bağlı
-
ulaşım
Ulaşım isteğe bağlı
Chrome 76 ve sonraki sürümlerBluetooth cihazının aktarım türü.
-
tür
DeviceType (Cihaz Türü) isteğe bağlı
Chrome tarafından tanınırsa cihazın türü. Bu değer,
deviceClass
alanından elde edilir ve olası cihaz türlerinin yalnızca küçük bir bölümünü temsil eder. Emin değilseniz doğrudandeviceClass
alanını kullanmalısınız. -
kullanıcı arayüzü
string[] isteğe bağlı
Cihaz tarafından tanıtılan protokollerin, profillerin ve hizmetlerin UUID'leri. Klasik Bluetooth cihazlar için bu liste, EIR verilerinden ve SDP tablolarından elde edilir. Düşük enerjili cihazlar için bu liste, AD ve GATT birincil hizmetlerinden alınır. Çift modlu cihazlarda bu, her iki moddan da elde edilebilir.
-
vendorId
numara isteğe bağlı
-
vendorIdSource
VendorIdSource isteğe bağlı
Varsa cihazın Cihaz Kimliği kaydı.
DeviceType
Chrome tarafından tanınan yaygın cihaz türleri.
Enum
"modem"
"audio"
"carAudio"
"video"
"gamepad"
"keyboard"
"tablet"
"keyboardMouseCombo"
FilterType
Bluetooth cihazları filtreleme türleri.
Enum
"all" (tümü)
Transport
Bluetooth cihazın aktarım türü.
Enum
"le"
"dual"
VendorIdSource
Tedarikçi Kimlikleri için atama yetkilileri.
Enum
"bluetooth"
"usb"
Yöntemler
getAdapterState()
chrome.bluetooth.getAdapterState(
callback?: function,
)
Bluetooth adaptörü hakkında bilgi alma.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(adapterInfo: AdapterState) => void
-
adapterInfo
Bağdaştırıcı bilgilerini içeren nesne.
-
İlerlemeler
-
Promise<AdapterState>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getDevice()
chrome.bluetooth.getDevice(
deviceAddress: string,
callback?: function,
)
Sistem tarafından bilinen bir Bluetooth cihazı hakkında bilgi alma.
Parametreler
-
deviceAddress
dize
Alınacak cihazın adresi.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(deviceInfo: Device) => void
-
deviceInfo
Cihaz bilgilerini içeren nesne.
-
İlerlemeler
-
Söz<Cihaz>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getDevices()
chrome.bluetooth.getDevices(
filter?: BluetoothFilter,
callback?: function,
)
Eşlenen ve son keşfedilen cihazlar da dahil olmak üzere sistem tarafından bilinen Bluetooth cihazlarının listesini alın.
Parametreler
-
filter
BluetoothFilter isteğe bağlı
Chrome 67 ve sonraki sürümlerDöndürülen Bluetooth cihazların listesini filtrelemek için bazı ölçütler. Filtre ayarlanmaz veya
{}
değerine ayarlanırsa döndürülen cihaz listesi tüm Bluetooth cihazları içerir. Şu anda bu özellik yalnızca ChromeOS'te desteklenmektedir. Diğer platformlar için tam liste döndürülür. -
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(deviceInfos: Device[]) => void
-
deviceInfos
Cihaz[]
Cihaz bilgilerini içeren nesne dizisi.
-
İlerlemeler
-
Söz<Cihaz[]>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
startDiscovery()
chrome.bluetooth.startDiscovery(
callback?: function,
)
Keşfi başlatın. Yeni keşfedilen cihazlar, onDeviceAdded etkinliği aracılığıyla döndürülür. Bağdaştırıcı tarafından halihazırda bilinen, daha önce keşfedilen cihazlar getDevices kullanılarak alınmalıdır ve yalnızca bunlarla ilgili bilgiler değişirse onDeviceChanged
etkinliği kullanılarak güncellenir.
Bu uygulama startDiscovery'yi zaten çağırdıysa keşif başlatılamaz. Keşif, yoğun bir kaynak olabilir: stopDiscovery en kısa sürede çağrılmalıdır.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
stopDiscovery()
chrome.bluetooth.stopDiscovery(
callback?: function,
)
Keşfi durdurun.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
Etkinlikler
onAdapterStateChanged
chrome.bluetooth.onAdapterStateChanged.addListener(
callback: function,
)
Bluetooth adaptörün durumu değiştiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(state: AdapterState) => void
-
state
-
onDeviceAdded
chrome.bluetooth.onDeviceAdded.addListener(
callback: function,
)
Yeni bir Bluetooth cihazıyla ilgili bilgi olduğunda tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(device: Device) => void
-
cihaz
-
onDeviceChanged
chrome.bluetooth.onDeviceChanged.addListener(
callback: function,
)
Bilinen bir Bluetooth cihazıyla ilgili bilgiler değiştiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(device: Device) => void
-
cihaz
-
onDeviceRemoved
chrome.bluetooth.onDeviceRemoved.addListener(
callback: function,
)
Daha önce keşfedilen bir Bluetooth cihaz, tekrar kullanılamaz olarak kabul edilecek kadar uzun bir süre kapsama alanı dışında kaldığında ve eşlenmiş bir cihaz kaldırıldığında tetiklenir.