chrome.bluetooth

Deskripsi

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

Ketersediaan

Khusus ChromeOS

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 melakukan penemuan 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. Defaultnya adalah semua.

  • batas

    number opsional

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

Device

Properti

  • alamat

    string

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

  • batteryPercentage

    number opsional

    Chrome 77+

    Sisa baterai perangkat.

  • connectable

    boolean opsional

    Chrome 48+

    Menunjukkan apakah perangkat dapat dihubungkan.

  • terhubung

    boolean opsional

    Menunjukkan apakah perangkat saat ini terhubung ke sistem.

  • menghubungkan

    boolean opsional

    Chrome 48+

    Menunjukkan apakah perangkat saat ini sedang terhubung ke sistem.

  • deviceClass

    number opsional

    Class perangkat, kolom bit yang ditentukan oleh http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

  • deviceId

    number opsional

  • inquiryRssi

    number opsional

    Chrome 44+

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

  • inquiryTxPower

    number opsional

    Chrome 44+

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

  • nama

    string opsional

    Nama perangkat yang dapat dibaca manusia.

  • dipasangkan

    boolean opsional

    Menunjukkan apakah perangkat disambungkan dengan sistem atau tidak.

  • productId

    number opsional

  • transport

    Transport opsional

    Chrome 76+

    Jenis transportasi perangkat Bluetooth.

  • jenis

    DeviceType opsional

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

  • uuid

    string[] opsional

    UUID protokol, profil, dan layanan yang diberitahukan 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, ID ini dapat diperoleh dari keduanya.

  • vendorId

    number opsional

  • vendorIdSource

    VendorIdSource opsional

    Data ID Perangkat dari perangkat, jika tersedia.

DeviceType

Jenis perangkat umum yang dikenali oleh Chrome.

Enum

"computer"

"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"

"classic"

"le"

"dual"

VendorIdSource

Otoritas alokasi untuk ID Vendor.

Enum

"bluetooth"

"usb"

Metode

getAdapterState()

Promise 
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 Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

getDevice()

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

Mendapatkan informasi tentang perangkat Bluetooth yang dikenali oleh sistem.

Parameter

  • deviceAddress

    string

    Alamat perangkat yang akan diambil.

  • 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 Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

getDevices()

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

Mendapatkan daftar perangkat Bluetooth yang dikenali oleh sistem, termasuk perangkat yang disambungkan dan 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 Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

startDiscovery()

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

Mulai penemuan. Perangkat yang baru ditemukan akan ditampilkan melalui peristiwa onDeviceAdded. Perangkat yang ditemukan sebelumnya 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 Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

stopDiscovery()

Promise 
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 Manifes 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,
)

Dipicu 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 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