Skip to content
Material Design 2
Main Navigation
v3
v2
v1

简体中文

English
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

简体中文

English
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

主题

Sidebar Navigation

Material 系统

简介

Material 案例研究

关于 Material 案例研究

Basil

Crane

Fortnightly

Owl

Rally

Reply

Shrine

Material 基础

环境

表面

海拔(Elevation)

光与阴影

布局

了解布局

像素密度

响应式布局网格

间距方法

组件行为

应用密度

导航

了解导航

导航转场

搜索

颜色

色彩系统

为 UI 应用颜色

颜色的使用

文本可读性

深色主题

字体排印

字体系统

理解字体排印

语言支持

声音

关于声音

将声音应用于 UI

声音属性

声音编排

图标

产品图标

系统图标

动画图标

形状

关于形状

形状与层级

形状即表达

形状与动效

将形状应用于 UI

动效

理解动效

动效系统

速度

编排(Choreography)

自定义

交互

手势

选择

状态

沟通

确认与告知

数据格式

数据可视化

空状态

帮助与反馈

图像

启动屏幕

新手引导

离线状态

文案写作

机器学习

机器学习模式

物体检测:实时相机

对象检测:静态图片

条形码扫描

Material 指南

Material 主题化

概述

实现你的主题

可用性

无障碍

双向性

平台指南

Android 系统栏

Android 指纹

Android 触觉反馈

Android 图标

Android 应用间导航

Android 通知

Android 权限

Android 切片

Android 分屏

Android 下拉刷新

Android 文本选择工具栏

Android 小组件

跨平台适配

组件

底部应用栏

顶部应用栏

背景板

横幅

底部导航

按钮

按钮:浮动操作按钮

卡片

复选框

标签(Chips)

数据表

日期选择器

对话框

分隔线

图片列表

列表

菜单

导航抽屉

导航轨道

进度指示器

单选按钮

底部工作表

侧边工作表(Sheets: side)

滑块

提示条

开关

标签页

文本框

时间选择器

工具提示

页面导航

条形码扫描 ​

借助机器学习,设备的实时相机可以读取大多数标准条形码格式中编码的数据。

条形码扫描主图

用法 ​

条形码是一种将复杂或结构化数据从现实世界传输到设备的简单便捷方式。ML Kit 的条形码扫描 API 可以让应用读取大多数标准的条形码格式,无需用户切换到单独的条形码扫描应用。

扫描条形码可以帮助用户完成简单的识别类和内容类任务,例如查找要购买的商品、查看活动详情或填写表单。

本设计准则适用于使用实时相机画面的条形码扫描场景。

条形码扫描为用户提供了一种便捷的替代方式,无需手动搜索产品信息或输入数据。

ML Kit API 文档

条形码扫描开发者指南

相关链接

示例 – Android

Android 版 ML Kit 展示应用

相关链接

设计原则 ​

此功能的设计基于以下原则:

以相机为主要操作方式

用户无需输入搜索词,只需将设备相机当作“遥控器”来扫描条形码。

为了帮助用户了解如何用相机扫描条形码,请提供新手引导,并在使用过程中持续显示操作说明。

简短的动画式新手引导可以向用户演示如何正确摆放设备相机来扫描条形码。

保持相机预览清晰可见

将相机 UI 组件沿屏幕顶部和底部边缘放置,确保叠加在相机画面上的文本和图标清晰易读。

显示在实时相机画面上方的所有非交互元素都应采用半透明样式,以尽量减少对相机画面的遮挡。

体验中的大多数元素都沿屏幕顶部和底部边缘放置,以最大限度地展示相机画面
体验中的大多数元素都沿屏幕顶部和底部边缘放置,以最大限度地露出相机画面。

提供反馈

使用相机扫描条形码有一些特殊要求:相机画面质量需要达到一定标准,用户也需要了解如何解决因光线不足或距离太远而导致的画面问题。

错误状态应通过多种设计手段(例如组件和动效)来传达,并告知用户如何改进扫描操作。

条形码框和工具提示均提示用户需要靠近条形码才能“完成”扫描
条形码框和工具提示均提示用户需要靠近条形码才能“完成”扫描。

组件 ​

实时相机条形码扫描使用现有的 Material Design 组件,以及专用于相机交互的新元素。如需查看条形码框等新元素的代码示例和演示,请参阅 Android 版 ML Kit Material Design 展示应用的源代码。

条形码扫描体验各阶段的关键元素
条形码扫描体验各阶段的关键元素:
1. 顶部应用栏
2. 条形码框
3. 工具提示
4. 模态底部工作表
组件

示例 – Android

Android 版 ML Kit 展示应用

相关链接

顶部应用栏 ​


