chrome.bluetooth

Açıklama

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

Manifest

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

"bluetooth"

Türler

AdapterState

Özellikler

  • adres

    dize

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

  • mevcut

    boolean

    Adaptörün kullanılabilir (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ı.

  • powered

    boolean

    Adaptörün gücü olup olmadığını gösterir.

BluetoothFilter

Chrome 67 veya daha yeni bir sürüm

Ö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ır yok).

Device

Özellikler

  • adres

    dize

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

  • batteryPercentage

    number isteğe bağlı

    Chrome 77 veya daha yeni bir sürüm

    Cihazın kalan pili.

  • bağlanabilir

    boolean isteğe bağlı

    Chrome 48 veya daha yeni bir sürüm

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

  • bağlandı

    boolean isteğe bağlı

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

  • aktarmalı

    boolean isteğe bağlı

    Chrome 48 veya daha yeni bir sürüm

    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 veya daha yeni bir sürüm

    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 veya daha yeni bir sürüm

    İ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

    dize isteğe bağlı

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

  • eşlenmiş

    boolean 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 veya daha yeni bir sürüm

    Bluetooth cihazı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 bölümünü temsil eder. Emin olmadığınız durumlarda deviceClass alanını doğrudan kullanmalısınız.

  • uuids

    string[] isteğe bağlı

    Cihaz tarafından reklamı yapılan 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 bilgiler her ikisinden de alınabilir.

  • vendorId

    number 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

"computer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 veya daha yeni bir sürüm

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

Enum

"all"

"known"

Transport

Chrome 76 veya daha yeni bir sürüm

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

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Tedarikçi kimlikleri için tahsis yetkilileri.

Enum

"bluetooth"

"usb"

Yöntemler

getAdapterState()

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

Bluetooth adaptörü hakkında bilgi edinin.

Parametreler

  • callback

    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 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getDevice()

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

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

Parametreler

  • deviceAddress

    dize

    Alınacak cihazın adresi.

  • callback

    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 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getDevices()

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

Eşlenmiş ve yakın zamanda keşfedilen cihazlar da dahil olmak üzere sistemin bildiği Bluetooth cihazların listesini alın.

Parametreler

  • filtrele

    BluetoothFilter isteğe bağlı

    Chrome 67 veya daha yeni bir sürüm

    Döndürülen 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.

  • callback

    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 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

startDiscovery()

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

Keşif işlemine başlayın. Yeni keşfedilen cihazlar, onDeviceAdded etkinliği aracılığıyla döndürülür. Daha önce keşfedilen ve bağdaştırıcı tarafından bilinen cihazlar, getDevices kullanılarak alınmalıdır. Bu cihazlarla ilgili bilgiler değişirse yalnızca onDeviceChanged etkinliği kullanılarak güncellenir.

Bu uygulama daha önce startDiscovery'yi çağırdıysa keşif başlatılamaz. Keşif, kaynak açısından yoğun olabilir: stopDiscovery mümkün olan en kısa sürede çağrılmalıdır.

Parametreler

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

stopDiscovery()

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

Bulma özelliğini durdurun.

Parametreler

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Etkinlikler

onAdapterStateChanged

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

Bluetooth bağdaştırıcısının durumu değiştiğinde tetiklenir.

Parametreler

onDeviceAdded

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

Yeni bir Bluetooth cihazı hakkında bilgi 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ılamaz olarak kabul edilecek kadar uzun süre kapsama alanı dışında kaldığında ve eşlenmiş bir cihaz kaldırıldığında tetiklenir.

Parametreler

  • callback

    işlev

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

    (device: Device) => void