Skip to content
Material Design 2
Main Navigation
v3
v2
v1

Português – Brasil

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

Português – Brasil

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

Aparência

Sidebar Navigation

Sistema Material

Introdução

Estudos do Material Design

Sobre os Estudos do Material Design

Basil

Crane

Fortnightly

Owl

Rally

Reply

Shrine

Fundamentos do Material

Ambiente

Superfícies

Elevação

Luz e sombras

Layout

Entendendo o layout

Densidade de pixels

Grade de layout responsiva

Métodos de espaçamento

Comportamento de componentes

Aplicação de densidade

Navegação

Entender a navegação

Transições de navegação

Pesquisa

Cor

O sistema de cores

Aplicar cor à UI

Uso de cores

Legibilidade do texto

Tema escuro

Tipografia

O sistema tipográfico

Entendendo a tipografia

Suporte a idiomas

Som

Sobre o som

Aplicando som à UI

Atributos do som

Coreografia de som

Iconografia

Ícones de produto

Ícones do sistema

Ícones animados

Forma

Sobre a forma

Forma e hierarquia

Forma como expressão

Forma e movimento

Aplicando formas à interface

Movimento

Entendendo o movimento

O sistema de movimento

Velocidade

Coreografia

Personalização

Interação

Gestos

Seleção

Estados

Comunicação

Confirmação e reconhecimento

Formatos de dados

Visualização de dados

Estados vazios

Ajuda e feedback

Imagens

Tela de abertura

Onboarding

Estados offline

Escrita

Aprendizado de máquina

Padrões de aprendizado de máquina

Detecção de objetos: câmera ao vivo

Detecção de objetos: imagem estática

Leitura de código de barras

Diretrizes do Material

Material Theming

Visão geral

Implementando seu tema

Usabilidade

Acessibilidade

Bidirecionalidade

Diretrizes de plataforma

Barras do Android

Impressão digital no Android

Feedback tátil do Android

Ícones do Android

Navegação entre apps no Android

Notificações no Android

Permissões do Android

Slices do Android

Tela dividida no Android

Deslizar para atualizar no Android

Barra de ferramentas de seleção de texto no Android

Widget do Android

Adaptação multiplataforma

Componentes

Barras de aplicativo: inferior

Barras de aplicativo superiores

Backdrop

Banners

Navegação inferior

Botões

Botões: botão de ação flutuante

Cartões

Caixas de seleção

Chips

Tabelas de dados

Seletores de data

Diálogos

Divisores

Listas de imagens

Listas

Menus

Gaveta de navegação

Trilho de navegação

Indicadores de progresso

Botões de opção

Folhas inferiores

Folhas laterais

Controles deslizantes

Snackbars

Interruptores

Abas

Campos de texto

Seletores de horário

Tooltips

Nesta página

Leitura de código de barras ​

Com o uso de aprendizado de máquina, a câmera em tempo real de um dispositivo pode ler os dados codificados na maioria dos formatos padrão de código de barras.

Imagem principal da leitura de código de barras

Uso ​

Os códigos de barras são uma forma simples e conveniente de transferir dados complexos ou estruturados do mundo real para um dispositivo. A API de leitura de código de barras do ML Kit permite que seu app leia a maioria dos formatos padrão de código de barras sem que os usuários precisem recorrer a um app separado de leitura de códigos de barras.

O escaneamento de códigos de barras pode ajudar os usuários em tarefas simples de identificação e de consulta de conteúdo, como pesquisar um produto para comprar, acessar detalhes de um evento ou preencher um formulário.

Essas diretrizes de design abordam o escaneamento de códigos de barras usando a transmissão em tempo real da câmera.

O escaneamento de código de barras oferece aos usuários uma alternativa conveniente à busca manual de informações de produtos ou à inserção de dados.

Documentação da API do ML Kit

Guias para desenvolvedores sobre leitura de códigos de barras

Link relacionado

Exemplo – Android

App de demonstração do ML Kit para Android

Link relacionado

Princípios ​

O design deste recurso se baseia nos seguintes princípios:

Navegue com a câmera do dispositivo

Em vez de o usuário digitar um termo de pesquisa, a câmera do dispositivo é usada como um “controle remoto” para escanear códigos de barras.

Para instruir os usuários sobre como escanear códigos de barras com a câmera, forneça uma experiência de onboarding e instruções sempre visíveis.

Uma experiência de onboarding breve e animada pode mostrar como escanear um código de barras, orientando os usuários a posicionar corretamente a câmera do dispositivo.

Mantenha a visualização da câmera livre de obstruções e legível

Alinhe os componentes da interface da câmera às bordas superior e inferior da tela, garantindo que o texto e os ícones permaneçam legíveis quando exibidos sobre a imagem da câmera.