顶部应用栏提供以下功能的常驻入口:

  • 退出搜索体验的按钮
  • 手电筒开关(使用相机闪光灯提高亮度)
  • 用于排查扫描问题的帮助入口
推荐:顶部应用栏的容器应使用渐变遮罩或纯色,确保其操作在相机画面上清晰易读

推荐

顶部应用栏的容器应使用渐变遮罩或纯色,以确保其操作在相机画面上清晰易读。

顶部应用栏

顶部应用栏显示与当前视图相关的信息和操作。

相关文章

条形码框 ​

条形码框是屏幕中央用于扫描条形码的区域。默认情况下,该框是一个正方形,但应用应根据所支持的条形码类型调整其大小和宽高比。

它有以下三个用途:

  1. 确认:框的形状与单个条形码的尺寸相匹配,清楚地表明一次只能扫描一个条形码。
  2. 可读性:简单的条形码格式可以从较远处读取,而复杂的条形码格式(例如 PDF417)则需要更近距离、更高质量的图像才能被准确读取。通过在条形码框上显示部分检测边框,UI 可以提示用户靠近条形码进行扫描。
  3. 活动状态:在“感应”阶段,框的边框会呈现脉冲动画,表明应用正在寻找可扫描的条形码。
条形码框提供动态引导,指示应在何处扫描条形码、条形码是否需要靠近,以及当前的扫描状态。

条形码框的状态:

1. 感应阶段使用脉冲动画,表明应用正在寻找可扫描的条形码
2. 在框上显示部分边框(连同工具提示),提示用户靠近条形码
3. 搜索状态通过横跨条形码框的不确定进度指示器来表现
4. 错误状态会将条形码框的连续描边样式改为虚线样式

工具提示 ​

工具提示用于向用户显示说明文字,既可以显示状态(例如“正在搜索……”),也可以提示下一步操作(例如“将相机对准条形码”)。

推荐:使用适合目标受众的措辞编写简短的文案

推荐

使用适合目标受众的措辞编写简短的文案。
不建议做法:不要在工具提示中使用动作动词(如“点按搜索”),因为工具提示本身不可交互

不推荐

不要在工具提示中使用动作动词,例如“点按搜索”,因为工具提示本身不可交互。

不建议做法:不要将错误消息放在工具提示中

不推荐

不要将错误消息放在工具提示中。错误应放在横幅中,以增强强调效果,并为操作按钮提供更多空间。

工具提示

当用户悬停、聚焦或点按某个元素时显示说明文字

相关文章

模态底部工作表 ​

模态底部工作表让用户无需离开条形码扫描功能即可查看条形码中的信息。底部工作表的布局和内容取决于扫描条形码得到的数据类型,例如:

  • 结构化数据(例如联系人信息)可以显示在文本框中,以便查看和编辑
  • 来自数据库的信息应采用适合该内容类型的样式显示。内容类型各不相同,例如,社交媒体内容的结构与零售产品内容不同。

显示结果 ​

如果用户在应用的其他屏幕上完成任务更快、更便捷,则应在该屏幕上呈现条形码信息,而不是在模态底部工作表中。有关何时以及在应用中的何处呈现条形码信息,请参阅 体验部分。

文本框非常适合在底部工作表中呈现结构化数据
文本框非常适合在底部工作表中呈现结构化数据。每个字段的标签和输入框可分别对应数据的“键”和“值”,例如 Wi-Fi 网络的名称。
模态底部工作表的布局可以自定义,以展示条形码所包含的信息
模态底部工作表的布局可以自定义,以展示条形码所包含的信息,例如社交媒体用户资料。

底部工作表

包含补充内容并固定在屏幕底部的表面。

相关文章

体验 ​

实时相机条形码扫描分为三个阶段:

  1. 感应:使用相机寻找扫描目标
  2. 识别:检测条形码
  3. 传达:在当前界面内或其他屏幕上显示条形码结果

感应 ​

“感应”是指相机在实时画面中搜寻条形码。当用户在应用中打开条形码功能时,扫描便开始了。

在此阶段,应用应当:

  • 说明该功能的工作方式
  • 告知用户应用正在执行的操作
  • 引导用户调整相机的使用方式

推荐

通过单屏的新手引导说明交互方式。建议使用动画向用户演示如何移动设备。

推荐

告知用户应用正在寻找条形码。条形码框使用脉冲动画来表明应用正在“扫描”相机画面,同时通过工具提示引导用户将条形码居中放置在框内。

引导调整

环境条件(例如环境过亮或过暗)可能会使条形码难以扫描。

帮助区域可以帮助用户识别并解决体验中遇到的问题
帮助区域可以帮助用户识别并解决体验中遇到的问题,例如就正确的相机角度、距离和光照条件提供指导。

识别 ​

