コード容量ガイド

GarminウォッチのQRコードとバーコードの長さ制限

WalletProは長い値を保持できますが、読み取れる長さはコード形式とウォッチ画面で決まります。

GarminウォッチのQRコードとバーコードの長さ制限

最も重要なのは、保存できる長さと読み取れる長さは別だという点です。WalletProのValueフィールドは最大512文字を保存できるため、長い値もGarmin Connect IQと対応ウォッチにそのまま保持できます。ただし、すべてのコード形式が512文字を表示・スキャンできるわけではありません。QRにはモジュールと余白のための面積が必要で、1次元バーコードにはバーを並べる横幅が必要です。実用上の上限は、形式、値、画面の組み合わせで決まります。

512文字の意味

512文字は保存上限であり、すべての値が利用可能なコードになるという保証ではありません。エンコーダーが値を受け付けない場合、WalletProは値を短くせず、そのまま保持して明確なエラーを表示します。発行元の値を正確に入力してください。先頭のゼロ、句読点、大文字、元の形式も含めます。シンボルの下に印刷された番号が、完全なデータとは限りません。

現在のQR経路はバイトモードを使用します。ASCIIの数字と大文字はそれぞれ1 UTF-8バイトですが、専用の数値・英数字モードのような圧縮は行いません。数字と大文字はQRに向いていますが、文字数だけでは容量を判断できません。ASCII以外のUnicode文字は複数バイトになることがあります。印刷された番号が、常にエンコードされた値とは限りません。

QR容量は画面サイズで変わる

一般的な標準画面の技術的な目安は、208ピクセルで約44 ASCIIバイト、218で64、240–246で86、260–282で108、320で154、360で216、390で254、416–420で290、448–454で334–365、480で約415バイトです。これは描画が値を受け入れられる目安であり、実際のスキャンを保証するものではありません。明るさ、反射、距離、ピント、読み取り機も影響します。

180文字のASCII QRは、約360ピクセルクラス以上の大きめの標準画面なら多くの場合現実的ですが、すべての小型・コンパクトモデルで使えるわけではありません。300文字は通常、約448ピクセルクラス以上の大きな標準画面が必要です。512文字は保存できても、QRの表示には長すぎることがあります。コンパクトなフィールドはさらに厳しく、バージョン3は3ピクセル/モジュールで約44 ASCIIバイトが目安です。コンパクト画面は別のクラスとして確認してください。

画面の形状はQR容量の一部です。AMOLED、反射型MIP、小型Instinct画面はいずれもコードを表示できますが、同じ値が大きな標準画面では通り、コンパクト画面では拒否されることがあります。GarminでQRやバーコードが読み取れない場合のガイドで、容量、コントラスト、形式、読み取り機を切り分けてください。

1次元バーコードは幅の制限が厳しい

Code 128は印字可能なASCIIを扱えますが、バーは画面幅に収める必要があります。標準画面では、数字以外の値は6–9文字程度で実用性が下がり、数字をペアで符号化する場合は画面により約13–19桁まで届くことがあります。WalletProは識別子を変更せず、Barcode too longまたは無効なデータを表示します。

Code 39のエンコーダー上限は80文字ですが、実際には画面幅が先に制限となり、8–12文字程度で難しくなることが多いです。EAN-13とUPC-Aは固定長で、EAN-13はデータ12桁+チェック桁、UPC-Aはデータ11桁+チェック桁です。元のシンボロジーを維持してください。小売バーコードをQRに変えると、読み取り機が期待する形式が変わります。Aztecにも独自の容量があり、コンパクト設定では印字可能ASCII約53バイトが目安です。

vCard、Notes、2FAは別の制限

Valueフィールドが常にバーコードデータとは限りません。Notesは短い文字情報、TOTPは意味上の制約を持ち、通常6–8桁を表示します。設定値は有効なsecretまたはotpauth URIである必要があります。vCard連絡先は対応グラフで利用できますが、フィールド対応はウォッチの能力によって異なります。512文字はすべての機能に共通する上限ではありません

元のカードまたは公式アプリから始めてください。完全な値を読み取り、大文字・小文字と句読点を保ち、同じコード形式を選んで実際の読み取り機で試します。静的な会員、ロイヤルティ、ジム、parkrun、対応アクセスコードはオフラインウォレットに適しています。動的QRはWalletProで更新・検証・再生成できません。RFID/NFCは別の物理チップであり、QRやバーコードではありません。最終的な判断は実際の読み取り機で行います。

実際に確認する手順

連絡先QRはvCardガイド、カードの同期はカード編集ガイドを参照してください。WalletProはGarminウォッチ向けの実用的なオフラインQR・バーコードウォレットで、元の値を保ち、複数形式に対応し、容量超過を黙って切り詰めず明確に知らせます。

Garmin Connect IQ で WalletPro を開く.

テーマから探す ブログに戻る