ወደ ይዘት ዝለል

Barcode Scanner Emulator

በድር መተግበሪያዎች ውስጥ የQR ኮድ ስካነር ግቤትን እንዴት መሞከር እንደሚቻል

ብዙ ውጫዊ QR የሚችሉ ስካነሮች የቁልፍ ሰሌዳ ዌጅ ሁነታን ይጠቀማሉ እና የተፈታውን የQR ጽሑፍ ትኩረት ባለው መስክ ውስጥ ይተይባሉ። የታወቀ ጭነት በመቃኘት እና ገጹ ከተቀበለው እሴት ጋር በማነጻጸር ያንን መንገድ ይሞክሩ። እያንዳንዱ የQR ስካነር እንደ ቁልፍ ሰሌዳ አይተይብም። ተከታታይ መሣሪያዎች እና የካሜራ ፈቺዎች የተለዩ ውህደቶች ናቸው፣ የአሳሽ የቁልፍ ሰሌዳ ክስተቶችም አካላዊውን ስካነር አይለዩም።

የQR ኮድ ውሂብ ያከማቻል። ስካነሩ፣ ወይም የካሜራ ፈቺ፣ ያንን ውሂብ ወደ ጽሑፍ ይለውጠዋል። የድር መተግበሪያው ያንን ጽሑፍ መቀበል፣ ቅኝቱ መቼ እንደተጠናቀቀ መወሰን እና ማረጋገጥ አለበት። ይህ መመሪያ ያ የመተግበሪያ ሙከራ ነው። መለያዎችን ማመንጨት፣ ንጽጽርን መመርመር እና መሣሪያ QR Code መፍታት እንደሚችል ማረጋገጥ በየQR ኮድ ሙከራ፦ የQR ኮድ ስካነሮችን እንዴት መሞከር እንደሚቻል ተሸፍኗል። የEAN ቁጥጥር አሃዞችን ጨምሮ አጠቃላይ የባርኮድ ቅጾች በበድር መተግበሪያዎች ውስጥ የባርኮድ ስካነሮችን እንዴት መሞከር እንደሚቻል ተሸፍነዋል።

የQR ስካነር ግቤትን በ60 ሰከንድ ይሞክሩ

የተሳሳተ ቁምፊ ግልጽ እንዲሆን እርስዎ የመረጡትን ጭነት ይጠቀሙ። ይህ የእርምጃ መመሪያ QR-INPUT-TEST-12345 ይጠቀማል።

  1. የQR ኮድ ማመንጫ ይክፈቱ እና ለQR-INPUT-TEST-12345 የQR ኮድ ያመንጩ። ማመንጫው በአሳሹ ውስጥ ይሠራል። ስካነሩን አያነጋግርም።
  2. በቁልፍ ሰሌዳ ዌጅ ሁነታ የተቀናበረ QR የሚችል ስካነር ያገናኙ። 1D ብቻ የሆነ ስካነር ይህን ምልክት መፍታት አይችልም።
  3. የባርኮድ ግቤት ሞካሪ ይክፈቱ።
  4. ሙክራ ይጀምሩን ጠቅ ያድርጉ፣ ወይም መስኩ ትኩረት እንዲኖረው የቅኝት ቦታውን ጠቅ ያድርጉ። ሞካሪው ትኩረትን በራሱ አይወስድም፣ ስካነሩንም አይከፍትም።
  5. የQR ኮዱን ይቃኙ።
  6. የተያዘውን ጽሑፍ እና የቁምፊ ብዛት ያንብቡ።
  7. ያንን ጽሑፍ ከQR-INPUT-TEST-12345 ጋር ያነጻጽሩ። ተዛማጁ የፊደል ቅርጽን፣ ሰረዞችን እና ርዝመትን ያካትታል።
  8. ቅጥያውን ያንብቡ። ስካነሩ ከእነዚህ ቁልፎች አንዱን ሲልክ ሞካሪው ENTER፣ TAB ወይም የለም ሪፖርት ያደርጋል።

ሞካሪው አሳሹ ሊያያቸው የሚችላቸውን የቁልፍ ሰሌዳ ክስተቶች ይመዘግባል። የUSB መሣሪያውን አይለይም፣ ተከታታይ ወደብ አያነብም፣ የQR ምስሉንም አይፈታም።

የQR ስካነር የግቤት ሁነታዎች

አንድ የታተመ የQR ኮድ በሦስት የተለያዩ ውህደቶች ሊደርስ ይችላል። የአንድ ሁነታ ሙከራ ሌሎቹን አይለማመድም።

የቁልፍ ሰሌዳ ዌጅ የQR ስካነሮች

በUSB HID የቁልፍ ሰሌዳ ሁነታ፣ ወይም በBluetooth HID የቁልፍ ሰሌዳ ሁነታ፣ ስርዓተ ክወናው ስካነሩን እንደ ቁልፍ ሰሌዳ ይቆጥረዋል። ከመፍታት በኋላ ስካነሩ ጭነቱን ትኩረት ወዳለው መቆጣጠሪያ ይተይባል። መደበኛ <input> ወይም <textarea> ሊቀበለው ይችላል። ገጹ መሣሪያውን አይከፍትም። የHID የቁልፍ ሰሌዳ ዌጅ መመሪያ የቁልፍ ጭነት ቅደም ተከተልን፣ ቅድመ ቅጥያዎችን እና ቅጥያዎችን ይገልጻል።

