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

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

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

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