Halaman ini adalah bagian dari dokumentasi untuk platform Aplikasi Chrome, yang tidak digunakan lagi pada tahun 2020. Fitur ini tetap didukung untuk pelanggan Enterprise dan Education di ChromeOS hingga setidaknya Januari 2025. Pelajari lebih lanjut cara memigrasikan aplikasi.

Halaman ini diterjemahkan oleh Cloud Translation API.

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 (misalnya diaktifkan).
menemukan

boolean

Menunjukkan apakah adaptor sedang ditemukan atau tidak.
nama

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

angka opsional

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

Device

Properti

alamat

string

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

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

angka opsional

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

angka opsional
inquiryRssi

angka opsional

Chrome 44 dan yang lebih baru

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

angka opsional

Chrome 44 dan yang lebih baru

Tingkat daya yang ditransmisikan. Kolom ini hanya tersedia untuk perangkat LE yang menyertakan kolom ini di AD. Data 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

angka opsional
{i>transport<i}

Transpor opsional

Chrome 76 dan yang lebih baru

Jenis transport perangkat Bluetooth.
jenis

DeviceType opsional

Jenis perangkat, jika dikenali oleh Chrome. Ini diperoleh dari kolom deviceClass dan hanya mewakili sebagian kecil kemungkinan jenis perangkat. Jika ragu, sebaiknya gunakan 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, akses ini dapat diperoleh dari keduanya.
vendorId

angka opsional
vendorIdSource

VendorIdSource opsional

Data ID Perangkat, jika tersedia.

DeviceType

Jenis perangkat umum yang dikenali oleh Chrome.

Enum

"komputer"

"ponsel"

"modem"

"audio"

"carAudio"

"video"

"periferal"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 dan yang lebih baru

Jenis untuk memfilter perangkat Bluetooth.

Enum

"semua"

"diketahui"

Transport

Chrome 76 dan yang lebih baru

Jenis transportasi perangkat Bluetooth.

Enum

"tidak valid"

"klasik"

"le"

"dual"

VendorIdSource

Otoritas alokasi untuk ID Vendor.

Enum

"bluetooth"

"usb"

Metode

getAdapterState()

Janji

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

Mendapatkan informasi tentang adaptor Bluetooth.

Parameter

callback

fungsi opsional

Parameter callback terlihat seperti ini:
```
(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()

Janji

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

Mendapatkan informasi tentang perangkat Bluetooth yang dikenal oleh sistem.

Parameter

deviceAddress

string

Alamat perangkat untuk mendapatkan.
callback

fungsi opsional

Parameter callback terlihat seperti ini:
```
(deviceInfo: Device) => void
```
- deviceInfo
  
  Perangkat
  
  Objek yang berisi informasi perangkat.

Hasil

Promise<Device>

Chrome 91 dan yang lebih baru

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

getDevices()

Janji

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

Mendapatkan daftar perangkat Bluetooth yang dikenal oleh sistem, termasuk perangkat yang disambungkan dan ditemukan baru-baru ini.

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 lain, daftar lengkapnya ditampilkan.
callback

fungsi opsional

Parameter callback terlihat seperti ini:
```
(deviceInfos: Device[]) => void
```
- deviceInfos
  
  Perangkat[]
  
  Array objek yang berisi informasi perangkat.

Hasil

Promise<Device[]>

Chrome 91 dan yang lebih baru

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

startDiscovery()

Janji

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 diperbarui menggunakan peristiwa onDeviceChanged jika informasi tentang perangkat tersebut berubah.

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

Parameter

callback

fungsi opsional

Parameter callback terlihat seperti ini:
```
() => void
```

Hasil

Janji<void>

Chrome 91 dan yang lebih baru

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

stopDiscovery()

Janji

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

Hentikan penemuan.

Parameter

callback

fungsi opsional

Parameter callback terlihat seperti ini:
```
() => void
```

Hasil

Janji<void>

Chrome 91 dan yang lebih baru

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

Acara

onAdapterStateChanged

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

Diaktifkan jika status adaptor Bluetooth berubah.

Parameter

callback

fungsi

Parameter callback terlihat seperti ini:
```
(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 ini:
```
(device: Device) => void
```
- perangkat
  
  Perangkat

onDeviceChanged

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

Diaktifkan jika informasi tentang perangkat Bluetooth yang diketahui telah berubah.

Parameter

callback

fungsi

Parameter callback terlihat seperti ini:
```
(device: Device) => void
```
- perangkat
  
  Perangkat

onDeviceRemoved

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

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

Parameter

callback

fungsi

Parameter callback terlihat seperti ini:
```
(device: Device) => void
```
- perangkat
  
  Perangkat