ትኩረት መድረሻውን ይወስናል። ትኩረት ያለው አካል የሰነዱ አካል፣ አዝራር ወይም ሌላ ፍሬም ከሆነ፣ የዚህ መስክ አድማጮች ቅኝቱን አያዩም።

ተከታታይ የQR ስካነሮች

የUSB ተከታታይ ወይም ምናባዊ የCOM ወደብ ስካነር የተፈታውን ጽሑፍ እንደ ባይቶች ወደቡን ለከፈተው ሂደት ይልካል። ትኩረት ያንን ሂደት አይመርጥም። የቁልፍ ጭነቶችን ብቻ የሚያዳምጥ መስክ ባዶ ሆኖ ይቆያል፣ በዚያ ወደብ ላይ ያለ ተርሚናል ግን ጭነቱን ያሳያል።

በChromium ላይ የተመሠረቱ አሳሾች በደህንነቱ በተጠበቀ አውድ ውስጥ፣ ከተጠቃሚ ምልክት በኋላ፣ ተጠቃሚው የመረጠውን ወደብ በWeb Serial API መክፈት ይችላሉ። Firefox እና Safari ያንን API አይሰጡም። የዌጅ ስካነር እንደ ተከታታይ ወደብ አይታይም። የወደብ ስሞች፣ baud እና ፍሬሚንግ በመሣሪያው እና በድራይቨሩ ይወሰናሉ። USB HID ከተከታታይ ባርኮድ ስካነሮች ጋር ሁለቱን በይነገጾች ያነጻጽራል። የባርኮድ ግቤት ሞካሪ የCOM ወደብ ማንበብ አይችልም።

በካሜራ ላይ የተመሠረተ የQR ቅኝት

የካሜራ ውህደት ምስል ይይዛል እና የQR ኮዱን በሶፍትዌር ይፈታል። ገጹ የካሜራ API እና ፈቺ ይጠቀማል። ለጭነቱ የkeydown ክስተቶችን አይቀበልም። የስልክ ካሜራ መተግበሪያዎች፣ በገጽ ውስጥ ያሉ የካሜራ አዝራሮች እና ወደ መስክ የሚተይብ የሃርድዌር ኢሜጀር ሦስት የተለያዩ ምርቶች ናቸው። የዌጅ ሙከራ ማለፍ የካሜራ አዝራሩ ይሠራል ማለት አይደለም፣ የተሳካ የካሜራ መፍታትም የዌጅ ስካነር ተመሳሳይ ሕብረ ቁምፊ ይተይባል ማለት አይደለም።

የQR ስካነር ግቤትን በJavaScript መያዝ

ከታች ያለው ገጽ አንድ ትኩረት ያለው መስክ ያነባል። Enter ቅጹን ያስገባል፣ የAccept አዝራርም ተመሳሳይ የsubmit ተቆጣጣሪ ይጠቀማል፣ ስለዚህ አንድ ቅኝት አንድ ጊዜ ይሠራል። የENTER ቅጥያ ከሌለ፣ አንድ ሰው Accept እስኪያንቀሳቅስ ድረስ ጽሑፉ በመስኩ ውስጥ ይቆያል። የተያዘው ጭነት በtextContent ይጻፋል፣ ስለዚህ እንደ < ያሉ ቁምፊዎች እንደ ጽሑፍ ይታያሉ።

ምሳሌው ሦስት የመተግበሪያ ቅርጸቶችን ይቀበላል፦ እንደ QR-INPUT-TEST-12345 ያለ የቲኬት መለያ፣ http ወይም https URL፣ ወይም የJSON ነገር። የተቃኘውን ጽሑፍ ይመዘግባል። በQR ኮዱ ውስጥ ወደተገኘ URL አይሄድም። Enter የማይልክ ስካነር አሁንም በአዝራሩ በኩል ይሠራል። ስክሪፕቱ አያጠምደውምና Tab እንደተለመደው በመለያው፣ በመስኩ እና በአዝራሩ ውስጥ ያልፋል።

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>QR input example</title>
</head>
<body>
  <form id="qr-form">
    <label for="qr">QR payload</label>
    <input id="qr" name="qr" type="text" autocomplete="off" spellcheck="false">
    <button type="submit">Accept</button>
  </form>
  <p id="status" role="status"></p>
  <pre id="captured"></pre>
  <script>
    const form = document.querySelector('#qr-form')
    const field = document.querySelector('#qr')
    const status = document.querySelector('#status')
    const captured = document.querySelector('#captured')

    if (
      !(form instanceof HTMLFormElement) ||
      !(field instanceof HTMLInputElement) ||
      !(status instanceof HTMLElement) ||
      !(captured instanceof HTMLElement)
    ) {
      throw new Error('QR form markup is missing.')
    }

    const accepted = new Set()

    function classify(raw) {
      if (/[\u0000-\u001F\u007F]/.test(raw)) {
        return { status: 'invalid', message: 'Control character in the QR payload.' }
      }

      const value = raw.trim()
      if (!value) {
        return { status: 'empty' }
      }
      if (value.length > 2048) {
        return { status: 'invalid', message: 'QR payload is longer than this form accepts.' }
      }
      if (/^QR-[A-Z0-9-]{1,64}$/.test(value)) {
        return { status: 'ok', value }
      }
      if (value.startsWith('{')) {
        try {
          const data = JSON.parse(value)
          if (!data || typeof data !== 'object' || Array.isArray(data)) {
            return { status: 'invalid', message: 'QR JSON must be an object.' }
          }
          return { status: 'ok', value }
        } catch {
          return { status: 'invalid', message: 'QR text is not valid JSON.' }
        }
      }
      if (value.startsWith('http://') || value.startsWith('https://')) {
        try {
          const url = new URL(value)
          if (url.protocol !== 'http:' && url.protocol !== 'https:') {
            return { status: 'invalid', message: 'Only http and https URLs are accepted.' }
          }
          return { status: 'ok', value }
        } catch {
          return { status: 'invalid', message: 'The QR text is not a valid URL.' }
        }
      }
      return { status: 'invalid', message: 'Unexpected QR payload.' }
    }

    form.addEventListener('submit', (event) => {
      event.preventDefault()
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        status.textContent = 'No QR payload received.'
        field.focus()
        return
      }
      if (outcome.status === 'invalid') {
        status.textContent = outcome.message
        captured.textContent = ''
        field.focus()
        return
      }
      if (accepted.has(outcome.value)) {
        status.textContent = 'Already accepted ' + outcome.value
        field.value = ''
        field.focus()
        return
      }
      accepted.add(outcome.value)
      captured.textContent = outcome.value
      status.textContent = 'Accepted ' + outcome.value
      field.value = ''
      field.focus()
    })
  </script>
