chrome.bluetooth

Açıklama

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

Kullanılabilirlik

Yalnızca ChromeOS

Manifest

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

"bluetooth"

Türler

AdapterState

Özellikler

  • adres

    dize

    Adaptörün "XX:XX:XX:XX:XX:XX" biçimindeki adresi.

  • mevcut

    boole

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

  • keşfetme

    boole

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

  • destekli

    boole

    Adaptörün gücü olup olmadığı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ı. Belirtilmezse varsayılan değer 0'dır (sınır yoktur).

Device

Özellikler

  • adres

    dize

    Cihazın "XX:XX:XX:XX:XX:XX" biçimindeki adresi.

  • batteryPercentage

    number isteğe bağlı

    Chrome 77+

    Cihazın kalan pil seviyesi.

  • bağlanabilir

    boole isteğe bağlı

    Chrome 48+

    Cihazın bağlanabilir olup olmadığını gösterir.

  • bağlandı

    boole isteğe bağlı

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

  • aktarmalı

    boole isteğe bağlı

    Chrome 48+

    Cihazın 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ıdır.

  • deviceId

    number isteğe bağlı

  • inquiryRssi

    number isteğe bağlı

    Chrome 44+

    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 belirtilmez.

  • inquiryTxPower

    number isteğe bağlı

    Chrome 44+

    İletilen güç seviyesi. Bu alan yalnızca AD'de bu alanı içeren LE cihazlarda kullanılabilir. Yalnızca keşif sırasında kullanılabilir ve geçerlidir.

  • ad

    string isteğe bağlı

    Cihazın insan tarafından okunabilen adı.

  • eşlenmiş

    boole isteğe bağlı

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

  • productId

    number isteğe bağlı

  • taşıma

    Ulaşım isteğe bağlı

    Chrome 76+

    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 bilgi, deviceClass alanından alınır ve olası cihaz türlerinin yalnızca küçük bir kısmını temsil eder. Şüpheye düştüğünüzde doğrudan deviceClass alanını kullanmanız gerekir.

  • UUID'ler

    string[] isteğe bağlı

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

  • vendorId

    number isteğe bağlı

  • vendorIdSource

    VendorIdSource isteğe bağlı

    Mümkünse cihazın cihaz kimliği kaydı.

DeviceType

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

Enum

"bilgisayar"

"phone"

"modem"

"audio"

"carAudio"

"video"

"çevre birimi"

"joystick"

"gamepad"

"keyboard"

"fare"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 ve sonraki sürümler

Bluetooth cihazları filtreleme türleri.

Enum

"all"

"known"

Transport

Chrome 76+

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

Enum

"invalid"

"klasik"

"le"

"dual"

VendorIdSource

Tedarikçi firma kimlikleri için tahsis yetkilileri.

Enum

"bluetooth"

"usb"

Yöntemler

getAdapterState()

Taahhüt 
chrome.bluetooth.getAdapterState(
  callback?: function,
): Promise<AdapterState>

Bluetooth adaptörü hakkında bilgi edinme

Parametreler

  • callback

    function 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

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

getDevice()

Taahhüt 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
): Promise<Device>

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

Parametreler

  • deviceAddress

    dize

    Alınacak cihazın adresi.

  • callback

    function 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

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

getDevices()

Taahhüt 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
): Promise<Device[]>

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

Parametreler

  • filtre

    BluetoothFilter isteğe bağlı

    Chrome 67 ve sonraki sürümler

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

  • callback

    function 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

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

startDiscovery()

Taahhüt 
chrome.bluetooth.startDiscovery(
  callback?: function,
): Promise<void>

Keşfi başlatın. Yeni keşfedilen cihazlar, onDeviceAdded etkinliği aracılığıyla döndürülür. Adaptör tarafından daha önce keşfedilen cihazlar, getDevices kullanılarak alınmalıdır ve yalnızca bilgileri 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, kaynakları yoğun şekilde kullanabilir: stopDiscovery mümkün olan en kısa sürede çağrılmalıdır.

Parametreler

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

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

stopDiscovery()

Taahhüt 
chrome.bluetooth.stopDiscovery(
  callback?: function,
): Promise<void>

Keşfi durdurun.

Parametreler

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 ve sonraki sürümler

    Promise'ler 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

onDeviceAdded

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

Yeni bir Bluetooth cihazı hakkında bilgi mevcut olduğunda tetiklenir.

Parametreler

  • callback

    işlev

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

    (device: Device) => void

onDeviceChanged

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

Bilinen bir Bluetooth cihazıyla ilgili bilgiler değiştiğinde tetiklenir.

Parametreler

  • callback

    işlev

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

    (device: Device) => void

onDeviceRemoved

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

Daha önce keşfedilen bir Bluetooth cihaz, tekrar kullanılamayacak kadar uzun süre kapsama alanı dışında kaldığında ve eşlenen bir cihaz kaldırıldığında tetiklenir.

Parametreler

  • callback

    işlev

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

    (device: Device) => void