chrome.bluetooth

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

Bu API'yi kullanmak için aşağıdaki anahtarların manifest'te beyan edilmesi gerekir.

"bluetooth"

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

Chrome 67 ve sonraki sürümler

Ö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ümler

  Cihazın kalan pil seviyesi.

• bağlanabilir

  boole isteğe bağlı

  Chrome 48 ve sonraki sürümler

  Cihazı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ümler

  Cihazı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ümler

  dBm 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ümler

  Bluetooth 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ğrudan deviceClass 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

Chrome 67 ve sonraki sürümler

Bluetooth cihazları filtreleme türleri.

Enum

"all" (tümü)

Transport

Chrome 76 ve sonraki sürümler

Bluetooth cihazın aktarım türü.

Enum

"le"

"dual"

VendorIdSource

Tedarikçi Kimlikleri için atama yetkilileri.

Enum

"bluetooth"

"usb"

Yöntemler

getAdapterState()

Söz

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

    AdapterState

    Bağdaştırıcı bilgilerini içeren nesne.

İlerlemeler

• Promise<AdapterState>

  Chrome 91 ve sonraki sürümler

  Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getDevice()

Söz

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

    Cihaz bilgilerini içeren nesne.

İlerlemeler

• Söz<Cihaz>

  Chrome 91 ve sonraki sürümler

  Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getDevices()

Söz

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ümler

  Dö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ümler

  Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

startDiscovery()

Söz

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ümler

  Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

stopDiscovery()

Söz

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ümler

  Vaatler 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

    AdapterState

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

    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

    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.

Parametreler

• geri çağırma

  işlev

  callback parametresi şu şekilde görünür:

  (device: Device)=>void

  • cihaz

    Cihaz