Barcode Scanner Emulator
USB HID teenoor reeks-strepieskodeskandeerders
’n USB HID-sleutelbordwigskandeerder tik die gedekodeerde strepieskode in die gefokusde toepassing. ’n USB-reeksskandeerder stel ’n reekskoppelvlak bloot, dikwels as ’n virtuele COM-poort, en die toepassing moet daardie poort oopmaak en die grepe lees. USB is die kabel en die bus. HID en reeks is verskillende maniere om die data aan te bied.
Kies die koppelvlak wat die toepassing werklik kan lees. ’n Betaalveld wat reeds tik aanvaar, is ’n sleutelbordwigprobleem. ’n Diens wat skanderings moet ontvang terwyl geen teksveld gefokus is nie, of wat skandeerdergrepe apart van die sleutelbord moet hou, is ’n reeksprobleem. Baie skandeerders bied net een van daardie modusse. Sommige kan wissel. Die handleiding vir daardie model is die lys modusse wat jy kan toets.
Die gids HID-sleutelbordwig verduidelik die sleutelslagpad in besonderhede. Hoe werk strepieskodeskandeerders? dek vaslegging en dekodering. Hierdie bladsy vergelyk die twee gasheerkoppelvlakke en die toetse wat by elkeen hoort.
Wat is USB HID-sleutelbordwigmodus?
In USB HID-sleutelbordmodus tel die skandeerder as ’n sleutelbord op. Die bedryfstelsel laai sy gewone sleutelborddrywer. Ná ’n dekodering stuur die skandeerder die karakters as sleutelslae na watter kontrole ook al sleutelbordfokus het. ’n Webvorm, ’n POS-itemveld of ’n lessenaarsteksboks kan daardie invoer aanvaar sonder skandeerderspesifieke kode.
Fokus bepaal die bestemming. As die bedoelde veld nie gefokus is nie, beland die karakters in ’n ander kontrole of gaan hulle verlore. Die skandeerder klik nie, en dit skuif nie die wyser nie.
’n Opgestelde agtervoegsel kan die loonvrag volg. Enter dien baie enkelveldvorms in. Tab skuif fokus na die volgende kontrole. Nie een van die twee sleutels is gewaarborg nie. Agtervoegselkeuses word gedek in ENTER- teenoor TAB-agtervoegsels in strepieskodeskandeerders.
Gewone sleutelbordgebeure sluit nie die skandeerder se verkoper, reeksnommer of ’n vlag in wat sê die sleutels het van ’n skandeerder gekom nie. Blaaiers wat WebHID implementeer, weier steeds sleutelbordkoppelvlakke, so ’n bladsy kan nie die wigtoestel oopmaak en rou HID-verslae lees nie.
Wat is USB-reeks-strepieskodeskandeerdermodus?
In USB-reeksmodus tik die skandeerder nie. Dit stel ’n reekskoppelvlak oor USB bloot. Die bedryfstelsel bied daardie koppelvlak gewoonlik as ’n virtuele COM-poort aan: ’n COM-naam op Windows, ’n cu- of tty-toestel op macOS, of ’n ttyACM- of ttyUSB-toestel op Linux. Die naam word deur die drywer toegeken en kan verander nadat die skandeerder uitgeprop is.
’n Virtuele COM-poort is nie ’n fisiese RS-232-poort nie. RS-232 is ’n elektriese koppelvlak, met sy eie aansluiting en spanningsvlakke, wat ’n rekenaar deur ’n UART lees. USB-reeks gebruik ’n USB-kabel. Die toepassing maak steeds ’n reekspoort oop en lees grepe, maar die sein op die draad is USB. Sommige produkte is ’n ware RS-232-skandeerder plus ’n USB-na-reeks-adapter. Ander implementeer USB CDC en praat nooit RS-232 nie. Behandel die poort wat die bedryfstelsel vir jou wys as die integrasiepunt, en moenie aanneem dat die elektriese besonderhede ooreenstem nie.
Die toepassing maak die poort oop, lees die greepstroom en besluit waar ’n boodskap begin en eindig. ’n Algemene raam is die strepieskodeteks gevolg deur CR (0x0D), LF (0x0A), of CR en dan LF. Daardie raming is ’n toestelinstelling, nie ’n reël van USB nie. ’n Voorvoegselgreep soos STX is ook moontlik. Die gids oor voorvoegsel teenoor agtervoegsel skei daardie grepe van die Enter-sleutel wat ’n wigskandeerder stuur.
Baudtempo, databisse, pariteit en stopbisse maak saak op ’n ware UART en op baie USB-na-reeks-adapters. ’n Verkeerde tempo lewer deurmekaar karakters eerder as ’n skoon fout. Sommige USB CDC-virtuele COM-toestelle ignoreer die baudtempo wat die gasheer versoek en lewer steeds grepe. Daar is geen enkele instelling wat by elke virtuele reeksskandeerder pas nie. Gebruik die tempo en raming in daardie model se handleiding, en bevestig dit dan met ’n bekende strepieskode.
Die proses wat die poort oop hou, ontvang die data. Sleutelbordfokus kies nie die bestemming nie. ’n Ander program wat die poort reeds oop het, blokkeer ’n tweede oopmaak. As die skandeerder uitgeprop word, verdwyn die poort. As dit weer ingeprop word, kan dit ’n nuwe naam skep, en die toepassing moet daardie poort weer oopmaak.
HID teenoor reeks
| Kenmerk | HID-sleutelbordwig | USB-reeks |
|---|---|---|
| Datalevering | Sleutelbordstyl-invoer | Reeksgreepstroom |
| Invoerfokus vereis | Ja. Sleutelslae volg die gefokusde kontrole | Nee. Grepe gaan na die proses wat die poort oopgemaak het |
| Blaaierintegrasie | Gewone invoer en sleutelbordgebeure | Web Serial waar die blaaier dit ondersteun, of sagteware buite die bladsy |
| Toepassingsbeheer | Beperk tot sleutelbordgedrag, fokus en agtervoegsels | Die toepassing lees en raam die stroom |
| Toestelidentifikasie | Nie beskikbaar uit gewone sleutelbordgebeure nie | Die bedryfstelsel kan ’n poortnaam wys. Stabiele identiteit hang steeds van die drywer af |
| Opstelling | Skandeerderinstellings, insluitend agtervoegsel en sleutelborduitleg | Skandeerderinstellings plus die gasheerpoortinstellings wat die toestel werklik gebruik |
| Tipiese gebruik | Vorms en POS-iteminvoer | Toegewyde integrasies wat die toestel besit |
Dit is die gewone gevalle. ’n Gegewe model, bedryfstelsel en drywer kan verskil. ’n Bluetooth-skandeerder in HID-sleutelbordmodus volg die wigkolom op die toepassingslaag. Bluetooth SPP volg die reekskolom.
Hoe HID-skandeerders in webtoepassings werk
’n Wigskandering werk die gefokusde element by. Drukbare karakters vuur keydown en dan input. Enter en Tab vuur keydown en voeg nie ’n karakter in ’n gewone teksinvoer in nie. event.key is "Enter" of "Tab" vir daardie sleutels, en ’n eenkarakterstring vir ’n drukbare karakter. event.code benoem die fisiese sleutel en kan dieselfde bly wanneer ’n sleutelborduitleg wat nie ooreenstem nie event.key verander.
Die luisteraar hieronder dien die veld net in wanneer Enter aankom. ’n Skandeerder sonder ’n Enter-agtervoegsel los die teks in die veld.
const field = document.querySelector('#barcode')
if (!(field instanceof HTMLInputElement)) {
throw new Error('Barcode field was not found.')
}
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Fokus #barcode voor die skandering. preventDefault() keer dat ’n ouervorm ’n tweede keer indien. As die skandeerder Tab stuur, lees die waarde in daardie keydown en laat die blaaier fokus skuif. As dit nie een van die twee stuur nie, dien die veld in vanaf ’n knoppie of ’n ander uitdruklike handeling. ’n Pouse in tik is net ’n heuristiek vir die einde van ’n skandering.
Niks in daardie gebeure identifiseer die USB-toestel nie. ’n Persoon, ’n makro of die emulator kan dieselfde volgorde lewer. Validasie hoort op die loonvrag. Die blaaierwerkvloei, insluitend Tab en leë invoer, is in Hoe om strepieskodeskandeerders in webtoepassings te toets.
Hoe reeksskandeerders in toepassings werk
’n Reeksintegrasie maak ’n poort oop, lees grepe, verdeel hulle in boodskappe en hanteer dat die poort verdwyn. Op die lessenaar is dit die bedryfstelsel se reeks-API of ’n verkoperbiblioteek. In ’n blaaier is die enigste ingeboude opsie die Web Serial API, en net in blaaiers wat dit implementeer.
Web Serial is beskikbaar in Chromium-gebaseerde blaaiers. Firefox en Safari verskaf dit nie. Die bladsy moet ’n veilige konteks wees, wat HTTPS of localhost beteken. requestPort() moet vanaf ’n gebruikergebaar loop, en die gebruiker moet die poort in die blaaier se keusevenster kies. ’n Sleutelbordwigskandeerder verskyn nie in daardie lys nie, want dit is nie ’n reekstoestel nie. Web Serial kan ook nie ’n reekspoort sien wat die bedryfstelsel nie blootgestel het nie.
Die baudtempo in die voorbeeld is ’n beginpunt wat jy met die handleiding se waarde vervang. Die lus behandel CR of LF as die einde van ’n boodskap en verbruik ’n CRLF-paar as een afsluiter. As jou skandeerder ’n ander raam gebruik, is hierdie verdeling verkeerd selfs wanneer die poort oop is.
<button id="open-serial" type="button">Open scanner port</button>
<p id="status" role="status"></p>
<script>
const button = document.querySelector('#open-serial')
const status = document.querySelector('#status')
function takeLine(buffer) {
const cr = buffer.indexOf('\r')
const lf = buffer.indexOf('\n')
const end = cr < 0 ? lf : lf < 0 ? cr : Math.min(cr, lf)
if (end < 0) {
return null
}
const line = buffer.slice(0, end).trim()
let rest = buffer.slice(end + 1)
if (buffer[end] === '\r' && rest.startsWith('\n')) {
rest = rest.slice(1)
}
return { line, rest }
}
button.addEventListener('click', async () => {
if (!('serial' in navigator)) {
status.textContent = 'This browser does not provide Web Serial.'
return
}
let port
try {
port = await navigator.serial.requestPort()
await port.open({ baudRate: 9600 })
} catch (error) {
status.textContent = 'The port was not opened.'
return
}
const reader = port.readable.getReader()
const decoder = new TextDecoder()
let buffer = ''
try {
while (true) {
const { value, done } = await reader.read()
if (done) {
break
}
buffer += decoder.decode(value, { stream: true })
let next = takeLine(buffer)
while (next) {
if (next.line) {
status.textContent = next.line
}
buffer = next.rest
next = takeLine(buffer)
}
}
} catch (error) {
status.textContent = 'The serial read stopped.'
} finally {
reader.releaseLock()
await port.close()
}
})
</script>
Die leeslus loop totdat die stroom eindig of die lees misluk. As die skandeerder uitgeprop word, verwerp dit tipies die lees. releaseLock() en close() loop in finally. Voorheen goedgekeurde poorte vir hierdie oorsprong kan met navigator.serial.getPorts() gelys word sonder om die keusevenster weer te wys. Die eerste goedkeuring vereis steeds die gebruiker.
’n Lessenaartoepassing volg dieselfde idee met die platform se reeks-API: maak oop, lees, raam, en maak weer oop nadat die toestel terugkeer. Hierdie bladsy bedink nie verkoperopdragte nie. As die skandeerder ’n eie protokol verwag, staan daardie protokol in die vervaardiger se dokumentasie.
Watter is beter: HID of reeks?
Geen modus is vir elke produk beter nie. Gebruik die modus wat die skandeerder werklik bied en die modus wat die toepassing kan lees.
Kies HID wanneer
- Die toepassing reeds sleutelbordinvoer in ’n gefokusde veld aanvaar.
- Jy ’n vorm of POS-skerm sonder toestelkode wil laat werk.
- Die werkvloei fokus voor elke skandering kan waarborg.
- Enter of Tab pas by hoe daardie vorm indien of vorder.
Oorweeg reeks wanneer
- Skanderings moet aankom terwyl fokus in ’n dialoog, op ’n knoppie of nêrens is.
- Skandeerdergrepe apart van tik moet bly.
- Die toepassing ’n poort kan oopmaak, boodskappe kan raam en kan herstel wanneer die toestel uitgeprop word.
- Die gasheer toestemming tot daardie poort kan verleen en geen ander proses dit terselfdertyd nodig het nie.
’n Skandeerder wat net as ’n sleutelbord optel, kan nie in sagteware op die gasheer na reeks oorgeskakel word nie. Bevestig die modusse in die handleiding voordat jy die integrasie ontwerp.
Wissel tussen HID en reeks
Sommige skandeerders verander modus wanneer jy ’n opstellingstrepieskode uit daardie vervaardiger se handleiding skandeer, of wanneer jy ’n profiel met die verkoper se nutsprogram skryf. Ander is as een koppelvlak gebou en het niks om te wissel nie.
Daar is geen opstellingstrepieskode wat elke handelsmerk verander nie. ’n Volgorde wat vir ’n ander model gedruk is, kan niks doen nie, of dit kan die skandeerder in ’n onverwagte modus laat. Ná enige verandering, kyk wat die bedryfstelsel wys: ’n sleutelbord, ’n COM-poort, of albei. Toets dan die pad wat jou toepassing gebruik. Die Gids vir strepieskodeskandeerderopstelling beskryf die gewone instellingsgroepe. Dit vervang nie die handleiding nie.
Toets ’n HID-skandeerder
- Koppel die skandeerder en bevestig dat dit in sleutelbordwigmodus is. ’n Teksredigeerder behoort karakters te ontvang wanneer ’n veld in daardie redigeerder gefokus is.
- Maak die Strepieskode-invoertoetser oop.
- Klik Begin toets, of klik die skandeerarea. Dit word blou wanneer dit gereed is. Die bladsy neem nie self fokus nie.
- Skandeer ’n strepieskode waarvan jy die loonvrag reeds ken.
- Vergelyk die vasgevange waarde en die karaktertelling met daardie loonvrag.
- Lees die agtervoegsel: ENTER, TAB of Geen. Enter en Tab is nie deel van die strepieskodestring nie.
Die toetser teken sleutelbordgebeure aan wat die blaaier kan sien. Dit kan nie ’n reekspoort lees nie, en dit kan nie die USB-toestel identifiseer nie. Wanneer die gemiddelde gaping tussen karakters onder 100 ms is, rapporteer dit daardie tydsberekening. Die tydsberekening is nie ’n hardeware-identifikasie nie. Vir elke keydown, insluitend key en code, gebruik die Sleutelbordgebeurtenistoetser. ’n Breër QA-ronde is in Hoe om strepieskodeskandeerderinvoer te toets.
Toets ’n reeksskandeerder
Die Strepieskode-invoertoetser maak nie ’n COM-poort oop nie. ’n Reekstoets het ’n program nodig wat die poort kan oopmaak wat die skandeerder blootstel.
- Bevestig dat die skandeerder in ’n reeksmodus is en dat die bedryfstelsel ’n poort lys wanneer dit gekoppel is. Prop dit uit en kontroleer dat die poort verdwyn.
- Noteer die poortnaam. Dit is bedryfstelselspesifiek en kan by die volgende inprop verander.
- Maak die poort oop vanuit ’n versoenbare toepassing: ’n reeksterminaal, jou lessenaartoepassing, of die Web Serial-voorbeeld hierbo in ’n Chromium-blaaier op HTTPS of localhost.
- Stel baudtempo, databisse, pariteit en stopbisse wanneer die handleiding dit spesifiseer. Slaan uitgedinkte waardes oor.
- Skandeer ’n bekende strepieskode.
- Vergelyk die grepe of die gedekodeerde teks met daardie loonvrag.
- Kontroleer die raming. Soek ’n voorvoegsel, en CR, LF of CRLF ná die data, net as dit is wat die handleiding opgestel het.
As die poort nie oopmaak nie omdat dit besig is, maak die ander program toe wat dit hou. As die teks deurmekaar is, stem die lyninstellings nie met die toestel ooreen nie. As die poort nooit verskyn nie, kan die skandeerder steeds in sleutelbordmodus wees, kan die drywer ontbreek, of mag die bedryfstelselgebruiker nie reekstoestelle oopmaak nie.
Algemene probleme
Die skandeerder werk in ’n teksredigeerder en nie in die teikentoepassing nie. Die toestel tik. Die teiken het nie fokus nie, of ’n keydown-luisteraar gooi die sleutels weg. Begin met Skandeerder werk in Notepad maar nie in POS nie.
Die skandeerder tik in geen teksveld nie. Dit kan in reeksmodus wees, afgeskakel wees, of die simbool nie lees nie. ’n Skandeerder in reeksmodus tik nie. Soek ’n COM-poort voordat jy die veld ontfout. Strepieskodeskandeerder werk nie skei ’n dooie skandeerder van die verkeerde koppelvlak.
Die reekspoort ontbreek. Sleutelbordmodus skep nie ’n COM-poort nie. ’n Ontbrekende drywer, ’n kabel wat net laai, of ’n skandeerder sonder reeksmodus lewer dieselfde simptoom. Kyk na die bedryfstelsel se toestellys terwyl jy die skandeerder inprop.
Die reekspoort is reeds in gebruik. Net een proses kan dit lees. Maak die terminaal of die ander kopie van die toepassing toe, en maak dit dan weer oop.
Die kommunikasie-instellings is verkeerd. Baud, pariteit of stopbisse wat nie ooreenstem nie, lyk soos ewekansige karakters. Stel die waardes uit die handleiding vir daardie model, en skandeer dan weer ’n bekende kode.
ENTER of TAB kom nooit aan nie. Dit is ’n wig-agtervoegselinstelling. Die invoertoetser rapporteer Geen. Sien Strepieskodeskandeerder se ENTER ontbreek en die agtervoegselgids hierbo. ’n Reeksskandeerder stuur nie die Enter-sleutel nie. Dit kan CR- of LF-grepe stuur.
Karakters is verkeerd op ’n wigskandeerder. Die skandeerder se sleutelborduitleg en die bedryfstelseluitleg kan verskil. Reeksgrepe word nie deur daardie uitleg herkarteer nie. Sien Verkeerde sleutelborduitleg op die strepieskodeskandeerder.
Die blaaier kan nie by die skandeerder uitkom nie. ’n Wigskandeerder verskyn nie in die Web Serial-keusevenster nie. Firefox en Safari het geen Web Serial API nie. ’n Bladsy wat nie HTTPS of localhost is nie, kan dit nie gebruik nie. Die gebruiker kan die poortkeuse ook toemaak.
Die toepassing verloor die skandeerder nadat dit uitgeprop is. ’n Wigskandeerder keer terug as ’n sleutelbord, en die volgende skandering vereis steeds fokus. ’n Reekspoort is weg totdat die toepassing die nuwe poort oopmaak. Die naam stem dalk nie met die vorige een ooreen nie.
Integrasiescenario's
Webtoepassings
Sleutelbordwig pas by ’n gefokusde invoer en gewone DOM-gebeure. Reekstoegang binne die bladsy beteken Web Serial in ’n ondersteunende blaaier, ’n veilige konteks en ’n poort wat die gebruiker gekies het. ’n Bladsy wat Firefox, Safari en onbemande kiosks moet ondersteun, kan nie net op Web Serial staatmaak nie. ’n Plaaslike helper kan die COM-poort besit en voltooide strepieskodes na die bladsy aanstuur. Daardie helper is aparte sagteware. Die bladsy moet steeds nie verwag dat ’n wigtoets dit sal oefen nie.
POS-stelsels
’n POS wat fokus in die itemveld plaas en op Enter indien, is ’n wigintegrasie. ’n POS wat moet skandeer terwyl ’n modaal oop is, of wat die sleutelbord moet ignoreer, is ’n reeksintegrasie. As jy hulle meng, beland skanderings in die verkeerde veld of kom hulle nooit aan nie. Pas die skandeerdermodus by die skerm wat werklik aan diens is.
Lessenaartoepassings
’n Lessenaartoepassing kan wiginvoer aanvaar in watter kontrole ook al gefokus is, of dit kan die virtuele COM-poort oopmaak en ’n sessie hou vir die leeftyd van die proses. Poortbesit, herverbinding en raming is deel van daardie sessie. Fokus is dit nie.
QA-outomatisering
Die Barcode Scanner Emulator tik ’n waarde wat jy kies in die gefokusde toepassing en kan ENTER, TAB of geen agtervoegsel stuur. Dit dek sleutelbordwigregressies: fokus, validering en agtervoegselhantering. Dit skep nie ’n virtuele COM-poort nie, tel nie USB-toestelle op nie en reproduseer nie baud en raming nie. Reekstoetse het steeds ’n reekspoort en ’n leser nodig, of ’n toetsdubbel wat dieselfde greepraming skryf wat jou toepassing ontleed.
Kiosktoepassings
’n Kiosk wat wiginvoer gebruik, moet die skandeerveld gefokus hou oor dialoë, skermbewaarders en foutboodskappe. Een verlore fokus en die volgende skandering tref ’n kortpad of niks. ’n Kiosk wat reeks gebruik, kan die poort sonder daardie fokus lees, en dit moet toestemming tot die toestel hou en die poort weer oopmaak ná kragverlies of ’n kabel wat uitgetrek word.
Waar die Barcode Scanner Emulator inpas
Die Barcode Scanner Emulator is ’n lessenaartoepassing vir Windows, macOS en Linux. Dit reproduseer die sleutelbordpad wat ’n wigskandeerder gebruik. Jy voer die teks in, kies ’n tikvertraging, en kies ’n agtervoegsel van geen, ENTER of TAB. ’n Globale kortpad tik daardie teks in die gefokusde toepassing.
Gebruik dit om HID-stylvorms te ontwikkel en regressietoetse te doen wanneer die skandeerder nie op die lessenaar is nie. Gebruik dit saam met die Strepieskode-invoertoetser om die waarde, voorvoegselsleutels en agtervoegsel te sien wat die blaaier ontvang het.
Dit emuleer nie ’n USB-reekstoestel, ’n virtuele COM-poort, USB-optelling of ’n optiese dekodering nie. Daardie gedrag behoort steeds aan hardeware, of aan ’n reekstoetsdubbel wat jy beheer.