CameraBio Android

Este projeto visa facilitar a implementação do frame de captura biométrica via aplicativos Android.

Começando

Estas instruções farão com que você consiga implementar a câmera com engenharia biométrica pré-existente e obter/manipular os dados de retorno.

Pré requisitos

• Android Studio - IDE oficial de desenvolvimento Google. Versão 9 ou superior
• minSdkVersion 21
• Maven Jitpack - Gerenciador de bibiotecas para a IDE.

Crie o seu projeto no Firebase

• A nossa SDK conta com soluções provenientes do MLKit da Google, se fazendo necessário criar adequadamento o projeto no Firebase Console seguindo todas as instruções para gerar o arquivo googleservices.json ao seu projeto no Android Studio.

Instalando

• Abra o arquivo build.gradle (Projeto) e adicione Jitpack manager em repositorios, seu código deve parecer com isto:

allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://jitpack.io'}
        }
}

• Adicione suporte ao AndroidX ao seu arquivo build.properties, se faz necessário para uma melhor performance e funcionamento do frame de captura:

android.useAndroidX=true
android.enableJetifier=true

Em caso de ERRO ao compilar por incompatibilidade da versão do frame min-26, adicione estas linhas em app/build.gradle

compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
}

• Em seguida, abra o arquivo build.gradle (Modulo) e implemente nossa dependência ao seu projeto:

 implementation 'com.github.acesso-io:camerabio-android:2.0.8'

Pronto! O seu projeto já está pronto para o uso de nossa ferramenta.

Manuseio

Importar, inicializar e receber os callbacks básicos é muito simples, siga os passos abaixo:

• Abra a sua Activity ou Fragment que deseja manusear nossa sdk e adicione as seguintes linhas:

import com.example.camerabio.CallbackBio;
import com.example.camerabio.RestBio;

public class MainActivity extends AppCompatActivity implements CallbackCameraBio {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
       CameraBioManager cb = new CameraBioManager(MainActivity.this);
       cb.startCamera();
       
    }

}

Pronto, importamos e inicializamos nossa solução... Estamos quase lá!

Note que implementamos o CallbackCameraBio, responsável pelos retornos de nossa sdk. Ele irá indicar que implemente os seguintes métodos:

 @Override
 public void onSuccessCapture(String base64) {
  // Aqui está o base64 da captura    
 }

@Override
public void onFailedCapture(String description) {
  // Algo deu errado
}

Tranquilo, certo? Falta apenas instanciar nossa classe RestBio e inicializar o serviço com sua instância e dados de acesso.

E Voila! Nossa solução está pronta para o uso!!!

Simples, não? xD

Outros métodos uteis

Voce pode também iniciar a camera voltada para capturas de Documentos, é bem simples:

  CameraBioManager cb = new CameraBioManager(MainActivity.this);
  cb.startCameraDocument(cb.RG_FRENTE);

Note que acima estamos inicalizando a abertura de câmera especificando o tipo de documento para máscara. Atualmente temos 3 tipos de documentos:

• cb.RG_FRENTE,
• cb.RG_VERSO,
• cb.CNH

Caso deseje apenas abrir a camera para capturar documento sem nenhuma mascara acima, escolha a opcao:

• cb.NONE

E o retorno:

 @Override
 public void onSuccessCaptureDocument(String base64) {
  // Aqui está o base64 da captura    
 }


@Override
public void onSuccessCaptureDocument(String base64) {

}

@Override
public void onFailedCaptureDocument(String description) {
  // Algo deu errado
}

Tamanho

A SDK em si possui 88.3KB, porém, faz uso de ferramentas do Firebase a qual não temos controle do tamanho - depende da versão - e pode ser verificado junto ao site oficial da mesma.

Construido com

• ML KIt Google - Framework de IA para o reconhecimento facial

Versionamento

Nós usamos Github para versionar. Para as versões disponíveis, veja as tags do repositório.

Autores

• Matheus Domingos - Engenheiro Mobile - GitHub

Veja também nossa lista de contribuidores que participaram deste projeto.

Licença

Este proje é licenciado pela MIT License - veja LICENSE.md o arquivo para detalhes