# Guia Rápido de Uso

> Integre de forma rápida e funcional, com uma solução pensada para desenvolvedores que valorizam agilidade e eficiência.

***

## ⚙️ **Instalação**

Aponte o repositório no seu `settings.gradle`:

```groovy
dependencyResolutionManagement {
    maven { url "https://raw.githubusercontent.com/oititec/android-certiface-sdk-versions/main" }
}
```

Adicione a dependência ao seu `build.gradle`:

```groovy
dependencies {
    implementation "br.com.certiface:certifacesdk:X.Y.Z"
}
```

🔄 Substitua `X.Y.Z` pela versão atual.

***

## 🚀 **Inicialização**

```kotlin
CertifaceSDK.initialize(
    context = applicationContext,
    config = SDKConfig(
        environment = Environment.HML,
        appKey = "SUA_APP_KEY"
    )
)
```

***

## 🔌 **Criação do Gerenciador**

### IProov

```kotlin
val livenessManager = CertifaceSDK.createLivenessManager(
    provider = CertifaceSDK.LivenessProvider.IPROOV
)
```

### Facetec

```kotlin
val livenessManager = CertifaceSDK.createLivenessManager(
    provider = CertifaceSDK.LivenessProvider.FACETEC
)
```

***

## 🎨 **Customização Visual**

### IProov

```kotlin
val theme = IProovTheme.build {
    setTitle("Autenticação Facial")
    setSurroundColor("#00FF00")
}
```

### Facetec

```kotlin
val theme = FacetecTheme.build {
    resultScreenForegroundColor("#0F9D58")
    resultScreenBackgroundColors("#DFFFD6")
}
```

***

## 🧪 **Executando o Liveness**

### IProov

```kotlin
val options = IProovManagerOptions(appkey = appKey, theme = theme)

livenessManager.start(options, object : CertifaceResultCallback<LivenessResult> {
    override fun onSuccess(result: LivenessResponse) {
        Toast.makeText(context, "Sucesso!", Toast.LENGTH_SHORT).show()
    }

    override fun onError(result: LivenessResponse) {
        Toast.makeText(context, "Erro!", Toast.LENGTH_SHORT).show()
    }
})
```

### Facetec

```kotlin
val options = FacetecManagerOptions(appkey = appKey, theme = theme)

livenessManager.start(options, object : CertifaceResultCallback<LivenessResult> {
    override fun onSuccess(result: LivenessResponse) {
        Toast.makeText(context, "Sucesso!", Toast.LENGTH_SHORT).show()
    }

    override fun onError(result: LivenessResponse) {
        Toast.makeText(context, "Erro!", Toast.LENGTH_SHORT).show()
    }
})
```

***

## 🧪 **Ambiente de Testes**

Use `Environment.HML` com AppKey de homologação.

***

## 📋 **Checklist**

✔️ SDK mínimo: 26
✔️ AndroidX + Jetpack Compose
✔️ Kotlin
✔️ Ambiente: `HML` ou `PRD`