chrome.bluetooth

Deskripsi

Gunakan chrome.bluetooth API untuk menghubungkan ke perangkat Bluetooth. Semua fungsi melaporkan kegagalan melalui chrome.runtime.lastError.

Manifes

Kunci berikut harus dideklarasikan dalam manifes untuk menggunakan API ini.

"bluetooth"

Jenis

AdapterState

Properti

  • alamat

    string

    Alamat adaptor, dalam format 'XX:XX:XX:XX:XX:XX'.

  • tersedia

    boolean

    Menunjukkan apakah adaptor tersedia atau tidak (yaitu diaktifkan).

  • menemukan

    boolean

    Menunjukkan apakah adaptor saat ini ditemukan atau tidak.

  • name

    string

    Nama adaptor yang dapat dibaca manusia.

  • didukung

    boolean

    Menunjukkan apakah adaptor memiliki daya atau tidak.

BluetoothFilter

Chrome 67 dan yang lebih baru

Properti

  • filterType

    FilterType opsional

    Jenis filter yang akan diterapkan ke daftar perangkat. Defaultnya adalah semua.

  • batas

    nomor opsional

    Jumlah maksimum perangkat bluetoth yang akan ditampilkan. Defaultnya adalah 0 (tidak ada batas) jika tidak ditentukan.

Device

Properti

  • alamat

    string

    Alamat perangkat, dalam format 'XX:XX:XX:XX:XX:XX'.

  • batteryPercentage

    nomor opsional

    Chrome 77 dan yang lebih baru

    Sisa baterai perangkat.

  • dapat dihubungkan

    boolean opsional

    Chrome 48+

    Menunjukkan apakah perangkat dapat dihubungkan.

  • terhubung

    boolean opsional

    Menunjukkan apakah perangkat saat ini terhubung ke sistem.

  • penerbangan lanjutan

    boolean opsional

    Chrome 48+

    Menunjukkan apakah perangkat sedang terhubung ke sistem.

  • deviceClass

    nomor opsional

    Kelas perangkat, bidang bit yang didefinisikan oleh http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

  • deviceId

    nomor opsional

  • inquiryRssi

    nomor opsional

    Chrome 44+

    Kekuatan sinyal yang diterima, dalam dBm. Kolom ini tersedia dan hanya valid selama penemuan. Di luar penemuan, nilainya tidak ditentukan.

  • inquiryTxPower

    nomor opsional

    Chrome 44+

    Level daya yang ditransmisikan. Kolom ini hanya tersedia untuk perangkat LE yang menyertakan kolom ini di AD. Teks ini tersedia dan valid hanya selama penemuan.

  • name

    string opsional

    Nama perangkat yang dapat dibaca manusia.

  • dipasangkan

    boolean opsional

    Menunjukkan apakah perangkat dipasangkan dengan sistem atau tidak.

  • productId

    nomor opsional

  • {i>transport<i}

    Transpor opsional

    Chrome 76 dan yang lebih baru

    Jenis transpor perangkat Bluetooth.

  • tipe

    DeviceType opsional

    Jenis perangkat, jika dikenali oleh Chrome. Ini diperoleh dari kolom deviceClass dan hanya mewakili sebagian kecil dari jenis perangkat yang memungkinkan. Jika ragu, Anda harus menggunakan kolom deviceClass secara langsung.

  • uuid

    string[] opsional

    UUID protokol, profil, dan layanan yang diiklankan oleh perangkat. Untuk perangkat Bluetooth klasik, daftar ini diperoleh dari data EIR dan tabel SDP. Untuk perangkat Hemat Energi, daftar ini diperoleh dari layanan utama AD dan GATT. Untuk perangkat mode ganda, parameter ini dapat diperoleh dari keduanya.

  • vendorId

    nomor opsional

  • vendorIdSource

    VendorIdSource opsional

    Data ID Perangkat perangkat, jika tersedia.

DeviceType

Jenis perangkat umum yang dikenali oleh Chrome.

Enum

"modem"

"audio"

"carAudio"

"video"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 dan yang lebih baru

Jenis untuk memfilter perangkat Bluetooth.

Enum

Transport

Chrome 76 dan yang lebih baru

Jenis transpor perangkat bluetooth.

Enum

"le"

"dual"

VendorIdSource

Otoritas alokasi untuk ID Vendor.

Enum

"bluetooth"

"usb"

Metode

getAdapterState()

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

Mendapatkan informasi tentang adaptor Bluetooth.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (adapterInfo: AdapterState)=>void

    • adapterInfo

      AdapterState

      Objek yang berisi informasi adaptor.

Hasil

  • Promise<AdapterState>

    Chrome 91 dan yang lebih baru

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.

getDevice()

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

Mendapatkan informasi tentang perangkat Bluetooth yang diketahui sistem.

Parameter

  • deviceAddress

    string

    Alamat perangkat yang akan didapatkan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (deviceInfo: Device)=>void

    • deviceInfo

      Perangkat

      Objek yang berisi informasi perangkat.

Hasil

  • Promise<Perangkat>

    Chrome 91 dan yang lebih baru

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.

getDevices()

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

Dapatkan daftar perangkat Bluetooth yang dikenal sistem, termasuk perangkat yang disambungkan dan baru ditemukan.

Parameter

  • filter

    BluetoothFilter opsional

    Chrome 67 dan yang lebih baru

    Beberapa kriteria untuk memfilter daftar perangkat bluetooth yang ditampilkan. Jika filter tidak disetel atau disetel ke {}, daftar perangkat yang ditampilkan akan berisi semua perangkat bluetooth. Saat ini, fitur ini hanya didukung di ChromeOS. Untuk platform lainnya, daftar lengkapnya telah ditampilkan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (deviceInfos: Device[])=>void

    • deviceInfos

      Perangkat[]

      Array objek yang berisi informasi perangkat.

Hasil

  • Promise<Perangkat[]>

    Chrome 91 dan yang lebih baru

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.

startDiscovery()

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

Mulai penemuan. Perangkat yang baru ditemukan akan ditampilkan melalui peristiwa onDeviceAdded. Perangkat yang sebelumnya ditemukan dan telah diketahui oleh adaptor harus diperoleh menggunakan getDevices dan hanya akan diupdate menggunakan peristiwa onDeviceChanged jika informasi tentang perangkat tersebut berubah.

Penemuan akan gagal dimulai jika aplikasi ini sudah memanggil startDiscovery. Penemuan mungkin membutuhkan banyak resource: stopDiscovery harus dipanggil sesegera mungkin.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    ()=>void

Hasil

  • Promise<void>

    Chrome 91 dan yang lebih baru

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.

stopDiscovery()

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

Menghentikan penemuan.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    ()=>void

Hasil

  • Promise<void>

    Chrome 91 dan yang lebih baru

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.

Peristiwa

onAdapterStateChanged

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

Diaktifkan saat status adaptor Bluetooth berubah.

Parameter

onDeviceAdded

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

Diaktifkan saat informasi tentang perangkat Bluetooth baru tersedia.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (device: Device)=>void

onDeviceChanged

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

Diaktifkan saat informasi tentang perangkat Bluetooth yang diketahui telah berubah.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (device: Device)=>void

onDeviceRemoved

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

Diaktifkan saat perangkat Bluetooth yang sebelumnya ditemukan telah berada di luar jangkauan cukup lama sehingga dianggap tidak tersedia lagi, dan jika perangkat yang disambungkan akan dihapus.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (device: Device)=>void