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
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ümlerVarsa 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ümlerCihazdan okunan seri numarası (varsa).
-
vendorId
sayı
Tedarikçi kimliği.
Yöntemler
connect()
chrome.hid.connect(
deviceId: number,
callback?: function,
)
İletişim için bir HID cihazının bağlantısını açın.
Parametreler
-
deviceId
sayı
Açılacak cihazın
HidDeviceInfo.deviceId
. -
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(connection: HidConnectInfo) => void
-
bağlantı
-
İlerlemeler
-
Promise<HidConnectInfo>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
disconnect()
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 edilenconnectionId
. -
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getDevices()
chrome.hid.getDevices(
options: GetDevicesOptions,
callback?: function,
)
Bağlı HID cihazlarını numaralandırma.
Parametreler
-
seçenekler
Hedef cihazlarda aranacak özellikler.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(devices: HidDeviceInfo[]) => void
-
cihaz
-
İlerlemeler
-
Promise<HidDeviceInfo[]>
Chrome 117 ve sonraki sürümlerVaatler 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 edilenconnectionId
. -
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()
chrome.hid.receiveFeatureReport(
connectionId: number,
reportId: number,
callback?: function,
)
Cihazdan özellik raporu isteğinde bulunun.
Parametreler
-
connectionId
sayı
connect
tarafından iade edilenconnectionId
. -
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
send()
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 edilenconnectionId
. -
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
sendFeatureReport()
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 edilenconnectionId
. -
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ümlerVaatler 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
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(device: HidDeviceInfo) => void
-
cihaz
-
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ı
-