</body>
</html>

ፋይሉን ያስቀምጡ እና በዴስክቶፕ አሳሽ ውስጥ ይክፈቱት። ከመቃኘትዎ በፊት መስኩን ጠቅ ያድርጉ። autocomplete="off" የተቀመጠ እሴት ቅኝቱን የመተካት ዕድልን ይቀንሳል። መለያው እና አዝራሩ ይገኛሉ፣ ስለዚህ ሰው ያለ ስካነር ጭነት መተየብ ይችላል።

Enterን በቅጹ submit ክስተት ብቻ ይያዙ። ለEnter ሁለተኛ keydown አድማጭ ተመሳሳይ ቅኝትን ሁለት ጊዜ ይመዘግባል። preventDefault() አሳሹን በዚህ ገጽ ላይ ያቆያል። ቀጣዩ ቅኝት ወደ ቀዳሚው ጽሑፍ እንዳይጨምር ከውሳኔ በኋላ መስኩን ያጽዱ።

የQR ጭነት የመስመር እረፍት ሊይዝ ይችላል። የዌጅ ስካነር ያንን እረፍት ብዙውን ጊዜ እንደ Enter ይተይባል። በአንድ መስመር ግቤት ውስጥ ቅጹ በመጀመሪያው መስመር ሊያስገባ እና ቀሪውን ሊጥል ይችላል። መተግበሪያው ባለብዙ መስመር ጽሑፍ መቀበል ሲኖርበት textarea ወይም ባይቶቹን የሚይዝ ተከታታይ አንባቢ ይጠቀሙ። ያንን ባህሪ ጭነቱ አዲስ መስመር የያዘ የQR ኮድ በመጠቀም ያረጋግጡ።

የQR ጭነቶችን መያዝ

የQR ምልክት የመተግበሪያ ቅርጸት አይገባም። ተመሳሳይ ምልክት ሥርዓት ከእነዚህ ማንኛውንም ሊሸከም ይችላል፦

  • እንደ QR-INPUT-TEST-12345 ያለ ቀላል ጽሑፍ።
  • URL።
  • መተግበሪያው የመረጠው መለያ።
  • እንደ የቲኬት ቁጥር እና የቦታ ኮድ ያለ የተዋቀረ ጭነት።
  • መተግበሪያው ያንን ኮድ ሲገልጽ የJSON ጽሑፍ።

ስካነሩ የተፈቱትን ቁምፊዎች ያስተላልፋል። ከቲኬት ደንብ፣ ከምርት ካታሎግ ወይም ከJSON ስኪማ ጋር እንደሚዛመዱ አያረጋግጥም። ሕብረ ቁምፊውን በገጹ ላይ ያረጋግጡ፣ እና በአገልጋዩ ላይ እንደገና ያረጋግጡ። የተለጠፈው እሴት ተራ የተጠቃሚ ግቤት ነው። አሳሹ ስካነር እንዳመነጨው ማረጋገጥ አይችልም።

የQR ግቤትን ማረጋገጥ

የQR ጭነት አሃዛዊ ነው ብለው አያስቡ። የEAN-13 ደንቦች አይተገበሩም። ጽሑፉን እንዳልታመነ ይያዙት፦ እንደ ጽሑፍ ያሳዩት፣ እና ወደ location፣ innerHTML ወይም የስክሪፕት URL አይመድቡት።

ባዶ እሴቶች። ባዶ Enter፣ ወይም በባዶ መስክ ላይ Accept፣ መዝገብ መፍጠር የለበትም። trim() ክፍተቶች ብቻ የሆነ ጭነትንም ይከለክላል።

ያልተጠበቁ ቁምፊዎች። የተቀበሉትን ሕብረ ቁምፊ ከታወቀው የQR ይዘት ጋር ያነጻጽሩ። የቁልፍ ሰሌዳ አቀማመጥ አለመዛመድ ብዙውን ጊዜ ርዝመቱ ተመሳሳይ ሆኖ ሥርዓተ ነጥብን ይቀይራል። ቅርጸቱ የማይፈቅዳቸውን ቁምፊዎች ይከልክሉ፣ ምክንያቱንም በሁኔታ ጽሑፉ ውስጥ ያሳዩ።

