Um plugin Flutter para usar o Google ML Kit Face Detection para detectar rostos em uma imagem, identificar características faciais importantes e obter os contornos dos rostos detectados.
Orientação gerada a partir de informações públicas. Apenas para referência.
O pacote google_mlkit_face_detection é um plugin Flutter que utiliza o ML Kit do Google para detectar rostos em imagens, identificar características faciais importantes como olhos, nariz e boca, e extrair contornos faciais. Ele permite detecção em tempo real com alta precisão em plataformas Android e iOS. Projetado para desenvolvedores que integram visão computacional em aplicativos móveis, oferece processamento local no dispositivo para privacidade e desempenho. O plugin faz parte do ecossistema mais amplo do Flutter ML Kit, proporcionando integração fluida com outras ferramentas de ML.
Casos de uso
Detecção facial em tempo real em aplicativos de câmera
Rastreamento de características faciais para efeitos AR
Autenticação de usuário por reconhecimento facial
Análise de imagem para ferramentas de acessibilidade
Marcação automática de fotos
Principais recursos
Detecção facial no dispositivo
Suporte à identificação de marcos faciais
Retorna contornos e posições faciais
Otimizado para desempenho móvel
Funciona no Android e no iOS
Indicado para
Desenvolvedores de aplicativos móveis
criadores de aplicativos AR/VR
Construtores de ferramentas de acessibilidade
Processamento de imagem focado em privacidade
Considerações
Requer dispositivo com poder de processamento suficiente
Limitado à detecção facial, não reconhecimento facial completo
Pode ser necessário pré-processamento adicional para imagens de baixa qualidade
Depende dos Serviços do Google Play no Android
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
⚠️ Important: GenAI APIs are built on top of AICore and will not support all Android devices. These APIs require devices with AICore support. Please check device compatibility before using these features in production.
⚠️ Production Disclaimer: Using GenAI plugins in production is the responsibility of the developers consuming the plugins, not the authors. The authors provide these plugins as-is and are not responsible for any issues, failures, or compatibility problems that may arise from using these plugins in production environments.
PLEASE READ THIS before continuing or posting a new issue:
Google's ML Kit was build only for mobile platforms: iOS and Android apps. Web or any other platform is not supported, you can request support for those platform to Google in their repo.
This plugin is not sponsored or maintained by Google. The authors are developers excited about Machine Learning that wanted to expose Google's native APIs to Flutter.
Google's ML Kit APIs are only developed natively for iOS and Android. This plugin uses Flutter Platform Channels as explained here.
Messages are passed between the client (the app/plugin) and host (platform) using platform channels as illustrated in this diagram:
Messages and responses are passed asynchronously, to ensure the user interface remains responsive. To read more about platform channels go here.
Because this plugin uses platform channels, no Machine Learning processing is done in Flutter/Dart, all the calls are passed to the native platform using MethodChannel in Android and FlutterMethodChannel in iOS, and executed using Google's native APIs. Think of this plugin as a bridge between your app and Google's native ML Kit APIs. This plugin only passes the call to the native API and the processing is done by Google's API. It is important that you understand this concept when it comes to debugging errors for your ML model and/or app.
Since the plugin uses platform channels, you may encounter issues with the native API. Before submitting a new issue, identify the source of the issue. You can run both iOS and/or Android native example apps by Google and make sure that the issue is not reproducible with their native examples. If you can reproduce the issue in their apps then report the issue to Google. The authors do not have access to the source code of their native APIs, so you need to report the issue to them. If you find that their example apps are okay and still you have an issue using this plugin, then look at our closed and open issues. If you cannot find anything that can help you then report the issue and provide enough details. Be patient, someone from the community will eventually help you.
Migrating from ML Kit for Firebase to the new standalone ML Kit SDK
When Migrating from ML Kit for Firebase to the new standalone ML Kit SDK read this guide.
Until https://github.com/flutter/flutter/issues/145961 is resolved, the most recent version of the camera package doesn't support the required image formats. To make things work, manually add the legacy plugin via the instructions from https://pub.dev/packages/camera_android.
Contributing
Contributions are welcome.
In case of any problems look at existing issues, if you cannot find anything related to your problem then open an issue.
Create an issue before opening a pull request for non trivial fixes.
In case of trivial fixes open a pull request directly.