chrome.hid

Deskripsi

Menggunakan chrome.hid API untuk berinteraksi dengan perangkat HID yang terhubung. API ini memberikan akses ke operasi HID dari dalam konteks aplikasi. Dengan menggunakan API ini, aplikasi dapat berfungsi sebagai driver untuk perangkat hardware. Error yang dihasilkan oleh API ini dilaporkan dengan menetapkan runtime.lastError dan menjalankan callback reguler fungsi. Dalam kasus ini, parameter reguler callback tidak akan ditentukan.

Izin

hid

Jenis

DeviceFilter

Properti

  • productId

    nomor opsional

    ID produk perangkat, hanya diperiksa jika ID vendor cocok.

  • penggunaan

    nomor opsional

    ID penggunaan HID, hanya diperiksa jika halaman penggunaan HID cocok.

  • usagePage

    nomor opsional

    ID halaman penggunaan HID.

  • vendorId

    nomor opsional

    ID vendor perangkat.

GetDevicesOptions

Properti

  • filter

    DeviceFilter[] opsional

    Perangkat yang cocok dengan filter yang diberikan akan ditampilkan. Daftar filter kosong akan menampilkan semua perangkat yang izinnya dimiliki aplikasi.

  • productId

    nomor opsional

    Tidak digunakan lagi

    Setara dengan setelan DeviceFilter.productId.

  • vendorId

    nomor opsional

    Tidak digunakan lagi

    Setara dengan setelan DeviceFilter.vendorId.

HidCollectionInfo

Properti

  • reportIds

    angka[]

    ID laporan yang termasuk dalam koleksi dan turunannya.

  • penggunaan

    angka

    ID penggunaan yang ditentukan halaman.

  • usagePage

    angka

    ID halaman penggunaan HID.

HidConnectInfo

Properti

  • connectionId

    angka

    ID buram yang digunakan untuk mengidentifikasi koneksi ini di semua fungsi lainnya.

HidDeviceInfo

Properti

  • koleksi

    HidCollectionInfo[]

    Koleksi tingkat atas dari deskriptor laporan perangkat ini.

  • deviceId

    angka

    ID perangkat buram.

  • maxFeatureReportSize

    angka

    Ukuran laporan fitur maksimum koleksi tingkat atas.

  • maxInputReportSize

    angka

    Ukuran laporan input maksimum koleksi tingkat atas.

  • maxOutputReportSize

    angka

    Ukuran laporan output maksimum koleksi tingkat atas.

  • productId

    angka

    ID Produk.

  • productName

    string

    Chrome 46+

    Nama produk yang dibaca dari perangkat, jika tersedia.

  • reportDescriptor

    ArrayBuffer

    Deskripsi laporan perangkat mentah (tidak tersedia di Windows).

  • serialNumber

    string

    Chrome 46+

    Nomor seri yang dibaca dari perangkat, jika tersedia.

  • vendorId

    angka

    ID Vendor.

Metode

connect()

Promise 
chrome.hid.connect(
  deviceId: number,
  callback?: function,
)

Membuka koneksi ke perangkat HID untuk berkomunikasi.

Parameter

Hasil

  • Promise<HidConnectInfo>

    Chrome 117 dan yang lebih baru

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

disconnect()

Promise 
chrome.hid.disconnect(
  connectionId: number,
  callback?: function,
)

Memutuskan koneksi dari perangkat. Memanggil operasi pada perangkat setelah memanggil tindakan ini aman, tetapi tidak berpengaruh.

Parameter

  • connectionId

    angka

    connectionId yang ditampilkan oleh connect.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    ()=>void

Hasil

  • Promise<void>

    Chrome 117 dan yang lebih baru

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

getDevices()

Promise 
chrome.hid.getDevices(
  options: GetDevicesOptions,
  callback?: function,
)

Menghitung perangkat HID yang terhubung.

Parameter

Hasil

  • Promise<HidDeviceInfo[]>

    Chrome 117 dan yang lebih baru

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

receive()

chrome.hid.receive(
  connectionId: number,
  callback: function,
)

Menerima laporan input berikutnya dari perangkat.

Parameter

  • connectionId

    angka

    connectionId yang ditampilkan oleh connect.

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (reportId: number,data: ArrayBuffer)=>void

    • reportId

      angka

      ID laporan atau 0 jika tidak ada.

    • data

      ArrayBuffer

      Data laporan, awalan ID laporan (jika ada) akan dihapus.

receiveFeatureReport()

Promise 
chrome.hid.receiveFeatureReport(
  connectionId: number,
  reportId: number,
  callback?: function,
)

Meminta laporan fitur dari perangkat.

Parameter

  • connectionId

    angka

    connectionId yang ditampilkan oleh connect.

  • reportId

    angka

    ID laporan, atau 0 jika tidak ada.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (data: ArrayBuffer)=>void

    • data

      ArrayBuffer

      Data laporan, termasuk awalan ID laporan jika dikirim oleh perangkat.

Hasil

  • Promise<ArrayBuffer>

    Chrome 117 dan yang lebih baru

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

send()

Promise 
chrome.hid.send(
  connectionId: number,
  reportId: number,
  data: ArrayBuffer,
  callback?: function,
)

Kirim laporan output ke perangkat.

Catatan: Jangan sertakan awalan ID laporan dalam data. Kolom tersebut akan ditambahkan jika perlu.

Parameter

  • connectionId

    angka

    connectionId yang ditampilkan oleh connect.

  • reportId

    angka

    ID laporan yang akan digunakan, atau 0 jika tidak ada.

  • data

    ArrayBuffer

    Data laporan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    ()=>void

Hasil

  • Promise<void>

    Chrome 117 dan yang lebih baru

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

sendFeatureReport()

Promise 
chrome.hid.sendFeatureReport(
  connectionId: number,
  reportId: number,
  data: ArrayBuffer,
  callback?: function,
)

Kirim laporan fitur ke perangkat.

Catatan: Jangan sertakan awalan ID laporan dalam data. Kolom tersebut akan ditambahkan jika perlu.

Parameter

  • connectionId

    angka

    connectionId yang ditampilkan oleh connect.

  • reportId

    angka

    ID laporan yang akan digunakan, atau 0 jika tidak ada.

  • data

    ArrayBuffer

    Data laporan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    ()=>void

Hasil

  • Promise<void>

    Chrome 117 dan yang lebih baru

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

Peristiwa

onDeviceAdded

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

Peristiwa yang dihasilkan saat perangkat ditambahkan ke sistem. Peristiwa hanya disiarkan ke aplikasi dan ekstensi yang memiliki izin untuk mengakses perangkat. Izin mungkin telah diberikan pada waktu penginstalan atau saat pengguna menerima izin opsional (lihat permissions.request).

Parameter

onDeviceRemoved

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

Peristiwa yang dihasilkan saat perangkat dihapus dari sistem. Lihat onDeviceAdded untuk mengetahui peristiwa mana yang ditayangkan.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (deviceId: number)=>void

    • deviceId

      angka