コンテンツへスキップ

Barcode Scanner Emulator

ウェブアプリケーションで QR コードスキャナーの入力をテストする方法

QR を読める外部スキャナーの多くはキーボードウェッジモードを使い、復号した QR のテキストをフォーカスされたフィールドへ入力します。分かっているペイロードをスキャンし、ページが受け取った値と比べて、その経路をテストします。すべての QR スキャナーがキーボードのように入力するわけではありません。シリアル機器とカメラのデコーダーは別の連携で、ブラウザのキーボードイベントは物理スキャナーを識別しません。

QR コードはデータを格納します。スキャナー、またはカメラのデコーダーが、そのデータをテキストにします。ウェブアプリケーションはそのテキストを受け取り、スキャンが終わった時点を判断し、検証しなければなりません。このガイドはそのアプリケーションのテストです。ラベルの生成、コントラストの確認、機器が QR Code を復号できることの確認は、QR コードのテスト: QR コードスキャナーのテスト方法で扱います。EAN のチェックディジットを含む一般的なバーコードのフォームは、ウェブアプリケーションでバーコードスキャナーをテストする方法で扱います。

60 秒で QR スキャナー入力をテストする

自分で選んだペイロードを使えば、誤った文字はすぐ分かります。この手順では 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 キーボードウェッジの解説が説明します。

宛先を決めるのはフォーカスです。フォーカスされた要素が文書の body、ボタン、または別のフレームなら、このフィールドのリスナーはスキャンを見ません。

シリアルの QR スキャナー

USB シリアル、または仮想 COM ポートのスキャナーは、復号したテキストを、ポートを開いたプロセスへバイトとして送ります。そのプロセスを選ぶのはフォーカスではありません。キー入力だけを待つフィールドは空のまま、そのポートのターミナルにはペイロードが表示されます。

Chromium ベースのブラウザは、セキュアコンテキストで、ユーザーの操作のあと、ユーザーが選んだポートを Web Serial API で開けます。Firefox と Safari はその API を提供しません。ウェッジスキャナーはシリアルポートとしては現れません。ポート名、ボーレート、フレーミングは機器とドライバーに依存します。USB HID とシリアルのバーコードスキャナーが二つのインターフェースを比較します。バーコード入力テスターは COM ポートを読めません。

カメラによる QR スキャン

カメラの連携は画像を取り込み、ソフトウェアで QR コードを復号します。ページはカメラ API とデコーダーを使います。ペイロードの keydown イベントは受け取りません。電話のカメラアプリ、ページ内のカメラボタン、フィールドへ入力するハードウェアのイメージャは、三つの異なる製品です。ウェッジのテストに通ってもカメラボタンが動くとは限らず、カメラの復号が成功してもウェッジスキャナーが同じ文字列を入力するとは限りません。

JavaScript で QR スキャナー入力を取得する

下のページは、フォーカスされた一つのフィールドを読みます。Enter はフォームを送信し、Accept ボタンは同じ送信ハンドラーを使うため、一回のスキャンは一度処理されます。ENTER の接尾辞がなければ、誰かが Accept を有効にするまでテキストはフィールドに残ります。取り込まれたペイロードは textContent で書かれるため、< のような文字はテキストのまま見えます。

例は三つのアプリケーション形式を受け付けます。QR-INPUT-TEST-12345 のようなチケット ID、http または https の URL、または JSON オブジェクトです。スキャンしたテキストを記録します。QR コード内の URL へは遷移しません。Enter を送らないスキャナーも、ボタンを通して動作します。スクリプトは Tab を閉じ込めないため、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 で分割しません。一部の機器はテンキーの Enter を送ります。event.key はなお "Enter" です。event.code === "Enter" だけではなく、event.key を確認します。

誰かが機器のマニュアルにある設定用バーコードをスキャンすると、接尾辞は変わり得ます。設定を変えたあとは、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 はフィールドが値を確定するとき、通常はブラーで発火します。同じフィールドにフォーカスを残すスキャンは、終わりに change を出しません。change だけを完了の信号にしないでください。

タイミング。 スキャナーは、短いペイロードをしばしば 1 秒を大きく下回る時間で終えます。入力テスターは、文字の間の平均間隔を 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 スキャナーはメモ帳では動き、ブラウザでは動かない

機器は入力しています。ページがそれらのキーを受け付けていません。フォーカス、印字可能なキーで preventDefault() を呼ぶ keydown リスナー、paste だけを扱うリスナーを確認します。ウェッジ入力は paste イベントを発火しません。テスターの結果と、アプリケーションのフィールドを比べます。

スキャナーはバーコードを読み、QR コードは読まない

機器が 1D 専用であるか、QR のシンボル体系が無効かもしれません。ページでは直せません。2D の対応を確認し、QR コードのテスト: QR コードスキャナーのテスト方法の確認を使い、機器のマニュアルから QR Code を有効にします。Code 128 のスキャンが成功しても、証明できるのはキーボード経路だけです。

文字が正しくない

まず QR-INPUT-TEST-12345 をスキャンします。それが一致し、URL または JSON のペイロードが一致しないときは、配列が :、/、{、" のような句読点を変えています。キーボードイベントテスターで event.key と event.code を比べ、バーコードスキャナーのキーボード配列が違うを見てください。スキャナーのキーボード配列をオペレーティングシステムに合わせます。

ENTER がフォームを二度送信する

ブラウザがフォームを送信し、keydown リスナーも Enter を扱っています。完了の経路を一つにし、そこで preventDefault() を呼びます。二回目の物理スキャンは別の故障です。例のステータステキストは、ペイロードがすでに受け付けられたと言います。最初のスキャン自体が二つのレコードを作るときは、スキャナーを変える前に二つのリスナーを探します。

QR 入力が切り詰められる

入力テスターの文字数と、フィールドの値を比べます。maxlength 属性、入力マスク、文字キーでの preventDefault() は、文字列を切ることがあります。QR ペイロードの中の改行は、一行の入力を早く送信できます。一部のスキャナーは、入力する文字数も制限します。テスターだけが短い値を示すとき、アプリケーションだけではなく、機器のマニュアルからその上限を上げます。バーコードスキャナーで ENTER が出ないは、ペイロードは届くのにフォームが確定しない、関連するケースを扱います。

スキャナーが画面上の QR コードを読めない

スキャナーが 2D イメージャであることを確認します。画面の明るさを上げ、コードのサイズを大きくし、クワイエットゾーンを文字や枠から空けておきます。映り込み、暗い電話の画面、作業距離に対して密すぎるコードは、光学の問題です。画面からの読み取りが失敗し続けるときは、同じペイロードを印刷します。いずれかのスキャンがテキストを出したあと、アプリケーションのテストはなお分かっている文字列を使います。