chrome.hid

Açıklama

Bağlı HID cihazlarıyla etkileşim kurmak için chrome.hid API'sini kullanın. Bu API, bir uygulamanın bağlamı içinden HID işlemlerine erişim sağlar. Uygulamalar, bu API'yi kullanarak donanım cihazları için sürücü olarak işlev görebilir. 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ımlanmamış olur.

İzinler

hid

Türler

DeviceFilter

Özellikler

  • productId

    number isteğe bağlı

    Cihaz ürün kimliği yalnızca satıcı kimliği eşleşiyorsa kontrol edilir.

  • kullanım

    number isteğe bağlı

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

  • usagePage

    number isteğe bağlı

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

  • vendorId

    number isteğe bağlı

    Cihaz tedarikçi 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 izin verdiği tüm cihazları döndürür.

  • productId

    number isteğe bağlı

    Kullanımdan kaldırıldı

    DeviceFilter.productId ayarını yapmaya eşdeğerdir.

  • vendorId

    number isteğe bağlı

    Kullanımdan kaldırıldı

    DeviceFilter.vendorId ayarını yapmaya eşdeğerdir.

HidCollectionInfo

Özellikler

  • reportIds

    number[]

    Koleksiyona ve alt öğelerine ait kimlikleri bildirin.

  • 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 tanımlayıcılarındaki üst düzey koleksiyonlar.

  • deviceId

    sayı

    Opak cihaz kimliği.

  • maxFeatureReportSize

    sayı

    Üst düzey koleksiyonun maksimum hata raporu boyutu.

  • maxInputReportSize

    sayı

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

  • maxOutputReportSize

    sayı

    Üst düzey koleksiyonun maksimum çıkış raporu boyutu.

  • productId

    sayı

    Ürün kimliği.

  • productName

    dize

    Chrome 46 veya daha yeni bir sürüm

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

  • reportDescriptor

    ArrayBuffer

    Ham cihaz raporu tanımlayıcısı (Windows'da kullanılamaz).

  • serialNumber

    dize

    Chrome 46 veya daha yeni bir sürüm

    Cihazdan okunan seri numarası (varsa).

  • vendorId

    sayı

    Tedarikçi kimliği.

Yöntemler

connect()

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

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

Parametreler

İadeler

  • Promise<HidConnectInfo>

    Chrome 117 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

disconnect()

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

Bir cihazla bağlantıyı kesme Bu işlev çağrıldıktan sonra bir cihazda işlemlerin başlatılması güvenlidir ancak herhangi bir etkisi olmaz.

Parametreler

  • connectionId

    sayı

    connect tarafından iade edilen connectionId.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 117 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getDevices()

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

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

Parametreler

İadeler

  • Promise<HidDeviceInfo[]>

    Chrome 117 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

receive()

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

Cihazdan bir sonraki giriş raporunu alın.

Parametreler

  • connectionId

    sayı

    connect tarafından iade edilen connectionId.

  • callback

    işlev

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

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

    • reportId

      sayı

      Rapor kimliği veya yoksa 0.

    • aktarma

      ArrayBuffer

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

receiveFeatureReport()

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

Cihazdan özellik raporu isteyin.

Parametreler

  • connectionId

    sayı

    connect tarafından iade edilen connectionId.

  • reportId

    sayı

    Rapor kimliği veya yoksa 0.

  • callback

    işlev isteğe bağlı

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

    (data: ArrayBuffer) => void

    • aktarma

      ArrayBuffer

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

İadeler

  • Promise<ArrayBuffer>

    Chrome 117 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

send()

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

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

Not: data içine rapor kimliği öneki eklemeyin. Gerekirse eklenir.

Parametreler

  • connectionId

    sayı

    connect tarafından iade edilen connectionId.

  • reportId

    sayı

    Kullanılacak rapor kimliği veya yoksa 0.

  • aktarma

    ArrayBuffer

    Rapor verileri.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 117 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

sendFeatureReport()

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

Cihaza özellik raporu gönderme

Not: data içine rapor kimliği öneki eklemeyin. Gerekirse eklenir.

Parametreler

  • connectionId

    sayı

    connect tarafından iade edilen connectionId.

  • reportId

    sayı

    Kullanılacak rapor kimliği veya yoksa 0.

  • aktarma

    ArrayBuffer

    Rapor verileri.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 117 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Etkinlikler

onDeviceAdded

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

Bir cihaz sisteme eklendiğinde oluşturulan etkinlik. Etkinlikler yalnızca cihaza erişim izni olan uygulamalara 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 teslim edildiğini görmek için onDeviceAdded bölümüne bakın.

Parametreler

  • callback

    işlev

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

    (deviceId: number) => void

    • deviceId

      sayı