バーコードスキャン
機械学習を使用することで、デバイスのライブカメラは、ほとんどの標準的なバーコード形式でエンコードされたデータを読み取ることができます。

使用方法
バーコードは、現実世界にある複雑なデータや構造化データをデバイスに取り込むための、シンプルで便利な方法です。ML Kit のバーコードスキャン API を使用すると、ユーザーが別のバーコード読み取りアプリに切り替えることなく、アプリ内でほとんどの標準的なバーコード形式を読み取れるようになります。
バーコードのスキャンは、購入する商品の検索、イベント詳細へのアクセス、フォームの入力など、識別やコンテンツの取得といったシンプルなタスクをユーザーが行う際に役立ちます。
このデザインガイドラインでは、ライブカメラ映像を使用したバーコードスキャンについて説明します。
原則
この機能のデザインは、以下の原則に基づいています。
デバイスのカメラで操作する
検索語を入力する代わりに、デバイスのカメラを「リモコン」のように使ってバーコードをスキャンします。
カメラを使ったバーコードのスキャン方法をユーザーに理解してもらうには、オンボーディングと、画面に常時表示される説明を提供します。
カメラ映像をクリアで見やすく保つ
カメラの UI コンポーネントは画面の上下端に配置し、カメラ映像の前面に配置するテキストやアイコンが見やすくなるようにします。
ライブカメラ映像の前面に表示される要素のうち、操作の対象ではないものは、カメラ映像の妨げを最小限に抑えるため、半透明にする必要があります。

フィードバックを提供する
カメラを使用したバーコードのスキャンには、固有の使用要件があります。画質は十分である必要があり、照明やバーコードとの距離が原因で生じる画像の問題を解決する方法を、ユーザーが把握できるようにする必要があります。
エラー状態は、複数のデザイン上の手がかり(コンポーネントやモーションなど)を使って伝え、ユーザーが検索を改善する方法についての説明を含める必要があります。

コンポーネント
ライブカメラでのバーコードスキャンでは、既存の Material Design コンポーネントと、カメラ操作に固有の新しい要素を使用します。新しい要素(バーコードフレームなど)のコードサンプルとデモについては、Android 向け ML Kit Material Design ショーケースアプリのソースコードをご覧ください。

1. トップアプリバー
2. バーコードフレーム
3. ツールチップ
4. モーダルボトムシート

トップアプリバー
トップアプリバーからは、以下の機能に常時アクセスできます。
- スキャンエクスペリエンスを終了するためのボタン
- カメラのフラッシュで明るさを補う切り替えボタン
- スキャンの問題を解決するためのヘルプセクション

推奨
バーコードフレーム
バーコードフレームは、画面中央にあり、ユーザーがバーコードをスキャンするための領域です。デフォルトではフレームは正方形ですが、サポートするバーコードの種類に合わせて、アプリでサイズとアスペクト比を調整する必要があります。
このフレームには 3 つの目的があります。
- 確認: フレームのシェイプは 1 つのバーコードのサイズに一致しているため、一度にスキャンできるのは 1 つのバーコードだけであることが明確になります。
- 読み取りやすさ: シンプルなバーコード形式は離れた場所からでも読み取れますが、複雑なバーコード形式(PDF417 など)を正確に読み取るには、より近くから撮影した高画質な画像が必要になる場合があります。部分的な検出境界線をバーコードフレームに重ねて表示することで、UI はユーザーに、バーコードにもっと近づいてスキャンするよう促します。
- 動作表示: 「検知」フェーズの間、フレームの境界線はパルスアニメーションで動き、アプリがスキャン対象のバーコードを探していることを示します。
1. 検知では、パルスアニメーションを使用して、アプリがスキャン対象のバーコードを探していることを示します
2. ユーザーがバーコードにもっと近づく必要があることを示すため、フレームの上に部分的な境界線を(ツールチップとともに)表示します
3. 検索中であることは、バーコードフレーム全体にわたる不確定進行状況インジケーターで表現されます
4. エラー時には、バーコードフレームのストロークスタイルが実線から点線に変わります
ツールチップ
ツールチップは、ユーザーに情報を伝えるテキストを表示します。たとえば、「検索中...」のような状態を表すメッセージを表示することも、「カメラをバーコードに向けてください」のような次のステップを促すメッセージを表示することもできます。

推奨

非推奨