የጭነት ርዝመት። መተግበሪያዎ የሚያከማቸውን ከፍተኛውን ያስፈጽሙ። በግቤቱ ላይ ያለ maxlength ረጅም ቅኝትን ያለ ስህተት ይቆርጣል። እያንዳንዱ ተቀባይነት ያለው ጭነት ሲገባ ብቻ ያዘጋጁት፣ እሴት አጭር ሲመስልም የሞካሪውን የቁምፊ ብዛት ከመስኩ ጋር ያነጻጽሩ።

የሚያስፈልጉ ቅድመ ቅጥያዎች። የቅድመ ቅጥያ ፍተሻ የመተግበሪያው ነው። ይህ የቲኬት ደንብ QR- ሲደመር አቢይ ፊደላት፣ አሃዞች እና ሰረዞች ይቀበላል፦

function isTicketId(value) {
  return /^QR-[A-Z0-9-]{1,64}$/.test(value)
}

የስካነር ቅድመ ቅጥያን ያን ስካነር አንድ ትክክለኛ ቅድመ ቅጥያ እንዲልክ ሲዋቀር እና መተግበሪያው የማያከማቸው ሲሆን ብቻ ያስወግዱ። የAIM ምልክት ሥርዓት መለያ እስክትወስኑ ድረስ ውሂብ ነው።

ለመተግበሪያ የተወሰኑ ቅርጸቶች። ደንቡን ከቅርጸቱ አጠገብ ያቆዩ። የቲኬት ቅጽ፣ የURL ፍቃድ ዝርዝር እና የJSON ነገር የተለያዩ ፍተሻዎች ያስፈልጓቸዋል። አንድ የቁጥር ስርዓተ ጥለት ትክክለኛ የQR ጽሑፍን ይከለክላል።

የተደጋገሙ ቅኝቶች። አንድ አካላዊ ቅኝት ሁለት አድማጮችን ሊመታ ይችላል። ምሳሌው እንደሚያደርገው አንድ የማጠናቀቂያ መንገድ ይጠቀሙ። ሁለተኛ የቀስቃሽ መጎተት የተለየ ክስተት ነው። ምሳሌው አስቀድሞ የተቀበለውን ጭነት ይከለክላል። የመጋዘን ቅጽ ብዛትን ሊጨምር ይችላል። መተግበሪያዎ የሰነደውን ደንብ ይሞክሩ።

የተበላሸ JSON። JSON.parse ባልተሟላ ጽሑፍ ላይ ይወረውራል። ከተሳካ ትንታኔ በኋላ ቅርጹን ይመርምሩ። ድርድር ወይም ባዶ ቁጥር ትክክለኛ JSON ሊሆን እና አሁንም የተሳሳተ ዓይነት ሊሆን ይችላል፦

function readJsonObject(value) {
  try {
    const data = JSON.parse(value)
    if (!data || typeof data !== 'object' || Array.isArray(data)) {
      return { ok: false, message: 'QR JSON must be an object.' }
    }
    return { ok: true, data }
  } catch {
    return { ok: false, message: 'QR text is not valid JSON.' }
  }
}

ያልተጠበቁ URLዎች። ጥቅም ላይ መዋል ይችል እንደሆነ ለማየት URLውን ይተንትኑ፣ ከዚያ ሙከራው ከQR ጭነቱ ጋር በትክክል መዛመድ ካለበት የተቃኘውን ሕብረ ቁምፊ ያቆዩ። URL.href ሰረዝ ሊጨምር ወይም ኮድን ሊቀይር ይችላል። መተግበሪያው የሚፈልጋቸውን እቅዶች ብቻ ይቀበሉ። URLውን እንደ የቅኝቱ የጎን ውጤት አይክፈቱ፦

function readWebUrl(value) {
  let url
  try {
    url = new URL(value)
  } catch {
    return { ok: false, message: 'The QR text is not a valid URL.' }
  }
  if (url.protocol !== 'http:' && url.protocol !== 'https:') {
    return { ok: false, message: 'Only http and https URLs are accepted.' }
  }
  return { ok: true, value }
}

የቁጥጥር ቁምፊዎች። የተደበቀ ቅድመ ቅጥያ በሁኔታ ጽሑፉ ውስጥ እንዲታይ በቁልፍ ሰሌዳ ጭነት ውስጥ የASCII ቁጥጥር ቁምፊዎችን ይከልክሉ። CR እና LF የቁጥጥር ቁምፊዎች ናቸው። በዌጅ ስካነር ላይ Enter እና Tab ቁልፎች ናቸው። በመደበኛ የጽሑፍ ግቤት ውስጥ ቁምፊዎች አይደሉም። ተከታታይ ጭነት አሁንም 0x0D ወይም 0x0A ባይቶች ሊይዝ ይችላል። እነዚያን በተከታታይ ፍሬሚንግ ድንበር ላይ ያስወግዱ፣ እና ባለብዙ መስመር ጭነት መካከል የሚገባ CRን አያስወግዱ።

የENTER እና የTAB ቅጥያዎች