当相机检测到条形码时,应用应当:

  1. 暂停相机并读取条形码的值
  2. 如果该值是结构化数据,则立即显示该值
  3. 如果条形码的值需要查询,则进行搜索并显示搜索进度

在此阶段,条形码扫描 API 会在相机画面中检测并读取条形码。相机预览会暂停,以防止扫描到另一个条形码。

如果条形码包含 API 可识别的结构化数据(例如位置坐标和日历活动),则可以立即呈现给用户。如果条形码的数据是非结构化的,则会从数据库中检索其详细信息。在检索期间,应用会显示加载状态。

推荐

使用多种设计手段表明已检测到受支持的条形码。当相机预览暂停时,条形码框的边框会由透明变为不透明。

推荐

如果你的应用需要查询条形码的值,请显示不确定进度指示器和工具提示消息,以表明正在获取结果。

问题处理 ​

检测到条形码并不保证应用一定能找到结果。可能出现以下问题:

  • 无相关结果:成功扫描的条形码可能不包含与你的应用或使用场景相关的信息,例如扫描了来自无关来源的条形码。
  • 网络连接丢失:如果需要在在线数据库中查询条形码的值,则在没有互联网连接的情况下,数据请求可能会失败。
  • 条形码尺寸过小:简单的条形码格式可以从较远处读取,而复杂的条形码格式(例如 PDF417)则需要更近距离、更高质量的图像才能被读取。为了提示用户靠近条形码以完成扫描,请为应用所支持的条形码格式设置最小扫描尺寸,并通过多种设计手段(例如条形码框和工具提示)加以提示。

推荐:当未识别到匹配的对象时,使用横幅进行提示

推荐

当未识别到匹配的对象时,使用横幅进行提示。提供访问专门的帮助区域或换一张图片重试的选项。

推荐

为应用所支持的条形码格式设置最小扫描尺寸,以确保这些格式的条形码能被准确扫描。提示用户靠近条形码,直到条形码达到最小扫描尺寸。

错误 + 优雅失败

如何处理 ML 错误

相关链接

传达 ​

条形码扫描的结果可以通过多种方式显示:

  • 在相机画面上显示(以模态底部工作表或对话框的形式)
  • 退出条形码扫描功能后,在可以使用条形码信息的屏幕上显示结果

为了针对你的条形码使用场景定制 UI,推荐以下导航模式和组件:

使用场景示例是否停留在条形码扫描功能中?结果显示位置
浏览商店中的商品是模态底部工作表
添加联系人是,直到用户保存模态底部工作表或全屏对话框
填写表单否,返回表单为用户填写表单中的相关字段

推荐

在相机画面上显示条形码结果,以便用户无需重新打开扫描功能即可扫描更多商品。

推荐

编辑和保存信息(例如新联系人)可以在条形码扫描功能中快速完成。在可编辑的文本框中呈现结构化数据,并提供保存并退出扫描功能的选项。

推荐

扫描条形码可以替代手动填写表单字段。扫描成功后,应让用户返回表单以完成任务。

主题 ​

Shrine Material 主题 ​

条形码扫描用于 Shrine 应用的购买流程。

Shrine 的条形码遮罩和工具提示文本使用深色以突显内容,与浅色背景形成对比
Shrine 的条形码遮罩和工具提示文本使用深色以突显内容,与浅色背景形成对比。
视觉搜索结果使用 Shrine 的品牌颜色、字体排印和形状样式
视觉搜索结果使用 Shrine 的品牌颜色、字体排印和形状样式。

条形码框 ​

Shrine 的条形码框使用其 On Primary 颜色作为遮罩色,框的边框采用尖角,以呼应品牌徽标的几何形状。

基准条形码框使用 #000000 作为遮罩颜色,并带有圆角边框
1. 基准条形码框使用 #000000 作为遮罩颜色,并带有圆角边框。
2. Shrine 的条形码框使用 Shrine Pink 900(#442C2E)作为遮罩颜色,并带有尖角边框。

工具提示 ​

Shrine 的工具提示采用自定义的颜色、字体排印和位置加以突显。

工具提示通常是弱强调组件,宽度取决于文本内容
1. 工具提示通常是弱强调组件,宽度取决于文本内容。
2. Shrine 的工具提示使用自定义的颜色和字体排印,并将其容器延伸至屏幕边缘。

Shrine

Shrine 是一个生活方式与时尚品牌,展示了如何在电子商务中运用 Material Design。

相关文章

Pager
上一页对象检测:静态图片
下一页概述

基于 Apache-2.0 许可证 发布。

Copyright © 2018-Present Google

https://m2.material.io/design/machine-learning/barcode-scanning.html

基于 Apache-2.0 许可证 发布。

Copyright © 2018-Present Google