Todos os elementos não interativos exibidos sobre a transmissão em tempo real da câmera devem ser translúcidos para minimizar a obstrução da visualização da câmera.

A maioria dos elementos da experiência é posicionada ao longo das bordas superior e inferior da tela para maximizar a visualização
A maioria dos elementos da experiência é posicionada ao longo das bordas superior e inferior da tela para maximizar a visualização da transmissão da câmera.

Ofereça feedback

Usar uma câmera para escanear códigos de barras introduz requisitos de uso específicos. A qualidade da imagem precisa ser adequada; além disso, os usuários devem saber como corrigir problemas de imagem causados pela iluminação ou pela distância excessiva em relação a um código de barras.

Os estados de erro devem ser comunicados com vários recursos visuais (como componentes e movimento) e incluir explicações sobre como os usuários podem melhorar a leitura.

A moldura do código de barras e o tooltip indicam que o usuário precisa aproximar o dispositivo do código de barras para “concluir” o escaneamento
A moldura do código de barras e o tooltip indicam que o usuário precisa aproximar o dispositivo do código de barras para “concluir” o escaneamento.

Componentes ​

A leitura de código de barras com a câmera em tempo real usa componentes existentes do Material Design e novos elementos específicos da interação com a câmera. Para conferir amostras de código e demonstrações de novos elementos (como a moldura do código de barras), acesse o código-fonte do app de demonstração do ML Kit com Material Design no Android.

Elementos-chave nas diferentes fases de uma experiência de leitura de código de barras
Elementos-chave nas diferentes fases de uma experiência de leitura de código de barras:
1. Barra de aplicativo superior
2. Moldura do código de barras
3. Tooltip
4. Folha inferior modal
Componentes

Exemplo – Android

App de demonstração do ML Kit para Android

Link relacionado

Barra de aplicativo superior ​


A barra de aplicativo superior oferece acesso persistente às seguintes ações:

  • Um botão para sair da experiência de busca
  • Um botão de alternância para melhorar a iluminação (usando o flash da câmera)
  • Uma seção de Ajuda para solucionar problemas de leitura
Faça: use um scrim em gradiente ou uma cor sólida no contêiner da barra de apps superior para garantir que as ações fiquem legíveis sobre a transmissão da câmera

Faça

Use um scrim em gradiente ou uma cor sólida no contêiner da barra de aplicativo superior para garantir que as ações fiquem legíveis sobre a transmissão da câmera.

Barra de aplicativo superior

A barra de aplicativo superior exibe informações e ações relativas à tela atual.

Artigo relacionado

Moldura do código de barras ​

A moldura do código de barras é uma área no centro da tela onde o usuário pode escanear um código de barras. Por padrão, a moldura é um quadrado, mas seu tamanho e sua proporção devem ser ajustados pelo seu app para corresponder aos tipos de código de barras compatíveis.

Ela tem três finalidades:

  1. Confirmação: o formato da moldura corresponde às dimensões de um único código de barras, deixando claro que apenas um código de barras pode ser escaneado por vez.
  2. Legibilidade: embora formatos simples de código de barras possam ser lidos à distância, formatos complexos (como o PDF417) podem exigir uma captura mais próxima e de melhor qualidade para serem lidos com precisão. Ao exibir uma borda de detecção parcial sobre a moldura do código de barras, a interface indica que o usuário deve se aproximar para escanear.
  3. Atividade: a borda da moldura pulsa durante a fase de “sensoriamento” para indicar que o app está procurando códigos de barras para escanear.
A moldura do código de barras fornece um guia animado que mostra: onde um código de barras deve ser escaneado, se é preciso ampliá-lo na tela e o estado atual do escaneamento.

Estados da moldura do código de barras:

1. O sensoriamento usa uma animação de pulsação para indicar que o app está procurando códigos de barras para escanear
2. Uma borda parcial é exibida sobre a moldura (junto com um tooltip) para indicar que o usuário precisa se aproximar do código de barras
3. A busca do valor é expressa por meio de um indicador de progresso indeterminado ao longo da moldura do código de barras
4. Em caso de erro, o estilo do traço da moldura do código de barras muda de contínuo para pontilhado

Tooltip ​

Os tooltips exibem textos informativos para os usuários. Por exemplo, eles indicam estados (como “Buscando…”) e orientam o usuário sobre a próxima etapa (como “Aponte a câmera para um código de barras”).

Faça: escreva mensagens curtas usando termos adequados ao seu público

Faça

Escreva mensagens curtas usando termos adequados ao seu público.
Não use verbos de ação em tooltips, como “Toque para pesquisar”, porque eles não são elementos interativos

Não faça

Não use verbos de ação em tooltips, como “Toque para pesquisar”, porque eles não são elementos interativos.

Não coloque mensagens de erro em um tooltip

