chrome.hid

Açıklama

Bağlı HID cihazlarıyla etkileşimde bulunmak için chrome.hid API'yi kullanın. Bu API, HID işlemlerine uygulama içinden 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 ayarlanarak ve işlevin normal geri çağırması yürütülerek bildirilir. Bu durumda, geri çağırmanın normal parametreleri tanımsız olur.

İzinler

hid

Türler

DeviceFilter

Özellikler

  • productId

    numara isteğe bağlı

    Cihaz ürün kimliği (yalnızca satıcı kimliği eşleştiğinde kontrol edilir).

  • kullanım

    numara isteğe bağlı

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

  • usagePage

    numara isteğe bağlı

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

  • vendorId

    numara isteğe bağlı

    Cihaz tedarikçi firması 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 izninin olduğu tüm cihazları döndürür.

  • productId

    numara isteğe bağlı

    Kullanımdan kaldırıldı

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

  • vendorId

    numara isteğe bağlı

    Kullanımdan kaldırıldı

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

HidCollectionInfo

Özellikler

  • reportIds

    numara[]

    Koleksiyona ve alt öğelerine ait olan kimlikleri raporlayın.

  • 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ı

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

HidDeviceInfo

Özellikler

  • koleksiyonlar

    HidCollectionInfo[]

    Bu cihazın rapor açıklayıcılarından ü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ı raporu boyutu.

  • productId

    sayı

    Ürün kimliği.

  • productName

    dize

    Chrome 46 ve sonraki sürümler

    Varsa cihazdan okunan ürün adı.

  • reportDescriptor

    ArrayBuffer

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

  • serialNumber

    dize

    Chrome 46 ve sonraki sürümler

    Cihazdan okunan seri numarası (varsa).

  • vendorId

    sayı

    Tedarikçi kimliği.

Yöntemler

connect()

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

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

Parametreler

İlerlemeler

  • Promise<HidConnectInfo>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

disconnect()

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

Cihazla olan bağlantıyı kesme. Bir cihazda bu çağrıdan sonra işlemlerin yapılması güvenlidir ancak herhangi bir etkisi yoktur.

Parametreler

  • connectionId

    sayı

    connect tarafından iade edilen connectionId.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getDevices()

Söz 
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

    Functions (isteğe bağlı)

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

    (devices: HidDeviceInfo[])=>void

İlerlemeler

  • Promise<HidDeviceInfo[]>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

receive()

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

Cihazdan bir sonraki giriş raporunu al.

Parametreler

  • connectionId

    sayı

    connect tarafından iade edilen connectionId.

  • 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 değeri.

    • veri

      ArrayBuffer

      Rapor verileri ve rapor kimliği öneki (varsa) kaldırılır.

receiveFeatureReport()

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

Cihazdan özellik raporu isteğinde bulunun.

Parametreler

  • connectionId

    sayı

    connect tarafından iade edilen connectionId.

  • reportId

    sayı

    Rapor kimliği veya yoksa 0.

  • geri çağırma

    Functions (isteğe bağlı)

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

    (data: ArrayBuffer)=>void

    • veri

      ArrayBuffer

      Cihaz tarafından gönderildiyse rapor kimliği öneki de dahil olmak üzere rapor verileri.

İlerlemeler

  • Promise<ArrayBuffer>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

send()

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

Cihaza çıkış raporu gönderin.

Not: data etiketine rapor kimliği öneki eklemeyin. Gerekirse eklenecektir.

Parametreler

  • connectionId

    sayı

    connect tarafından iade edilen connectionId.

  • reportId

    sayı

    Kullanılacak rapor kimliği veya yoksa 0.

  • veri

    ArrayBuffer

    Rapor verileri.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

sendFeatureReport()

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

Cihaza özellik raporu gönderin.

Not: data etiketine rapor kimliği öneki eklemeyin. Gerekirse eklenecektir.

Parametreler

  • connectionId

    sayı

    connect tarafından iade edilen connectionId.

  • reportId

    sayı

    Kullanılacak rapor kimliği veya yoksa 0.

  • veri

    ArrayBuffer

    Rapor verileri.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması 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. Hangi etkinliklerin yayınlandığına ilişkin bilgi için onDeviceAdded bölümüne bakın.

Parametreler

  • geri çağırma

    işlev

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

    (deviceId: number)=>void

    • deviceId

      sayı