chrome.hid

Deskripsi

Gunakan 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. Parameter reguler callback tidak akan ditentukan dalam kasus ini.

Izin

hid

Jenis

DeviceFilter

Properti

  • productId

    number opsional

    ID produk perangkat, hanya diperiksa jika ID vendor cocok.

  • penggunaan

    number opsional

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

  • usagePage

    number opsional

    ID halaman penggunaan HID.

  • vendorId

    number opsional

    ID vendor perangkat.

GetDevicesOptions

Properti

  • filter

    DeviceFilter[] opsional

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

  • productId

    number opsional

    Tidak digunakan lagi

    Setara dengan menyetel DeviceFilter.productId.

  • vendorId

    number opsional

    Tidak digunakan lagi

    Setara dengan menyetel DeviceFilter.vendorId.

HidCollectionInfo

Properti

  • reportIds

    number[]

    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 teratas dari deskriptor laporan perangkat ini.

  • deviceId

    angka

    ID perangkat tersembunyi.

  • maxFeatureReportSize

    angka

    Ukuran laporan fitur maksimum koleksi tingkat teratas.

  • maxInputReportSize

    angka

    Ukuran laporan input maksimum koleksi tingkat teratas.

  • maxOutputReportSize

    angka

    Ukuran laporan output maksimum koleksi tingkat teratas.

  • 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,
): Promise<HidConnectInfo>

Membuka koneksi ke perangkat HID untuk komunikasi.

Parameter

Hasil

  • Promise<HidConnectInfo>

    Chrome 117+

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

disconnect()

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

Memutuskan koneksi dari perangkat. Memanggil operasi pada perangkat setelah memanggil 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+

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

getDevices()

Promise 
chrome.hid.getDevices(
  options: GetDevicesOptions,
  callback?: function,
): Promise<HidDeviceInfo[]>

Menghitung perangkat HID yang terhubung.

Parameter

Hasil

  • Promise<HidDeviceInfo[]>

    Chrome 117+

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

receive()

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

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,
): Promise<ArrayBuffer>

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+

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

send()

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

Mengirim laporan output ke perangkat.

Catatan: Jangan sertakan awalan ID laporan di data. Tanda hubung 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+

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

sendFeatureReport()

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

Mengirim laporan fitur ke perangkat.

Catatan: Jangan sertakan awalan ID laporan di data. Tanda hubung 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+

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

Acara

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 menyetujui 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 yang dikirim.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (deviceId: number) => void

    • deviceId

      angka