chrome.bluetooth

Açıklama

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

Manifest

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

"bluetooth"

Türler

AdapterState

Özellikler

• adres

  dize

  Bağdaştırıcının "XX:XX:XX:XX:XX:XX" biçimindeki adresi.

• mevcut

  boolean

  Bağdaştırıcının kullanılıp kullanılamadığını (ör. etkin) gösterir.

• keşfetme

  boolean

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

• ad

  dize

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

• destekli

  boolean

  Adaptörde güç olup olmadığını gösterir.

BluetoothFilter

Chrome 67 ve sonraki sürümler 'nı inceleyin.

Özellikler

• filterType

  FilterType isteğe bağlı

  Cihaz listesine uygulanacak filtre türü. Varsayılan ayar "Tümü"dür.

• sınır

  sayı isteğe bağlı

  Geri dönülecek maksimum Bluetooth cihazı sayısı. Belirtilmemişse 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

  sayı isteğe bağlı

  Chrome 77 ve sonraki sürümler 'nı inceleyin.

  Cihazın kalan pil seviyesi.

• bağlanabilir

  boole isteğe bağlı

  Chrome 48 ve sonraki sürümler 'nı inceleyin.

  Cihazın bağlanıp bağlanamadığını belirtir.

• 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 'nı inceleyin.

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

• deviceClass

  sayı 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

  sayı isteğe bağlı

• inquiryRssi

  sayı isteğe bağlı

  Chrome 44 ve sonraki sürümler 'nı inceleyin.

  Alınan sinyal gücü (dBm cinsinden). Bu alan yalnızca keşif sırasında kullanılabilir ve geçerlidir. Keşif dışındaki değerler için veri belirtilmemiş.

• inquiryTxPower

  sayı isteğe bağlı

  Chrome 44 ve sonraki sürümler 'nı inceleyin.

  İ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 okunabilen adı.

• eşlendi

  boole isteğe bağlı

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

• productId

  sayı isteğe bağlı

• ulaşım

  Taşımacılık isteğe bağlı

  Chrome 76 ve sonraki sürümler 'nı inceleyin.

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

• tür

  DeviceType isteğe bağlı

  Cihazın türü (Chrome tarafından tanınırsa). Bu değer, deviceClass alanından elde edilir ve olası cihaz türlerinin yalnızca küçük bir bölümünü temsil eder. Şüpheye düştüğünüzde doğrudan deviceClass alanını kullanmalısınız.

• uuids

  string[] isteğe bağlı

  Cihaz tarafından reklamı yapılan protokol, profil ve hizmetlerin UUID'leri. Klasik Bluetooth cihazlar için bu liste, EIR verilerinden ve SDP tablolarından alınır. Düşük Enerjili cihazlar için bu liste AD ve GATT birincil hizmetlerinden alınmıştır. Çift modlu cihazlarda bu değer her ikisinden de edinilebilir.

• vendorId

  sayı isteğe bağlı

• vendorIdSource

  VendorIdSource isteğe bağlı

  Varsa cihazın Cihaz Kimliği kaydı.

DeviceType

Chrome'un tanıdığı yaygın cihaz türleri.

Enum

"bilgisayar"

"phone"

"modem"

"audio"

"carAudio"

"video"

"çevre birimi"

"kontrol çubuğu"

"oyun kumandası"

"klavye"

"fare"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 ve sonraki sürümler 'nı inceleyin.

Bluetooth cihazları filtreleme türleri.

Enum

"all"

"known"

Transport

Chrome 76 ve sonraki sürümler 'nı inceleyin.

Bluetooth cihazın taşıma türü.

Enum

"geçersiz"

"klasik"

"le"

"çift"

VendorIdSource

Tedarikçi firma kimlikleri için ayırma yetkilileri.

Enum

"bluetooth"

"usb"

Yöntemler

getAdapterState()

Söz 'nı inceleyin.

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

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

İadeler

• Promise<AdapterState>

  Chrome 91 ve sonraki sürümler 'nı inceleyin.

  Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getDevice()

Söz 'nı inceleyin.

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

Sistem tarafından bilinen bir Bluetooth cihazı hakkında bilgi alın.

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 'nı inceleyin.

  Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getDevices()

Söz 'nı inceleyin.

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 bir listesini alın.

Parametreler

• filtrele

  BluetoothFilter isteğe bağlı

  Chrome 67 ve sonraki sürümler 'nı inceleyin.

  Döndürülen Bluetooth cihazların listesini filtrelemek için bazı ölçütler. Filtre ayarlanmaz veya {} olarak 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

  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 <Cihaz[]>

  Chrome 91 ve sonraki sürümler 'nı inceleyin.

  Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

startDiscovery()

Söz 'nı inceleyin.

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

Keşfi başlatın. Yeni keşfedilen cihazlar onDeviceAdded etkinliği aracılığıyla geri döndürülür. Adaptör tarafından bilinen, daha önce keşfedilen cihazlar getDevices kullanılarak edinilmelidir ve yalnızca bu cihazlarla ilgili bilgiler değişirse onDeviceChanged etkinliği kullanılarak güncellenir.

Bu uygulama daha önce startDiscovery'yi çağırdıysa keşif başlatılamaz. Keşif yoğun kaynak 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

• Taahhüt<void>

  Chrome 91 ve sonraki sürümler 'nı inceleyin.

  Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

stopDiscovery()

Söz 'nı inceleyin.

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

Keşfi durdurun.

Parametreler

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Taahhüt<void>

  Chrome 91 ve sonraki sürümler 'nı inceleyin.

  Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması 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 cihazıyla ilgili bilgi mevcut 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,
)

Önceden keşfedilen bir Bluetooth cihaz, tekrar kullanılamaz olarak değerlendirilecek kadar uzun süre kapsama alanında kaldığında ve eşlenen 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