Câmera de Captura do Canhoto
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Câmera de Captura do Canhoto
A Câmera de Captura do Canhoto é a tela de câmera usada para fotografar o canhoto físico de uma entrega.
Visão Geral
A Câmera de Captura do Canhoto é a tela de câmera usada para fotografar o canhoto físico de uma entrega. Você chega a ela a partir da tela de Canhoto Físico, no momento em que decide fotografar o canhoto assinado pelo destinatário. A câmera abre sempre em modo paisagem, com um guia visual sobreposto que demarca a área onde o canhoto deve ser posicionado. Depois de capturada, a foto é recortada automaticamente para essa área e você volta para a tela de Canhoto Físico já com a foto tirada.
Pré-requisitos
- O aparelho precisa ter uma câmera disponível e com permissão de uso concedida ao aplicativo. Sem isso, a tela de captura fica travada no carregamento, sem abrir a câmera (ver Troubleshooting).
- Você só chega a esta tela a partir da tela de Canhoto Físico, ao optar por fotografar o canhoto físico da entrega.
Fluxo Operacional
- Na tela de Canhoto Físico, você toca na opção de fotografar o canhoto.
- A câmera abre em modo paisagem, com a pré-visualização ao vivo e um guia retangular sobreposto, trazendo a instrução para posicionar o canhoto.
- Se quiser, você pode: tocar na pré-visualização para ajustar o foco no ponto tocado; alternar o flash entre desligado, sempre ligado e automático; e, se o aparelho tiver mais de uma câmera, trocar entre elas.
- Você toca no botão de captura.
- O aplicativo tira a foto, mostra um indicador de carregamento enquanto recorta automaticamente a imagem para a área do guia, e volta para a tela de Canhoto Físico já com a foto tirada.
- Se você tocar no botão de voltar antes de capturar, a câmera fecha sem nenhuma foto.
Interface e Comportamentos
Orientação em Modo Paisagem na Captura do Canhoto
A tela de captura do canhoto sempre abre em modo paisagem, mesmo que o restante do aplicativo esteja em modo retrato. Ao sair dela — com ou sem foto — o aplicativo volta ao modo retrato.
Guia Visual de Posicionamento do Canhoto
Um retângulo com borda branca, centralizado na tela, demarca a área onde o canhoto deve ficar posicionado, com a instrução “Posicione o canhoto dentro da área” acima dele. Ao redor do retângulo, o restante da imagem aparece escurecido.
Ajuste de Foco ao Tocar na Tela
Tocar em qualquer ponto da pré-visualização ajusta o foco e a exposição da câmera para esse ponto; um indicador quadrado amarelo aparece brevemente no local tocado.
Controle de Flash
Um botão alterna o flash em ciclo: desligado → sempre ligado → automático → desligado novamente. O ícone e a cor do botão mudam conforme o modo ativo.
Troca entre Câmeras do Aparelho
Se o aparelho tiver mais de uma câmera, um botão de troca aparece na tela, alternando ciclicamente entre elas. Com apenas uma câmera, esse botão não aparece.
Indicador de Carregamento
Enquanto a câmera está abrindo, trocando ou processando a foto recém-tirada, a tela mostra apenas um indicador de carregamento em fundo preto — nenhum botão de câmera fica disponível nesse momento.
Feedbacks ao Usuário
Texto fixo na tela de captura
| Situação | Feedback | Texto exato |
|---|---|---|
| Câmera pronta, aguardando você posicionar o canhoto | Texto instrutivo acima do guia visual | “Posicione o canhoto dentro da área” |
Feedbacks visuais sem texto
| Situação | Feedback | Mensagem |
|---|---|---|
| Câmera abrindo, trocando, ou processando a foto tirada | Tela cheia com indicador de carregamento sobre fundo preto | Nenhuma — apenas o indicador giratório |
| Você toca na pré-visualização | Quadrado amarelo aparece no ponto tocado por alguns segundos | Nenhuma — apenas o indicador visual |
| Você alterna o flash | Ícone do botão de flash muda de forma e de cor | Nenhuma — apenas o ícone |
Regras de Negócio
- Modo paisagem: a câmera do canhoto sempre abre em modo paisagem e volta ao modo retrato ao fechar.
- Guia de posicionamento: a área demarcada pelo guia fica sempre centralizada na tela; é essa mesma área usada no recorte automático da foto.
- Flash: o ciclo é sempre desligado → sempre ligado → automático → desligado.
- Troca de câmera: só disponível com duas ou mais câmeras no aparelho; a troca segue sempre a mesma ordem, ciclicamente.
- Foco ao toque: tocar na pré-visualização ajusta o foco e a exposição para o ponto tocado.
- Recorte automático: depois de tirada, a foto é recortada automaticamente para a mesma área demarcada pelo guia visual, para focar no canhoto e descartar o restante da cena.
- Botão de captura: só funciona quando a câmera já está pronta; enquanto ela carrega, troca ou processa a foto anterior, o botão fica indisponível (a tela mostra só o indicador de carregamento).
- Retorno da foto: ao concluir a captura, você volta automaticamente para a tela de Canhoto Físico já com a foto tirada; se voltar sem capturar, nenhuma foto é registrada.
Evidências e Documentos Gerados
A foto do canhoto físico é sempre um arquivo novo, tirado a cada captura — a câmera não reaproveita nenhuma foto anterior dentro dela mesma. Ao concluir a captura, o aplicativo devolve essa foto para a tela de Canhoto Físico, que segue com a conferência e o registro da evidência.
Troubleshooting
A tela de captura do canhoto fica travada no indicador de carregamento e nunca mostra a câmera
Cenário: ao abrir a câmera de captura do canhoto (ou ao tentar trocar de câmera), o aparelho não tem nenhuma câmera disponível, a permissão de câmera não foi concedida ao aplicativo, ou a câmera falha ao abrir por outro motivo do aparelho.
Mensagem exibida: Nenhuma — a tela permanece com fundo preto e o indicador de carregamento, sem previsualização de câmera nem botões.
O que fazer: verifique se o aplicativo tem permissão de câmera concedida nas configurações do aparelho; feche e abra novamente a captura do canhoto físico; se persistir, tente em outro aparelho ou contate o suporte.
A foto não é tirada e a tela apenas volta a mostrar a câmera, sem nenhuma explicação
Cenário: você toca no botão de captura, mas ocorre uma falha no momento de tirar a foto.
Mensagem exibida: Nenhuma — a tela volta a mostrar a pré-visualização da câmera normalmente, como se nada tivesse acontecido.
O que fazer: tente capturar a foto novamente; se o problema persistir, feche e abra novamente a captura do canhoto físico.
A foto tirada mostra a cena inteira em vez de apenas a área do canhoto demarcada pelo guia
Cenário: depois de tirar a foto, o aplicativo não consegue concluir o recorte automático para a área do guia visual.
Mensagem exibida: Nenhuma — o aplicativo segue normalmente, como se o recorte tivesse funcionado, mas a foto volta sem o corte.
O que fazer: se a foto do canhoto aparecer sem o enquadramento esperado (mostrando a cena inteira em vez de só o canhoto), repita a captura; se acontecer sempre no mesmo aparelho, contate o suporte.
Casos de Uso
Caso 1 — Captura do canhoto em condições normais de luz
Você abre a câmera a partir da tela de Canhoto Físico, aponta para o canhoto assinado, posiciona o documento dentro da área do guia visual, toca na tela para ajustar o foco e toca no botão de captura. O aplicativo recorta automaticamente a imagem para a área do guia e volta para a tela de Canhoto Físico já com a foto.
Caso 2 — Captura em ambiente com pouca luz, usando o flash
Em uma entrega noturna ou em local pouco iluminado, você alterna o flash de desligado para sempre ligado antes de capturar, para melhorar a legibilidade do canhoto na foto.
Caso 3 — Troca de câmera em aparelho com mais de uma câmera traseira
Você toca no botão de troca de câmera para alternar entre as câmeras disponíveis no aparelho antes de capturar, buscando melhor ângulo ou qualidade de imagem.
Caso 4 — Desistência da captura antes de fotografar
Você toca no botão de voltar antes de tirar a foto. A câmera fecha sem devolver nenhuma imagem, e a tela de Canhoto Físico permanece como estava antes, sem nenhum canhoto novo registrado.
