chrome.bluetooth

Deskripsi

Gunakan API chrome.bluetooth 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 (yaitu diaktifkan) atau tidak.

  • menemukan

    boolean

    Menunjukkan apakah adaptor saat ini sedang menemukan atau tidak.

  • nama

    string

    Nama adaptor yang dapat dibaca manusia.

  • didukung

    boolean

    Menunjukkan apakah adaptor memiliki daya atau tidak.

BluetoothFilter

Chrome 67+

Properti

  • filterType

    FilterType opsional

    Jenis filter yang akan diterapkan ke daftar perangkat. Default-nya adalah semua.

  • batas

    nomor opsional

    Jumlah maksimum perangkat bluetooth yang akan ditampilkan. Nilai 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+

    Sisa baterai perangkat.

  • dapat terhubung

    boolean opsional

    Chrome 48+

    Menunjukkan apakah perangkat dapat terhubung.

  • terhubung

    boolean opsional

    Menunjukkan apakah perangkat saat ini terhubung ke sistem.

  • penerbangan lanjutan

    boolean opsional

    Chrome 48+

    Menunjukkan apakah perangkat saat ini terhubung ke sistem.

  • deviceClass

    nomor opsional

    Class perangkat, kolom bit yang ditentukan 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 valid hanya selama penemuan. Di luar penemuan, nilainya tidak ditentukan.

  • inquiryTxPower

    nomor opsional

    Chrome 44+

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

  • nama

    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}

    Transportasi opsional

    Chrome 76+

    Jenis transportasi perangkat bluetooth.

  • jenis

    DeviceType opsional

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

  • uuids

    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, informasi ini dapat diperoleh dari keduanya.

  • vendorId

    nomor opsional

  • vendorIdSource

    VendorIdSource opsional

    Catatan ID Perangkat dari perangkat, jika tersedia.

DeviceType

Jenis perangkat umum yang dikenali oleh Chrome.

Enum

"komputer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67+

Jenis untuk memfilter perangkat bluetooth.

Enum

"all"

"known"

Transport

Chrome 76+

Jenis transportasi perangkat bluetooth.

Enum

"invalid"

"klasik"

"le"

"dual"

VendorIdSource

Otoritas alokasi untuk ID Vendor.

Enum

"bluetooth"

"usb"

Metode

getAdapterState()

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

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+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getDevice()

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

Mendapatkan informasi tentang perangkat Bluetooth yang dikenal oleh 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<Device>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getDevices()

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

Mendapatkan daftar perangkat Bluetooth yang diketahui oleh sistem, termasuk perangkat yang disambungkan dan yang baru ditemukan.

Parameter

  • filter

    BluetoothFilter opsional

    Chrome 67+

    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 lain, daftar lengkap akan ditampilkan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Perangkat[]

      Array objek yang berisi informasi perangkat.

Hasil

  • Promise<Device[]>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

startDiscovery()

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

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

Penemuan akan gagal dimulai jika aplikasi ini telah memanggil startDiscovery. Penemuan dapat menggunakan banyak resource: stopDiscovery harus dipanggil sesegera mungkin.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

stopDiscovery()

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

Hentikan penemuan.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

Acara

onAdapterStateChanged

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

Diaktifkan saat status adaptor Bluetooth berubah.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (state: AdapterState) => void

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 dikenal 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 saat perangkat yang disambungkan dihapus.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (device: Device) => void