ቅጥያ አማራጭ የስካነር ውቅር ነው። የQR ምልክቱ አካል አይደለም። በባርኮድ ስካነሮች ውስጥ ENTER እና TAB ቅጥያዎች ቁልፎቹን እንዴት እንደሚለዩ ያሳያል። ቅጥያውን በግቤት ሞካሪው ውስጥ ያንብቡ፣ ከዚያ ገጹን ከሚያሰማሩት ስካነሮች ጋር ያዛምዱ።

ENTER በአሁኑ አሳሾች ውስጥ የአንድ መስመር የጽሑፍ መስክ ቅጽ ያስገባል። አንድ ቅኝት እሴቱን ማስገባት ሲገባው ይጠቀሙበት። ገጹ በቦታው መቆየት ሲገባው በsubmit ላይ preventDefault() ይጥሩ።

TAB ትኩረትን ወደ ቀጣዩ መቆጣጠሪያ ያንቀሳቅሳል። መስኩ ገና ትኩረት እያለው እሴቱን በkeydown ያንብቡ። ቀጣዩ መስክ ትኩረት መቀበል ሲገባው ነባሪውን እርምጃ በቦታው ይተዉት። የቁልፍ ሰሌዳ ተጠቃሚ ወደ ኋላ እንዲንቀሳቀስ Shift+Tabን ችላ ይበሉ።

ቅጥያ የለም ጭነቱን በመስኩ ውስጥ ይተዋል። በምሳሌው ውስጥ ያለው የAccept አዝራር የማጠናቀቂያ መንገድ ነው። የእንቅስቃሴ-አልባነት ሰዓት ቆጣሪ ለአፍታ ማቆም ቅኝቱ አልቋል ብሎ ሊገምት ይችላል። ያ ሰዓት ቆጣሪ ግምት ነው፦ ቀርፋፋ የBluetooth ፍንዳታ እና ፈጣን ተየባሪ ሁለቱም ተመሳሳይ ክፍተት ሊሻገሩ ይችላሉ። የሥራ ሂደቱ ጠንካራ መጨረሻ ሲፈልግ የተዋቀረ ቅጥያ ይምረጡ።

CR እና LF ባይቶች ናቸው። የቁልፍ ሰሌዳ Enter event.key === "Enter" ነው። እነዚህ ተለዋዋጭ አይደሉም። ከግቤት እሴት \r ብቻ የሚያስወግድ አድማጭ የዌጅ Enterን አያይም፣ ምክንያቱም ቁምፊው ፈጽሞ አልገባም። event.keyን ብቻ የሚከታተል አድማጭ ተከታታይ ቋትን በ0x0D አይከፋፍልም። አንዳንድ መሣሪያዎች NumPad Enter ይልካሉ። event.key አሁንም "Enter" ነው። event.keyን ይመርምሩ፣ event.code === "Enter"ን ብቻ አይደለም።

አንድ ሰው ከመሣሪያው መመሪያ የውቅር ባርኮድ ሲቃኝ ቅጥያው ሊቀየር ይችላል። ከማንኛውም የውቅር ለውጥ በኋላ Enterን፣ Tabን እና ቅጥያ የለምን እንደገና ይሞክሩ። የፕሮግራም ባርኮድ አይፍጠሩ። ለዚያ ሞዴል መመሪያውን ይጠቀሙ።

የቁልፍ ሰሌዳ ክስተቶችን ማረም

የተከማቸው ጽሑፍ የተሳሳተ ሲሆን ክስተቶቹን በዚህ ቅደም ተከተል ይመርምሩ።

keydown። አሳሹ ቁምፊ ከማስገባቱ ወይም ትኩረት ከማንቀሳቀሱ በፊት ለእያንዳንዱ ቁልፍ፣ Enter እና Tabን ጨምሮ፣ ይተኮሳል። መጨረሻውን እዚህ ያንብቡ።

input። ሊታተም የሚችል ቁምፊ መስኩን ከቀየረ በኋላ ይተኮሳል። በጽሑፍ ግቤት ላይ ለEnter ወይም ለTab አይተኮስም።

event.key። ስርዓተ ክወናው የቁልፍ ሰሌዳ አቀማመጡን ከተገበረ በኋላ ያለው ቁምፊ ወይም የቁልፍ ስም።

event.code። እንደ Digit1 ወይም Numpad1 ያለ አካላዊ ቁልፍ። የአቀማመጥ አለመዛመድ event.keyን ሲቀይር ተመሳሳይ ሊቆይ ይችላል።

ትኩረት። ከቅኝቱ በፊት document.activeElementን ይመዝግቡ። የQR መስኩ ካልሆነ፣ የቀረው ፍለጋ የተሳሳተውን መቆጣጠሪያ ይገልጻል። iframe የራሱ ትኩረት አለው።

ቅደም ተከተል። ወደ የጽሑፍ መስክ ለሚገባ የዌጅ ቅኝት፣ ሊታተሙ የሚችሉ keydown ክስተቶች በinput ዝማኔዎች ይከተላሉ፣ ከዚያ ያ ቅጥያ ሲዋቀር ለEnter ወይም ለTab የመጨረሻ keydown ይመጣል። change መስኩ ሲያስገባ ይተኮሳል፣ ብዙውን ጊዜ በblur። ትኩረትን በተመሳሳይ መስክ ውስጥ የሚተው ቅኝት በመጨረሻ change አያመጣም። changeን እንደ ብቸኛ የማጠናቀቂያ ምልክት አይጠቀሙ።

