Skip to main content

camera_overlay 0.0.1 copy "camera_overlay: ^0.0.1" to clipboard
camera_overlay: ^0.0.1 copied to clipboard

Flutter camera widget with customizable overlay, GPS metadata and optional mini-map.

camera_overlay 📷🧩 #

Um pacote Flutter para captura de fotos utilizando a câmera do dispositivo com overlay customizável sobre o preview, ideal para aplicações que precisam de enquadramento guiado, marcações visuais ou validação visual antes da captura.


✨ Funcionalidades #

  • Preview de câmera usando o plugin oficial camera
  • Suporte a overlay customizado (widgets sobre a câmera)
  • Captura de imagem respeitando o overlay exibido
  • Estrutura desacoplada para fácil reutilização em outros projetos
  • Compatível com Android e iOS

📦 Instalação #

Adicione no seu pubspec.yaml:

dependencies:
  camera_overlay:
    git:
      url: https://github.com/NotlistForU/camera_overlay.git
      ref: main

🚀 Exemplo #

Parâmetro Tipo Descrição
temBotaoGaleria bool Exibe botão para abrir a galeria
temBotaoGoogleMaps bool Exibe botão para abrir o Google Maps
temMiniMapa bool Exibe mini mapa no overlay
onFotoFinal Function Callback chamado após a captura da foto
builder: (_) => CameraOverlay(
                  temBotaoGaleria: false,
                  temBotaoGoogleMaps: false,
                  temMiniMapa: false,
                  onFotoFinal: (bytes, localizacao) async {
                    // bytes -> imagem capturada
                    // localizacao -> dados de localização (se disponível)

                    if (bytes == null) return;

                    // Exemplo: salvar imagem localmente,
                    // enviar para API ou processar os bytes
                  },
                ),
onFotoFinal: (Uint8List? bytes, dynamic localizacao) async {
  if (bytes == null) return;

  // bytes: imagem capturada pela câmera
  // localizacao: informações de localização associadas à captura (se habilitado)

  // Exemplo de uso:
  // - salvar arquivo
  // - enviar para backend
  // - processar imagem
}

📷 Exemplo visual #

Mini-mapa interativo, que permite se movimentar pelo mapa e aplicar zoom. Se aperta e segurar no minimapa ele redefine a posição dele para a sua posição atual.

[Exemplo de uso do Camera Overlay]