アーキテクチャルール
フォーカス動作が許容される制御されたフォーム入力ワークフローにはウェッジを使用します。構造化されたスキャン配信が利用可能で、スキャナー構成が外部のままでよい場合は、インテントを使用します。アプリがトリガー セッション、シンボル、出力モード、または詳細なスキャナー状態を所有する必要がある場合は、 SDK を使用します。正確なデバイスとファームウェアを検証します。
キーボードウェッジ: ローコード、非表示状態
ウェッジ モードでは、フォーカスされたコントロールに文字が挿入され、Web アプリや従来のアプリで動作します。入力レベルでは移植可能ですが、フォーカス、キーボード レイアウト、IME、プレフィックス、サフィックス、タイミングに依存します。
スキャンが検索、メモ、または認証フィールドに入らないようにします。 Enter または Tab を追加するかどうかを定義し、長いコード、高速スキャン、および手動入力をテストします。
- 明示的なスキャン準備完了フィールド状態
- プレフィックスとサフィックスの文書化
- IMEとキーボードレイアウトを修正
- 重複送信保護
ブロードキャストの目的: Android ライフサイクル ルールによる構造化配信
インテント出力は、スキャン データをテキスト フォーカスから分離します。受信者はアクションとエクストラを検査し、長さを検証し、イベントをアクティブなワークフローにルーティングできます。
アクション名、エクストラ、レシーバーの要件はベンダーと SDK バージョンによって異なります。適切なライフサイクルで登録および登録解除し、可能な限り公開を制限し、予期しないペイロードを拒否します。
- 正確なアクションと追加のキー
- 受信者のエクスポートと許可のレビュー
- 前景と背景の動作
- 生のバイトとデコードされた文字列の比較
ベンダー SDK: 明示的制御と明示的結合
SDK は、スキャナーの開閉、出力モードの選択、シンボルの構成、デコード セッションの開始または停止を行うことができます。これは、スキャン動作がアプリケーション ステート マシンの一部である場合に適しています。
ベンダー呼び出しをアプリケーション インターフェイスの背後でラップし、戻り値を記録し、クリーンアップを冪等にします。 API の可用性は同一のエンジンまたはファームウェアの動作を保証するものではないため、デバイス互換性マトリックスを保持してください。
- ベンダー API に関するアダプター
- 所有権のオープン、開始、停止、クローズ
- 可能な場合は構成のリードバック
- 障害とタイムアウトの状態が表示される
データの整合性とライフサイクルを検証する
コールド スタート、再開、画面ロック、アプリの切り替え、サポートされている場合は回転、再起動、 MDM キオスク モード、および迅速な繰り返しトリガーをテストします。各物理スキャンで 1 つの意図したビジネス イベントが作成されることを確認します。
非 ASCII 文字および制御文字には既知のバイト シーケンスを使用します。アプリケーションが生のバイト、デコードされたテキスト、シンボル、およびタイムスタンプを保存するかどうかを決定します。機密性の高いスキャン値をログに記録しないようにします。
- 1 回のスキャンは 1 回のトランザクションに相当します
- スキャンしても間違った画面に移動しない
- エンコーディングと長さの検証
- 回復にはデバイスの再起動は必要ありません
ウェッジ vs インテント vs SDK
必要な制御を提供できる最小の統合レベルを選択してください。
| 基準 | キーボードウェッジ | ブロードキャストの意図 | ベンダー SDK |
|---|---|---|---|
| 実装の取り組み | 低い | 中 | 中～高 |
| フォーカス依存性 | 高 | 低い | 低い |
| スキャナ制御 | 主に外部構成 | 外部または限定的 | アプリケーション所有 |
| データ構造 | 文字と接尾語 | 名前付きエキストラ | API イベントまたはブロードキャスト |
| 携帯性 | 入力レベルの可搬性 | ベンダーアクションマッピング | ベンダー API アダプターが必要です |
統合検証チェックリスト
デバイス、OS、ファームウェア、 SDK 、アプリケーション ビルドごとに結果を記録します。
- 01
意図した出力モードのみがアクティブになります
- 02
ウェッジに対してテストされたフォーカスとサフィックスの動作
- 03
インテントアクションと追加機能が検証されました
- 04
受信機のライフサイクルと暴露の見直し
- 05
SDK オープンおよびクローズ戻り値の処理
- 06
ラピッドトリガーと重複イベントのテスト済み
- 07
スリープ、レジューム、再起動、アプリの切り替えテスト済み
- 08
エンコーディングと長いペイロードが検証されました
- 09
ログから除外される制限付きデータ
- 10
ロールバックと構成のリセットについて文書化
よくある質問
キーボード ウェッジは生産に十分な信頼性がありますか?
それは、ワークフローがフォーカス、キーボード構成、サフィックス、重複送信を厳密に制御している場合に発生する可能性があります。入力を受け取ることができるすべての画面を検証します。
Android スキャナ インテントは標準化されていますか?
いいえ。ブロードキャスト アクションの名前、追加機能、構成、権限は、デバイス ベンダーや SDK バージョンによって異なる場合があります。
アプリは常にベンダー SDK を使用する必要がありますか?
いいえ。アプリケーションがウェッジや設定されたインテントでは提供できないスキャナ制御または状態を必要とする場合に使用します。 SDK は、ライフサイクルと互換性の作業を追加します。
証拠と限界
エンジニアリング アーキテクチャのガイダンス / 正確な動作にはデバイスの検証が必要です
Android プラットフォームの原則は、 UROVO SDK の証拠と組み合わされます。クロスベンダーの API 同等性は主張されません。
レビュー済み: 2026-08-10
- Android 開発者ドキュメント: 入力イベントとブロードキャスト レシーバー
- RuggedLayer が承認しました UROVO Android SDK v4.1.0326 API リファレンス
