Os SDKs de Captura de Documentos permitem a realização de capturas pelo usuário dentro de sua aplicação. Essas capturas passam por validações que identificam o tipo de documento e que avaliam a qualidade da imagem capturada, instruindo o usuário através de feedbacks visuais.

Todas as informações coletadas são dados relacionados apenas ao dispositivo do usuário.

É necessário que o usuário conceda permissão de acesso à câmera do dispositivo para capturar e enviar seu documento.

Instalação do Package

• Gradle

Certifique-se que o seu gradle a nível de projeto settings.gradle possua os seguintes repositórios:

buildscript {
    ...    
    dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven {
            url  ARTIFACTS_FEED_URL // valor fornecido pela ClearSale
            name  ARTIFACTS_FEED_NAME // valor fornecido pela ClearSale
            credentials {
                username USERNAME // valor fornecido pela ClearSale
                password  ACCESSTOKEN // valor fornecido pela ClearSale
            }
            authentication {
                basic(BasicAuthentication)
            }
        }
    }
}
    ...
}

No arquivo build.gradle da sua aplicação, habilite a compatibilidade de origem Java 1.8.

android {
    ...
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    ...
}

Existem dois pacotes, um deve ser utilizado para testes e o outro no ambiente produtivo.

• 'sale.clear.studio:documentoscopy-sdk:2.0.0': deve ser utilizado apenas no ambiente produtivo.
'sale.clear.studio:documentoscopy-sdk:2.0.0-hml': deve ser utilizado apenas no ambiente de desenvolvimento.

Adicione no build.gradle do seu aplicativo a seguinte dependência:

Produção

dependencies {
    implementation 'sale.clear.studio:documentoscopy-sdk:2.0.0'
    ...
}

Desenvolvimento

dependencies {
    implementation 'sale.clear.studio:documentoscopy-sdk:2.0.0-hml'
    ...
}

Exemplos

Faça a importação da biblioteca em sua classe.

import com.clear.studio.csdocs.entries.CSDocumentoscopy
import com.clear.studio.csdocs.entries.CSDocumentoscopySDKError
import com.clear.studio.csdocs.entries.CSDocumentoscopySDKListener
import com.clear.studio.csdocs.entries.CSDocumentoscopySDKResult
import com.clear.studio.csdocs.entries.CSDocumentoscopySDK

Instancie o SDK passando os parâmetros pedidos, conforme exemplo abaixo.

CSDocumentoscopySDK.initialize(this, CSDocumentoscopy(mClientId.text.toString(), mClientSecret.text.toString(), cpf = mCpf.text.toString(), identifierId = mIdentifierId.text.toString()), object: CSDocumentoscopySDKListener{
                    override fun didOpen(){
                        Log.d("Documentoscopia", "SDK Foi Aberto")
                    }
                    override fun didTapClose(){
                        Log.d("Documentoscopia", "Usuário encerrou manualmente o fluxo")
                    }
                    override fun didReceiveError(error : CSDocumentoscopySDKError){
                        mSessionId.text = (error.text + "errorCode: " + error.errorCode.toString())
                    }
                    override fun didFinishCapture(result: CSDocumentoscopySDKResult){
                            mSessionId.text = ("Session Id: " + result.sessionId)
                            mCSDocumentoscopySDKDocumentTypeView.setText("CSDocumentoscopySDKDocumentType: " + result.documentType.toString())
                    }
                })