ጊዜ። ስካነሮች አጭር ጭነትን ብዙውን ጊዜ ከአንድ ሰከንድ በታች ይጨርሳሉ። የግቤት ሞካሪው በቁምፊዎች መካከል ያለውን አማካይ ክፍተት ከ100 ms ገደብ ጋር ያነጻጽራል እና ውጤቱን እንደ ጊዜ ይሰይማል፣ እንደ የሃርድዌር መለያ አይደለም። ፈጣን ተየባሪ፣ ራስ-ሙሌት ወይም ኢሙሌተሩ በዚያ ገደብ የስካነር በኩል ሊወድቁ ይችላሉ። የዘገየ የBluetooth ቅኝት እንደ መተየብ ሊመስል ይችላል። ጭነቱን እና ቅጥያውን ያረጋግጡ። ጊዜን እንደ ፍንጭ ይያዙ።

የቁልፍ ሰሌዳ ክስተት ሞካሪ እያንዳንዱን keydown እና keyup ከkey፣ ከcode፣ ከማሻሻያዎች እና ከጊዜ ማህተሞች ጋር ይዘረዝራል። መዝገቡ የአሳሽ ክስተቶች ነው። ጥሬ የUSB ትራፊክ አይደለም።

ያለ አካላዊ የQR ስካነር መሞከር

የመተግበሪያ አመክንዮ ስካነሩ በጠረጴዛው ላይ ከመሆኑ በፊት ሊሞከር ይችላል።

  • QR-INPUT-TEST-12345ን ወደ መስኩ ይተይቡ እና Acceptን ያንቀሳቅሱ። ይህ ማረጋገጫን እና ማሳያን ይመረምራል። መፍታትን ወይም ቅጥያዎችን አይመረምርም።
  • ተመሳሳይ መስክን ከአሳሽ አውቶሜሽን መሣሪያ ይንዱ፣ ቀጣዩ ክፍል እንደሚያደርገው።
  • እንደ ስካነር መተየብ ሲያስፈልግ Barcode Scanner Emulator ይጠቀሙ። የዴስክቶፕ መተግበሪያው እርስዎ የሚያስገቡትን እሴት፣ የመተየብ መዘግየት እና የለም፣ ENTER ወይም TAB የሆነ ቅጥያ ይዞ፣ ትኩረት ባለው መተግበሪያ ውስጥ ይልካል። የቁልፍ ሰሌዳ መንገዱን ይደግማል። የQR ምስል አይቀዳም፣ ምልክት አይፈታም፣ ምናባዊ የCOM ወደብም አይፈጥርም።

ለኦፕቲካል እና ለመሣሪያ ባህሪ ሃርድዌር አሁንም ያስፈልጋል፦ ያ ስካነር የታየውን ወይም የታተመውን ኮድ ማንበብ ይችል እንደሆነ፣ የQR ምልክት ሥርዓት መብራቱ፣ የቁልፍ ሰሌዳ አቀማመጥ፣ የቅጥያ ውቅር፣ እና ተከታታይ ወይም የአቅራቢ SDK ሁነታዎች። ኢሙሌተሩ ለቁልፍ ሰሌዳ መንገድ ትክክለኛው ፍተሻ ነው። መሣሪያ የተወሰነ የQR ኮድ እንደሚያነብ ለማረጋገጥ የተሳሳተው ፍተሻ ነው።

የQR ግቤት ሙከራዎችን በራስ-ሰር ማድረግ

የሚከተሉት የPlaywright ሙከራዎች የምሳሌውን ገጽ ይነዳሉ። የዌጅ ስካነር እንደሚተይብ ሁሉ ወደ መስኩ ይተይባሉ፣ ከዚያ የመተግበሪያ ባህሪን ያረጋግጣሉ። የUSB መሣሪያዎችን አይከፍቱም። @playwright/test የአንባቢ ጥገኝነት ነው። ይህ ጣቢያ አይፈልገውም።

የHTML ምሳሌውን እንደ qr-form.html ከዚህ ሙከራ አጠገብ ያስቀምጡ።

import { readFileSync } from 'node:fs'
import { expect, test } from '@playwright/test'

const html = readFileSync(new URL('./qr-form.html', import.meta.url), 'utf8')

async function openForm(page) {
  await page.setContent(html)
}

test('accepts a known QR payload once', async ({ page }) => {
  await openForm(page)
  const field = page.getByLabel('QR payload')
  await field.pressSequentially('QR-INPUT-TEST-12345')
  await field.press('Enter')
  await expect(page.getByRole('status')).toHaveText('Accepted QR-INPUT-TEST-12345')
  await expect(page.locator('#captured')).toHaveText('QR-INPUT-TEST-12345')
})

test('rejects an unexpected payload', async ({ page }) => {
  await openForm(page)
  const field = page.getByLabel('QR payload')
  await field.pressSequentially('not-a-ticket')
  await field.press('Enter')
  await expect(page.getByRole('status')).toHaveText('Unexpected QR payload.')
  await expect(page.locator('#captured')).toBeEmpty()
})

