chrome.bluetooth

Deskripsi

Gunakan chrome.bluetooth API untuk terhubung 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 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

  number 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

  number opsional

  Chrome 77+

  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 saat ini terhubung ke sistem.

• deviceClass

  number opsional

  Class perangkat, bit-field 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 hanya valid 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. Opsi ini hanya tersedia dan valid selama penemuan.

• nama

  string opsional

  Nama perangkat yang dapat dibaca manusia.

• disambungkan

  boolean opsional

  Menunjukkan apakah perangkat disambungkan dengan sistem atau tidak.

• productId

  number opsional

• transportasi

  Transportasi opsional

  Chrome 76+

  Jenis transpor perangkat bluetooth.

• jenis

  DeviceType opsional

  Jenis perangkat, jika dikenali oleh Chrome. 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, hal ini dapat diperoleh dari keduanya.

• vendorId

  number opsional

• vendorIdSource

  VendorIdSource opsional

  Data ID Perangkat 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 transpor perangkat bluetooth.

Enum

"invalid"

"classic"

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

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

getDevice()

Promise

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

Mendapatkan informasi tentang perangkat Bluetooth yang diketahui oleh sistem.

Parameter

• deviceAddress

  string

  Alamat perangkat yang akan diperoleh.

• 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,
)

Mendapatkan daftar perangkat Bluetooth yang diketahui oleh sistem, termasuk perangkat yang disambungkan dan baru-baru ini 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,
)

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 memerlukan 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,
)

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

  • dengan status tersembunyi akhir

    AdapterState

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

  • perangkat

    Perangkat

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

  • perangkat

    Perangkat

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

  • perangkat

    Perangkat