Não faça

Não coloque mensagens de erro em um tooltip. Os erros devem ser exibidos em um banner para dar mais ênfase e oferecer espaço para ações.

Tooltips

Exibe textos informativos quando os usuários passam o cursor sobre um elemento, colocam o foco nele ou o tocam

Artigo relacionado

Folha inferior modal ​

As folhas inferiores modais fornecem acesso às informações de um código de barras enquanto o usuário permanece no leitor de código de barras. O layout e o conteúdo da folha inferior dependem do tipo de dados retornado pelo código de barras, por exemplo:

  • Dados estruturados (como informações de contato) podem ser exibidos em campos de texto para visualização e edição
  • As informações recuperadas de um banco de dados devem ser exibidas em um estilo adequado ao tipo de conteúdo, que varia bastante: o conteúdo de uma rede social, por exemplo, tem uma estrutura diferente do conteúdo de um produto de varejo.

Exibição dos resultados ​

Se for mais rápido ou mais fácil para o usuário concluir a tarefa em outra tela do app, apresente as informações do código de barras nessa tela em vez de exibi-las em uma folha inferior modal. Consulte a seção Experiência para saber mais sobre quando e onde comunicar as informações do código de barras no app.

Os campos de texto são adequados para apresentar dados estruturados em uma folha inferior
Os campos de texto são adequados para apresentar dados estruturados em uma folha inferior. O rótulo e a entrada de cada campo podem representar uma “chave” de dados e o respectivo “valor”, como o nome de uma rede Wi-Fi.
O layout de uma folha inferior modal pode ser personalizado para se adequar às informações de um código de barras
O layout de uma folha inferior modal pode ser personalizado para se adequar às informações de um código de barras, como um perfil de usuário de rede social.

Folhas inferiores

Superfícies que contêm conteúdo complementar e ficam ancoradas na parte inferior da tela.

Artigo relacionado

Experiência ​

A leitura de código de barras com a câmera em tempo real ocorre em três fases:

  1. Sensoriamento: usar a câmera para buscar dados de entrada
  2. Reconhecimento: detectar um código de barras
  3. Comunicação: exibir os resultados do código de barras na mesma tela ou em outra tela

Sensoriamento ​

O “sensoriamento” é a fase em que a câmera procura códigos de barras na transmissão em tempo real. A leitura de código de barras começa quando o usuário abre o recurso de leitura de código de barras em um app.

Durante essa fase, o app deve:

  • Descrever como o recurso funciona
  • Comunicar o que o app está fazendo
  • Orientar o usuário sobre ajustes na forma de controlar a câmera

Faça

Explique a interação com uma experiência de onboarding em uma única tela. Recomenda-se usar animação para demonstrar ao usuário como mover o dispositivo.

Faça

Comunique que o app está procurando códigos de barras. A moldura do código de barras usa uma animação de pulsação para indicar que o app está “escaneando” a transmissão da câmera, além de um tooltip que orienta o usuário a centralizar um código de barras na moldura.

Oriente o usuário sobre os ajustes

Condições do ambiente, como iluminação em excesso ou insuficiente, podem dificultar o escaneamento de um código de barras.

Uma seção de Ajuda pode auxiliar os usuários a identificar e resolver problemas com a experiência
Uma seção de Ajuda pode auxiliar os usuários a identificar e resolver problemas com a experiência. Ela pode fornecer orientação sobre tópicos como ângulos adequados da câmera, distância e condições de iluminação.

Reconhecimento ​

Quando um código de barras for detectado pela câmera, o app deve:

  1. Pausar a câmera e ler o valor do código de barras
  2. Exibir o valor imediatamente, se ele contiver dados estruturados
  3. Realizar a busca e exibir seu progresso, se o valor do código de barras precisar ser consultado

Nesta fase, um código de barras é detectado pela câmera e lido pela API de leitura de código de barras do ML Kit. A transmissão da câmera é pausada para evitar que outro código de barras seja escaneado.

Os códigos de barras que contêm dados estruturados reconhecidos pela API (como coordenadas de localização e eventos da agenda) podem ser apresentados imediatamente ao usuário. Se os dados de um código de barras não forem estruturados, suas informações detalhadas serão recuperadas de um banco de dados. O app exibe um estado de carregamento enquanto essas informações são recuperadas.

Faça

Use vários recursos de design para indicar que um código de barras compatível foi detectado. A borda da moldura do código de barras passa de transparente para opaca enquanto a transmissão da câmera é pausada.

Faça

Se o seu app precisar consultar o valor de um código de barras, exiba um indicador de progresso indeterminado e uma mensagem de tooltip para comunicar que os resultados estão pendentes.

Solução de problemas ​