test('commits on ENTER and rejects a duplicate scan', async ({ page }) => {
  await openForm(page)
  const field = page.getByLabel('QR payload')
  await field.pressSequentially('QR-INPUT-TEST-12345')
  await field.press('Enter')
  await field.pressSequentially('QR-INPUT-TEST-12345')
  await field.press('Enter')
  await expect(page.getByRole('status')).toHaveText('Already accepted QR-INPUT-TEST-12345')
  await expect(page.locator('#captured')).toHaveText('QR-INPUT-TEST-12345')
})

test('does not capture keys while the field is unfocused', async ({ page }) => {
  await openForm(page)
  await page.getByRole('button', { name: 'Accept' }).focus()
  await page.keyboard.type('QR-INPUT-TEST-12345')
  await expect(page.getByLabel('QR payload')).toHaveValue('')
  await expect(page.locator('#captured')).toBeEmpty()
  await expect(page.getByRole('status')).toHaveText('')
})

test('shows unexpected characters as text', async ({ page }) => {
  await openForm(page)
  const payload = '<img src=x onerror=alert(1)>'
  const field = page.getByLabel('QR payload')
  await field.fill(payload)
  await page.getByRole('button', { name: 'Accept' }).click()
  await expect(page.getByRole('status')).toHaveText('Unexpected QR payload.')
  await expect(page.locator('#captured img')).toHaveCount(0)
  await expect(page.locator('img')).toHaveCount(0)
})

pressSequentially ቁምፊዎችን ትኩረት ባለው መስክ ውስጥ ያስገባል። የUSB መሣሪያ አይደለም። ያልተጠበቀ-ቁምፊ ሙከራ fill ይጠቀማል ምክንያቱም ግቡ የማረጋገጫ መልዕክቱ እና የገባ አካል አለመኖር ነው። እነዚያ ቅርጸቶች በሚልኩት ግንባታ ውስጥ ሲሆኑ ፋይሉን በURL ጉዳይ እና በJSON ጉዳይ ያስፋፉ። የURL ማረጋገጫ የተያዘውን ጽሑፍ ከመጀመሪያው የQR ሕብረ ቁምፊ ጋር ማነጻጸር አለበት።

የQR ስካነር የሙከራ ማትሪክስ

እነዚህን በሙከራ ላይ ባለው መተግበሪያ ላይ ያሂዱ። ከላይ ያለው የናሙና ገጽ የቲኬት፣ የURL፣ የJSON፣ የተደጋገመ፣ ባዶ እና ያልተጠበቀ ቁምፊ ረድፎችን ይሸፍናል። ቁጥር-ብቻ ወይም ባለብዙ መስመር መተግበሪያ የራሱ የሚጠበቅ ውጤት ያስፈልገዋል።

ሁኔታ የሚጠበቅ ውጤት
ቀላል ጽሑፍ QR ትክክለኛ እሴት ተቀብሏል።
URL QR ሙሉ URL ተይዟል፣ ገጹም ወደ እሱ አይሄድም።
አሃዛዊ QR አሃዞች ተጠብቀዋል።
ልዩ ቁምፊዎች ትክክለኛ ቁምፊዎች ተቀብለዋል።
የJSON ጭነት ውሂብ ተይዞ ተረጋግጧል።
የENTER ቅጥያ ሂደቱ አንድ ጊዜ ይከናወናል።
የTAB ቅጥያ የትኩረት ባህሪ ተይዟል።
ቅጥያ የለም መተግበሪያው አማራጭ የማጠናቀቂያ ዘዴ ይጠቀማል።
የተደጋገመ ቅኝት መተግበሪያው የድግግሞሽ አያያዝ ደንቦችን ይተገብራል።
ልክ ያልሆነ ጭነት የማረጋገጫ ስህተት ታይቷል።
የጠፋ ትኩረት መተግበሪያው የሌለ ግቤትን በደህንነት ይይዛል።
ረጅም ጭነት ያልታሰበ መቁረጥ የለም።

ምርቱ አንዱን ማከማቸት ካለበት አዲስ መስመር የያዘ ጭነትም ይቃኙ። መስኩ እያንዳንዱን መስመር ተቀብሎ እንደሆነ ይመዝግቡ።

መላ መፈለግ

በግቤት ሞካሪው ውስጥ በታወቀ ጭነት ይጀምሩ። የሞካሪው እሴት አስቀድሞ የተሳሳተ ከሆነ፣ ገጹ የመጀመሪያው ጉድለት አይደለም። የሞካሪው እሴት ትክክል ከሆነ መተግበሪያው ግን የተሳሳተ ከሆነ፣ ጉድለቱ ትኩረት፣ ማረጋገጫ ወይም የክስተት አያያዝ ነው። የባርኮድ ስካነር አይሠራም ሰፋ ያለ የመሣሪያ ማረጋገጫ ዝርዝር ነው። የባርኮድ ስካነር ግቤትን እንዴት መሞከር እንደሚቻል ከዚህ ቅጽ ባሻገር ትኩረትን፣ አቀማመጥን እና የPOS የሥራ ሂደቶችን ይሸፍናል።

ስካነሩ ይጮሃል ግን ግቤት አይታይም

ጩኸት ብዙውን ጊዜ ስካነሩ ምልክት መፍታቱን ያመለክታል። ገጹ ጽሑፉን ተቀብሏል ማለት አይደለም። የቁልፍ ሰሌዳ ዌጅ ሁነታን ያረጋግጡ። ተከታታይ እና የካሜራ ሁነታዎች ወደ መስኩ አይተይቡም። document.activeElement ያ ግቤት እንዲሆን መስኩን ጠቅ ያድርጉ፣ ከዚያ እንደገና ይቃኙ። የተሰናከለ፣ ለንባብ-ብቻ ወይም የተደበቀ መስክ ቁልፎቹን ሊተው ይችላል።