非推奨
モーダルボトムシート
モーダルボトムシートにより、ユーザーはバーコードスキャン機能から離れることなく、バーコードの情報にアクセスできます。ボトムシートのレイアウトとコンテンツは、バーコードから返されるデータの種類によって異なります。たとえば、以下のとおりです。
- 構造化データ(連絡先情報など)は、内容の確認や編集ができるテキストフィールドに表示できます
- データベースから取得した情報は、コンテンツの閲覧に適したスタイルで表示する必要があります。コンテンツの種類はさまざまです。たとえば、ソーシャルメディアのコンテンツは、小売商品のコンテンツとは異なる構造になります。
結果の表示
ユーザーがアプリ内の別の画面でタスクを完了する方が速くて簡単な場合は、モーダルボトムシートの代わりに、その画面にバーコードの情報を表示します。バーコードの情報をアプリ内のどこで、どのタイミングで伝えるかについて詳しくは、エクスペリエンスのセクションをご覧ください。


エクスペリエンス
ライブカメラでのバーコードスキャンは、3 つのフェーズで行われます。
- 検知: カメラを使って入力を探します
- 認識: バーコードを検出します
- 伝達: バーコードの結果をインラインまたは別の画面に表示します
検知
「検知」とは、カメラがライブカメラ映像の中でバーコードを探すことを指します。バーコードスキャンは、ユーザーがアプリ内でバーコードスキャン機能を開いたときに始まります。
このフェーズでは、アプリは以下を行う必要があります。
- 機能の動作方法を説明する
- アプリの動作を伝える
- カメラを操作する際の調整方法をユーザーに案内する
推奨
推奨
調整方法の案内
明るすぎる場所や暗すぎる場所など、環境条件によってはバーコードのスキャンが難しくなることがあります。

認識
カメラがバーコードを検出したら、アプリは以下を行う必要があります。
- カメラを一時停止し、バーコードの値を読み取る
- 構造化データの場合は、値をすぐに表示する
- バーコードの値を検索する必要がある場合は、検索を実行して検索の進行状況を表示する
このフェーズでは、カメラ映像内のバーコードが検出され、バーコードスキャン API によって読み取られます。他のバーコードをスキャンしないように、カメラ映像は一時停止されます。
API によって認識される構造化データ(位置情報の座標やカレンダーの予定など)を含むバーコードは、すぐにユーザーに表示できます。バーコードのデータが構造化されていない場合は、詳細情報をデータベースから取得します。この情報を取得している間、アプリは読み込み中の状態を表示します。
推奨
推奨
修正を行う
バーコードを検出しても、アプリが結果を見つけられるとは限りません。以下の問題が発生する可能性があります。
- 関連する結果なし: スキャンに成功したバーコードでも、無関係なソースからスキャンされたものなど、アプリやユースケースに関連する情報が含まれていないことがあります。
- ネットワーク接続の切断: バーコードの値をオンラインデータベースで検索する場合、インターネットに接続されていないとデータリクエストが失敗することがあります。
- バーコードのサイズが小さい: シンプルなバーコード形式は離れた場所からでも読み取れますが、複雑なバーコード形式(PDF417 など)を読み取るには、より近くから撮影した高画質な画像が必要になる場合があります。スキャンできるようになる前にユーザーがバーコードにもっと近づく必要があることを示すには、アプリが受け入れるバーコード形式ごとに最小スキャンサイズを設定し、複数のデザイン上の手がかり(バーコードフレームやツールチップなど)を使用します。

推奨
推奨
伝達
バーコードスキャンの結果は、いくつかの方法で表示できます。
- カメラ映像の上に(モーダルボトムシートまたはダイアログで)
- バーコードスキャン機能を終了した後、バーコードの情報を扱う画面で
バーコードのユースケースに合わせて UI を調整するには、以下のナビゲーションパターンとコンポーネントの使用が推奨されます。
| ユースケースの例 | バーコードスキャナー内に残りますか? | 結果の表示場所 |
|---|---|---|
| 店内で商品を閲覧する | はい | モーダルボトムシート |
| 連絡先を追加する | はい、ユーザーが保存するまで | モーダルボトムシートまたは全画面ダイアログ |
| フォームに入力する | いいえ、フォームに戻ります | ユーザーの代わりにフォームの該当するフィールドを入力します |
推奨
推奨
推奨
テーマ設定
Shrine マテリアルテーマ
バーコードスキャンは、Shrine アプリの購入フローで使用されています。


バーコードフレーム
Shrine のバーコードフレームは、スクリムの色に On Primary カラーを使用しています。フレームの境界線にはシャープな角があり、ブランドロゴの幾何学的なシェイプを表現しています。

2. Shrine のバーコードフレームは、スクリムの色に Shrine Pink 900(#442C2E)を使用し、シャープなフレーム境界線になっています。
ツールチップ
Shrine のツールチップは、カスタムの色、タイポグラフィ、配置を使用することで強調されています。

2. Shrine のツールチップは、カスタムの色とタイポグラフィを使用し、コンテナを画面の端まで拡張しています。