A detecção de um código de barras não garante que seu app encontrará resultados. Os problemas a seguir podem ocorrer:

  • Nenhum resultado relevante: um código de barras escaneado com sucesso pode não conter informações relevantes para o seu app ou caso de uso, como ao escanear um código de barras de uma fonte não relacionada ao seu caso de uso.
  • Conexão de rede perdida: se o valor do código de barras for consultado em um banco de dados on-line, a solicitação de dados poderá falhar quando o dispositivo estiver sem conexão de rede.
  • Tamanho pequeno do código de barras: embora formatos simples de código de barras possam ser lidos à distância, formatos complexos (como o PDF417) podem exigir uma captura mais próxima e de melhor qualidade para serem lidos. Para indicar que o usuário precisa se aproximar do código de barras antes que ele possa ser escaneado, defina um tamanho mínimo de escaneamento para os formatos de código de barras aceitos pelo seu app e use vários recursos visuais (como a moldura do código de barras e o tooltip).

Faça: use um banner para indicar quando nenhum resultado correspondente for identificado

Faça

Use um banner para indicar quando nenhum resultado correspondente for identificado. Forneça opções para acessar uma seção de Ajuda dedicada ou tentar novamente com outra captura.

Faça

Defina um tamanho mínimo de escaneamento para os formatos de código de barras aceitos pelo seu app para garantir que sejam escaneados com precisão. Instrua o usuário a se aproximar do código de barras até que ele atinja o tamanho mínimo de escaneamento.

Erros + falha graciosa

Como lidar com erros de aprendizado de máquina

Link relacionado

Comunicação ​

Os resultados de um escaneamento de código de barras podem ser exibidos de várias maneiras:

  • Sobre a imagem da câmera (em uma folha inferior modal ou diálogo)
  • Fora do leitor de código de barras, em outra tela do app, onde as informações do código de barras podem ser usadas

Para adaptar a interface ao seu caso de uso de código de barras, recomendamos os seguintes padrões de navegação e componentes:

Exemplo de caso de usoPermanecer no leitor de código de barras?Local de exibição dos resultados
Navegar por produtos em uma lojaSimFolha inferior modal
Adicionar um contatoSim, até que o usuário salve o contatoFolha inferior modal ou diálogo em tela cheia
Preencher um formulárioNão, retornar ao formulárioPreencher os campos relevantes do formulário para o usuário

Faça

Exiba os resultados do código de barras sobre a imagem da câmera para que os usuários possam escanear mais itens sem precisar reabrir o leitor.

Faça

Permita que os usuários editem e salvem informações (como um novo contato) rapidamente no leitor de código de barras. Apresente dados estruturados em campos de texto editáveis, com uma opção para salvar e sair do leitor.

Faça

Escanear um código de barras pode oferecer uma alternativa ao preenchimento manual dos campos de um formulário. Após a conclusão bem-sucedida do escaneamento, leve o usuário de volta ao formulário para concluir a tarefa.

Tematização ​

Tema Material do Shrine ​

A leitura de código de barras é usada no fluxo de compra do app Shrine.

O scrim e o texto do tooltip do código de barras do Shrine são enfatizados com cores escuras que contrastam com os fundos claros
O scrim e o texto do tooltip do código de barras do Shrine são enfatizados com cores escuras que contrastam com os fundos claros.
Os resultados da leitura usam as cores da marca, a tipografia e os estilos de forma do Shrine
Os resultados da leitura usam as cores da marca, a tipografia e os estilos de forma do Shrine.

Moldura do código de barras ​

A moldura do código de barras do Shrine usa a própria cor On Primary como scrim. A borda da moldura tem cantos retos que expressam a forma geométrica do logotipo da marca.

A moldura do código de barras padrão usa #000000 como cor do scrim, com cantos arredondados
1. A moldura do código de barras padrão usa #000000 como cor do scrim, com cantos arredondados.
2. A moldura do código de barras do Shrine usa Shrine Pink 900 (#442C2E) como cor do scrim, com cantos retos.

Tooltip ​

O tooltip do Shrine ganha destaque com o uso de cores, tipografia e posicionamento personalizados.

Os tooltips geralmente são componentes de baixa ênfase cuja largura é baseada no texto
1. Os tooltips geralmente são componentes de baixa ênfase cuja largura é baseada no texto.
2. O tooltip do Shrine usa cores e tipografia personalizadas, e seu contêiner se estende até as bordas da tela.

Shrine

Shrine é uma marca de estilo de vida e moda que demonstra como o Material Design pode ser usado no comércio eletrônico.

Artigo relacionado

Pager
AnteriorDetecção de objetos: imagem estática
PróximoVisão geral

Distribuído sob a Licença Apache-2.0.

Copyright © 2018-Present Google

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

Distribuído sob a Licença Apache-2.0.

Copyright © 2018-Present Google