Barcode Scanner Emulator
ウェブアプリケーションで QR コードスキャナーの入力をテストする方法
QR を読める外部スキャナーの多くはキーボードウェッジモードを使い、復号した QR のテキストをフォーカスされたフィールドへ入力します。分かっているペイロードをスキャンし、ページが受け取った値と比べて、その経路をテストします。すべての QR スキャナーがキーボードのように入力するわけではありません。シリアル機器とカメラのデコーダーは別の連携で、ブラウザのキーボードイベントは物理スキャナーを識別しません。
QR コードはデータを格納します。スキャナー、またはカメラのデコーダーが、そのデータをテキストにします。ウェブアプリケーションはそのテキストを受け取り、スキャンが終わった時点を判断し、検証しなければなりません。このガイドはそのアプリケーションのテストです。ラベルの生成、コントラストの確認、機器が QR Code を復号できることの確認は、QR コードのテスト: QR コードスキャナーのテスト方法で扱います。EAN のチェックディジットを含む一般的なバーコードのフォームは、ウェブアプリケーションでバーコードスキャナーをテストする方法で扱います。
60 秒で QR スキャナー入力をテストする
自分で選んだペイロードを使えば、誤った文字はすぐ分かります。この手順では QR-INPUT-TEST-12345 を使います。
- QR コードジェネレーターを開き、
QR-INPUT-TEST-12345の QR コードを生成します。ジェネレーターはブラウザ内で動作します。スキャナーには接続しません。 - キーボードウェッジモードの、QR を読めるスキャナーを接続します。1D 専用のスキャナーはこのシンボルを復号できません。
- バーコード入力テスターを開きます。
- テスト開始をクリックするか、スキャン領域をクリックし、フィールドにフォーカスを置きます。テスターは自分ではフォーカスを取らず、スキャナーも開きません。
- QR コードをスキャンします。
- 取り込まれたテキストと文字数を読みます。
- そのテキストを
QR-INPUT-TEST-12345と比べます。一致には大文字小文字、ハイフン、長さが含まれます。 - 接尾辞を読みます。スキャナーがそれらのキーの一つを送ると、テスターは 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 イメージャであることを確認します。画面の明るさを上げ、コードのサイズを大きくし、クワイエットゾーンを文字や枠から空けておきます。映り込み、暗い電話の画面、作業距離に対して密すぎるコードは、光学の問題です。画面からの読み取りが失敗し続けるときは、同じペイロードを印刷します。いずれかのスキャンがテキストを出したあと、アプリケーションのテストはなお分かっている文字列を使います。