የQR ስካነር በNotepad ይሠራል በአሳሹ ግን አይሠራም

መሣሪያው ይተይባል። ገጹ እነዚያን ቁልፎች አይቀበልም። ትኩረትን፣ በሚታተሙ ቁልፎች ላይ preventDefault() የሚጠራ keydown አድማጭን፣ እና paste ብቻ የሚይዝ አድማጭን ይመርምሩ። የዌጅ ግቤት የpaste ክስተት አያመጣም። የሞካሪውን ውጤት ከመተግበሪያው መስክ ጋር ያነጻጽሩ።

ስካነሩ ባርኮዶችን ያነባል የQR ኮዶችን ግን አያነብም

መሣሪያው 1D ብቻ ሊሆን ይችላል፣ ወይም የQR ምልክት ሥርዓት ሊጠፋ ይችላል። ገጹ ያንን ማስተካከል አይችልም። የ2D ድጋፍን ያረጋግጡ እና QR Codeን ከመሣሪያው መመሪያ ያንቁ፣ በየQR ኮድ ሙከራ፦ የQR ኮድ ስካነሮችን እንዴት መሞከር እንደሚቻል ውስጥ ባሉ ፍተሻዎች። የተሳካ የCode 128 ቅኝት የቁልፍ ሰሌዳ መንገድን ብቻ ያረጋግጣል።

የተሳሳቱ ቁምፊዎች

መጀመሪያ QR-INPUT-TEST-12345ን ይቃኙ። ያ የሚዛመድ ከሆነ የURL ወይም የJSON ጭነት ግን የማይዛመድ ከሆነ፣ አቀማመጡ እንደ :፣ /፣ { ወይም " ያለ ሥርዓተ ነጥብ ይቀይራል። event.keyን ከevent.code ጋር በቁልፍ ሰሌዳ ክስተት ሞካሪ ውስጥ ያነጻጽሩ፣ እና የባርኮድ ስካነር የተሳሳተ የቁልፍ ሰሌዳ አቀማመጥ ይመልከቱ። የስካነሩን የቁልፍ ሰሌዳ አቀማመጥ ከስርዓተ ክወናው ጋር ያዛምዱ።

ENTER ቅጹን ሁለት ጊዜ ያስገባል

አሳሹ ቅጹን ያስገባል፣ keydown አድማጭም Enterን ይይዛል። አንድ የማጠናቀቂያ መንገድ ያቆዩ እና preventDefault()ን እዚያ ይጥሩ። ሁለተኛ አካላዊ ቅኝት የተለየ ውድቀት ነው። በምሳሌው ውስጥ ያለው የሁኔታ ጽሑፍ ጭነቱ አስቀድሞ ተቀብሏል ይላል። የመጀመሪያው ቅኝት ራሱ ሁለት መዝገቦች የሚፈጥር ከሆነ፣ ስካነሩን ከመቀየርዎ በፊት ሁለት አድማጮችን ይፈልጉ።

የQR ግቤት ተቆርጧል

በግቤት ሞካሪው ውስጥ ያለውን የቁምፊ ብዛት በመስኩ ውስጥ ካለው እሴት ጋር ያነጻጽሩ። የmaxlength ባህሪ፣ የግቤት ጭንብል ወይም በቁምፊ ቁልፎች ላይ preventDefault() ሕብረ ቁምፊውን ሊቆርጥ ይችላል። በQR ጭነት ውስጥ ያለ አዲስ መስመር የአንድ መስመር ግቤትን ቀደም ብሎ ሊያስገባ ይችላል። አንዳንድ ስካነሮችም ስንት ቁምፊ እንደሚተይቡ ይገድባሉ። ሞካሪው፣ መተግበሪያው ብቻ ሳይሆን፣ አጭር እሴት ሲያሳይ ያንን ገደብ ከመሣሪያው መመሪያ ከፍ ያድርጉ። የባርኮድ ስካነር ENTER ይጎድለዋል ጭነቱ የሚደርስበትን እና ቅጹ ፈጽሞ የማያስገባበትን ተዛማጅ ጉዳይ ይሸፍናል።

ስካነር በማያ ገጽ ላይ የQR ኮድ ማንበብ አይችልም

ስካነሩ 2D ኢሜጀር መሆኑን ያረጋግጡ። የማሳያ ብሩህነትን ከፍ ያድርጉ፣ የኮዱን መጠን ይጨምሩ፣ እና ጸጥታው ዞን ከጽሑፍ እና ከድንበሮች ነጻ እንዲሆን ያድርጉ። ነጸብራቅ፣ ደብዛዛ የስልክ ማያ እና ለሥራ ርቀት በጣም ጥቅጥቅ ያለ ኮድ የኦፕቲክ ችግሮች ናቸው። የማያ ንባብ መክሸፉን ከቀጠለ ተመሳሳይ ጭነት ያትሙ። ማንኛውም ቅኝት ጽሑፍ ካመነጨ በኋላ የመተግበሪያው ሙከራ አሁንም የታወቀውን ሕብረ ቁምፊ ይጠቀማል።