chrome.bluetooth

Açıklama

Bluetooth cihazına bağlanmak için chrome.bluetooth API'yi kullanın. Tüm işlevler, hataları chrome.runtime.lastError aracılığıyla bildirir.

Manifest

Bu API'yi kullanmak için aşağıdaki anahtarlar manifest dosyasında beyan edilmelidir.

"bluetooth"

Türler

AdapterState

Özellikler

• adres

  dize

  "XX:XX:XX:XX:XX:XX" biçiminde, adaptörün adresi.

• mevcut

  boolean

  Adaptörün kullanılabilir olup olmadığını (yani etkin olup olmadığını) gösterir.

• keşfetme

  boolean

  Bağdaştırıcının şu anda keşif yapıp yapmadığını gösterir.

• ad

  dize

  Adaptörün kullanıcılar tarafından okunabilen adı.

• destekleyen

  boolean

  Adaptörün güç alıp almadığını gösterir.

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

  number isteğe bağlı

  Döndürülecek maksimum Bluetooth cihazı sayısı. Belirtilmemişse varsayılan değer 0'dır (sınırsız).

Device

Özellikler

• adres

  dize

  Cihazın, "XX:XX:XX:XX:XX:XX" biçiminde adresi.

• batteryPercentage

  number isteğe bağlı

  Chrome 77 ve üzeri sürümler

  Cihazın kalan pili.

• bağlanabilir

  boole isteğe bağlı

  Chrome 48 ve üzeri sürümler

  Cihazın bağlanabilir olup olmadığını belirtir.

• bağlandı

  boole isteğe bağlı

  Cihazın şu anda sisteme bağlı olup olmadığını gösterir.

• aktarmalı

  boole isteğe bağlı

  Chrome 48 ve üzeri sürümler

  Cihazın şu anda sisteme bağlanıp bağlanmadığını gösterir.

• deviceClass

  number isteğe bağlı

  Cihazın sınıfı. http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband tarafından tanımlanan bir bit alanı.

• deviceId

  number isteğe bağlı

• inquiryRssi

  number isteğe bağlı

  Chrome 44 ve sonraki sürümler

  Alınan sinyal gücü (dBm). Bu alan yalnızca keşif sırasında kullanılabilir ve geçerlidir. Keşif dışında değeri belirtilmez.

• inquiryTxPower

  number 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

  dize isteğe bağlı

  Cihazın kullanıcılar tarafından okunabilir adı.

• eşlendi

  boole isteğe bağlı

  Cihazın sistemle eşlenip eşlenmediğini gösterir.

• productId

  number 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 isteğe bağlı

  Chrome tarafından tanınıyorsa cihazın türü. Bu değer, deviceClass alanından alınır ve olası cihaz türlerinin yalnızca küçük bir kısmını temsil eder. Şüphe duyduğunuzda doğrudan deviceClass alanını kullanmalısınız.

• uuids

  string[] isteğe bağlı

  Cihaz tarafından reklamı yapılan protokollerin, profillerin ve hizmetlerin UUID'leri. Klasik Bluetooth cihazlarda bu liste, EIR verilerinden ve SDP tablolarından alınır. Düşük Enerji cihazlarda bu liste AD ve GATT birincil hizmetlerinden alınır. Çift modlu cihazlarda bu bilgiler her ikisinden de alınabilir.

• vendorId

  number isteğe bağlı

• vendorIdSource

  VendorIdSource isteğe bağlı

  Mevcut olduğunda cihazın cihaz kimliği kaydı.

DeviceType

Chrome tarafından tanınan yaygın cihaz türleri.

Enum

"bilgisayar"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 ve sonraki sürümler

Bluetooth cihazlarını filtrelemek için kullanılan türler.

Enum

"all"

"known"

Transport

Chrome 76 ve sonraki sürümler

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

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Tedarikçi firma kimlikleri için tahsis yetkileri.

Enum

"bluetooth"

"usb"

Yöntemler

getAdapterState()

Promise

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

Bluetooth adaptörü hakkında bilgi edinin.

Parametreler

• geri çağırma

  işlev isteğe bağlı

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

  (adapterInfo: AdapterState) => void

  • adapterInfo

    AdapterState

    Adaptör bilgilerini içeren nesne.

İadeler

• Promise<AdapterState>

  Chrome 91 ve sonraki sürümler

  Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getDevice()

Promise

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

Sistem tarafından bilinen bir Bluetooth cihazı hakkında bilgi edinme

Parametreler

• deviceAddress

  dize

  Alınacak cihazın adresi.

• geri çağırma

  işlev isteğe bağlı

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

  (deviceInfo: Device) => void

  • deviceInfo

    Cihaz

    Cihaz bilgilerini içeren nesne.

İadeler

• Promise<Device>

  Chrome 91 ve sonraki sürümler

  Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getDevices()

Promise

chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

Eşlenmiş ve yakın zamanda keşfedilen cihazlar da dahil olmak üzere sistem tarafından bilinen Bluetooth cihazlarının listesini alın.

Parametreler

• filtrele

  BluetoothFilter isteğe bağlı

  Chrome 67 ve sonraki sürümler

  İade edilen Bluetooth cihazlarının listesini filtrelemek için bazı ölçütler. Filtre ayarlanmazsa veya {} olarak ayarlanırsa döndürülen cihaz listesi tüm Bluetooth cihazlarını içerir. Bu özellik şu anda yalnızca ChromeOS'te desteklenmektedir. Diğer platformlarda ise tam liste döndürülür.

• geri çağırma

  işlev isteğe bağlı

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

  (deviceInfos: Device[]) => void

  • deviceInfos

    Cihaz[]

    Cihaz bilgilerini içeren nesne dizisi.

İadeler

• Promise<Device[]>

  Chrome 91 ve sonraki sürümler

  Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

startDiscovery()

Promise

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

Keşfetmeye başlayın. Yeni keşfedilen cihazlar, onDeviceAdded etkinliği aracılığıyla döndürülür. Adaptörün daha önce keşfettiği ve bildiği cihazlar getDevices kullanılarak elde edilmelidir ve yalnızca bunlarla ilgili bilgiler değişirse onDeviceChanged etkinliği kullanılarak güncellenir.

Bu uygulama daha önce startDiscovery'yi çağırmışsa Discovery başlatılamaz. Keşif, yoğun kaynak kullanımı gerektirebilir: stopDiscovery en kısa sürede çağrılmalıdır.

Parametreler

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

  Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

stopDiscovery()

Promise

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

Keşfetmeyi durdurun.

Parametreler

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Promise<void>

  Chrome 91 ve sonraki sürümler

  Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onAdapterStateChanged

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

Bluetooth adaptörünün durumu değiştiğinde tetiklenir.

Parametreler

• geri çağırma

  işlev

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

  (state: AdapterState) => void

  • durum

    AdapterState

onDeviceAdded

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

Yeni bir Bluetooth cihazla ilgili bilgi bulunduğ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 cihazla 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 bulunan bir Bluetooth cihazı, tekrar kullanılamaz olarak kabul edilecek kadar uzun süre kapsama alanından çıktığı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