Skip to main content

Uso Básico

Após instalar e configurar o SDK, você pode iniciar a verificação de liveness com poucas linhas de código.

Exemplo Completo de Activity

package com.example.myapp

import android.os.Bundle
import android.widget.Button
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import androidx.lifecycle.lifecycleScope
import com.valid.entry.LivenessHubSDK
import com.valid.entry.models.LivenessHubRiskLevel
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        findViewById<Button>(R.id.btnStartLiveness).setOnClickListener {
            startLivenessVerification()
        }
    }

    private fun startLivenessVerification() {
        lifecycleScope.launch {
            try {
                // Start verification with medium risk level
                val result = LivenessHubSDK.startLivenessCheck(
                    activity = this@MainActivity,
                    riskLevel = LivenessHubRiskLevel.LIVENESS_RISK_MEDIUM
                )

                result.onSuccess {
                    Toast.makeText(
                        this@MainActivity,
                        "✅ Verification completed successfully!",
                        Toast.LENGTH_LONG
                    ).show()
                    onLivenessSuccess()

                }.onFailure { error ->
                    Toast.makeText(
                        this@MainActivity,
                        "❌ Error: ${error.message}",
                        Toast.LENGTH_LONG
                    ).show()
                    onLivenessFailure(error)
                }

            } catch (e: Exception) {
                Toast.makeText(
                    this@MainActivity,
                    "Unexpected error: ${e.message}",
                    Toast.LENGTH_LONG
                ).show()
            }
        }
    }

    private fun onLivenessSuccess() {
        // Navigate to next screen or continue flow
    }

    private fun onLivenessFailure(error: Throwable) {
        // Handle error or allow retry
    }
}

Níveis de Risco

O SDK oferece três níveis de segurança para a detecção de liveness:
enum class LivenessHubRiskLevel {
    LIVENESS_RISK_LOW,      // Para verificações simples
    LIVENESS_RISK_MEDIUM,   // Recomendado para a maioria dos casos
    LIVENESS_RISK_HIGH      // Para transações financeiras ou dados sensíveis
}
NívelUso RecomendadoComplexidade
LIVENESS_RISK_LOWVerificações simplesMais rápido, menos desafios
LIVENESS_RISK_MEDIUMMaioria dos casosEquilíbrio ideal
LIVENESS_RISK_HIGHTransações críticasMais desafios, maior segurança

API Pública

Resumo das Classes Principais

ClasseTipoDescrição
LivenessHubSDKobjectPonto de entrada principal do SDK
LivenessHubConfigdata classConfiguração do SDK
LivenessHubRiskLevelenumNíveis de risco para detecção

Referência Rápida

// Inicialização (na Application)
LivenessHubSDK.init(applicationContext: Context, config: LivenessHubConfig)

// Verificação de Liveness (na Activity)
suspend fun startLivenessCheck(
    activity: Activity,
    riskLevel: LivenessHubRiskLevel
): Result<Unit>

Próximos Passos