chrome.hid

Açıklama

Bağlı HID cihazlarıyla etkileşimde bulunmak için chrome.hid API'yi kullanın. Bu API, bir uygulama bağlamından HID işlemlerine erişim sağlar. Uygulamalar bu API'yi kullanarak donanım cihazları için sürücü olarak çalışabilir. Bu API tarafından oluşturulan hatalar, runtime.lastError ayarlanıp işlevin normal geri çağırması yürütülerek raporlanır. Bu durumda, geri çağırmanın normal parametreleri tanımsız olur.

İzinler

hid

Türler

DeviceFilter

Özellikler

  • productId

    sayı isteğe bağlı

    Cihaz ürün kimliği, yalnızca tedarikçi kimliği eşleşirse kontrol edilir.

  • kullanım

    sayı isteğe bağlı

    HID kullanım tanımlayıcısı, yalnızca HID kullanım sayfası eşleştiğinde kontrol edilir.

  • usagePage

    sayı isteğe bağlı

    HID kullanım sayfası tanımlayıcısı.

  • vendorId

    sayı isteğe bağlı

    Cihaz tedarikçi firma kimliği.

GetDevicesOptions

Özellikler

  • filtreler

    DeviceFilter[] isteğe bağlı

    Belirli bir filtreyle eşleşen bir cihaz döndürülür. Boş bir filtre listesi, uygulamanın izne sahip olduğu tüm cihazları döndürür.

  • productId

    sayı isteğe bağlı

    Desteği sonlandırıldı

    DeviceFilter.productId ayarına eşdeğerdir.

  • vendorId

    sayı isteğe bağlı

    Desteği sonlandırıldı

    DeviceFilter.vendorId ayarına eşdeğerdir.

HidCollectionInfo

Özellikler

  • reportIds

    numara[]

    Koleksiyona ve alt öğelerine ait rapor kimlikleri.

  • kullanım

    sayı

    Sayfa tanımlı kullanım tanımlayıcısı.

  • usagePage

    sayı

    HID kullanım sayfası tanımlayıcısı.

HidConnectInfo

Özellikler

  • connectionId

    sayı

    Diğer tüm işlevlerde bu bağlantıyı tanımlamak için kullanılan opak kimlik.

HidDeviceInfo

Özellikler

  • koleksiyonlar

    HidCollectionInfo[]

    Bu cihazın rapor tanımlayıcılarından alınan üst düzey koleksiyonlar.

  • deviceId

    sayı

    Opak cihaz kimliği.

  • maxFeatureReportSize

    sayı

    Üst düzey koleksiyonun maksimum özellik raporu boyutu.

  • maxInputReportSize

    sayı

    Üst düzey koleksiyonun maksimum giriş raporu boyutu.

  • maxOutputReportSize

    sayı

    Üst düzey koleksiyonun maksimum çıktı rapor boyutu.

  • productId

    sayı

    Ürün kimliği.

  • productName

    dize

    Chrome 46 ve sonraki sürümler 'nı inceleyin.

    Cihazda okunan ürün adı (varsa).

  • reportDescriptor

    DiziArabelleği

    Ham cihaz raporu açıklayıcısı (Windows'da kullanılamaz).

  • serialNumber

    dize

    Chrome 46 ve sonraki sürümler 'nı inceleyin.

    Cihazda okunan seri numarası (varsa).

  • vendorId

    sayı

    Tedarikçi kimliği.

Yöntemler

connect()

Söz 'nı inceleyin.
chrome.hid.connect(
  deviceId: number,
  callback?: function,
)

İletişim için bir HID cihazının bağlantısını açın.

Parametreler

İadeler

  • Promise<HidConnectInfo>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

disconnect()

Söz 'nı inceleyin.
chrome.hid.disconnect(
  connectionId: number,
  callback?: function,
)

Bir cihazın bağlantısını kesin. Bunu çağırdıktan sonra cihazdaki işlemleri çağırmak güvenlidir ancak herhangi bir etkisi yoktur.

Parametreler

  • connectionId

    sayı

    connectionId, connect tarafından iade edildi.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Taahhüt<void>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getDevices()

Söz 'nı inceleyin.
chrome.hid.getDevices(
  options: GetDevicesOptions,
  callback?: function,
)

Bağlı HID cihazlarını numaralandırma.

Parametreler

  • seçenekler

    GetDevicesOptions

    Hedef cihazlarda aranacak özellikler.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (devices: HidDeviceInfo[]) => void

İadeler

  • Promise&lt;HidDeviceInfo[]&gt;

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

receive()

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

Cihazdan bir sonraki giriş raporunu alın.

Parametreler

  • connectionId

    sayı

    connectionId, connect tarafından iade edildi.

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

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

    • reportId

      sayı

      Rapor kimliği veya yoksa 0.

    • veri

      DiziArabelleği

      Rapor verileri olan rapor kimliği ön eki (varsa) kaldırılır.

receiveFeatureReport()

Söz 'nı inceleyin.
chrome.hid.receiveFeatureReport(
  connectionId: number,
  reportId: number,
  callback?: function,
)

Cihazdan bir özellik raporu isteyin.

Parametreler

  • connectionId

    sayı

    connectionId, connect tarafından iade edildi.

  • reportId

    sayı

    Rapor kimliği veya yoksa 0.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (data: ArrayBuffer) => void

    • veri

      DiziArabelleği

      Rapor kimliği ön eki cihaz tarafından gönderilirse rapor kimliği ön eki de dahil olmak üzere rapor verileri.

İadeler

  • Promise<ArrayBuffer>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

send()

Söz 'nı inceleyin.
chrome.hid.send(
  connectionId: number,
  reportId: number,
  data: ArrayBuffer,
  callback?: function,
)

Cihaza bir çıkış raporu gönderin.

Not: data öğesine rapor kimliği ön eki eklemeyin. Gerekirse eklenir.

Parametreler

  • connectionId

    sayı

    connectionId, connect tarafından iade edildi.

  • reportId

    sayı

    Kullanılacak rapor kimliği. Kullanılacak rapor kimliği yoksa 0.

  • veri

    DiziArabelleği

    Rapor verileri.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Taahhüt<void>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

sendFeatureReport()

Söz 'nı inceleyin.
chrome.hid.sendFeatureReport(
  connectionId: number,
  reportId: number,
  data: ArrayBuffer,
  callback?: function,
)

Cihaza bir özellik raporu gönderin.

Not: data öğesine rapor kimliği ön eki eklemeyin. Gerekirse eklenir.

Parametreler

  • connectionId

    sayı

    connectionId, connect tarafından iade edildi.

  • reportId

    sayı

    Kullanılacak rapor kimliği. Kullanılacak rapor kimliği yoksa 0.

  • veri

    DiziArabelleği

    Rapor verileri.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Taahhüt<void>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

Etkinlikler

onDeviceAdded

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

Sisteme bir cihaz eklendiğinde oluşturulan etkinlik. Etkinlikler yalnızca cihaza erişim izni olan uygulama ve uzantılara yayınlanır. İzin, yükleme sırasında veya kullanıcı isteğe bağlı bir izni kabul ettiğinde verilmiş olabilir (bkz. permissions.request).

Parametreler

onDeviceRemoved

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

Bir cihaz sistemden kaldırıldığında oluşturulan etkinlik. Etkinliklerin teslim edildiği onDeviceAdded konusuna bakın.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (deviceId: number) => void

    • deviceId

      sayı