> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-mobile/android-sdk/componentes-modulos/terminos-y-condiciones.md).

# Termos e condições

## Introdução <a href="#id-1-introduccion" id="id-1-introduccion"></a>

A aceitação dos termos e condições de uso é feita com o ***Componente Terms Conditions***.

Este componente é responsável por capturar a resposta do usuário em relação aos termos e condições de uso. Seus principais processos são:

* Exibição de um visualizador de texto HTML.
* Captura da resposta do usuário.

Na seção [Lançamento simplificado](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-mobile/android-sdk/inicializacion/lanzamiento-simplificado.md) são detalhadas as etapas necessárias para a integração básica do SDK. Nesta seção, são acrescentadas as informações para o lançamento deste componente.

## Dependência <a href="#id-2-dependencia" id="id-2-dependencia"></a>

A dependência específica do componente é:

```
implementation "com.facephi.androidsdk:terms_conditions_component:$version"
```

## Controladores disponíveis <a href="#id-3-controladores-disponibles" id="id-3-controladores-disponibles"></a>

<table data-header-hidden><thead><tr><th width="193.87109375"></th><th></th></tr></thead><tbody><tr><td><strong>Controlador</strong></td><td><strong>Descrição</strong></td></tr><tr><td>TermsConditionsController</td><td>Controlador principal para capturar a aceitação dos termos</td></tr></tbody></table>

## Lançamento simplificado

Depois que o SDK for iniciado e uma nova operação for criada, será possível iniciar o componente. Você poderá usar qualquer um de seus controladores para executar sua funcionalidade.

Lançamento da captura:

```kotlin
val response = SDKController.launch(
    TermsConditionsController(TermsConditionsConfigurationData(...))
)
when (response) {
    is SdkResult.Error -> Napier.d("ERROR - ${response.error.name}")
    is SdkResult.Success -> response.data
}
```

## Configuração básica <a href="#id-5-configuracion-basica" id="id-5-configuracion-basica"></a>

Para iniciar o componente atual, deve-se criar um objeto *TermsConditionsConfigurationData* que será a configuração do controlador do componente.

A configuração básica necessária é a seguinte:

```kotlin
TermsConditionsConfigurationData(
  termsConditions = "...html..."
)
```

## Recebimento do resultado <a href="#id-6-recepcion-del-resultado" id="id-6-recepcion-del-resultado"></a>

O lançamento retornará as informações no formato SdkResult, permitindo diferenciar entre um lançamento bem-sucedido e um malsucedido:

```
when (response) {
    is SdkResult.Error -> Napier.d("ERROR - ${response.error}")
    is SdkResult.Success -> Napier.d("Accepted")
}
```

### Recebimento de erros <a href="#id-61-recepcion-de-errores" id="id-61-recepcion-de-errores"></a>

Os erros serão retornados como um objeto 'TermsConditionsError'. Cada erro expõe os campos `name`, `reason` e `code` (alguns também incluem um campo `error` com informações adicionais).

Lista de erros (nome e código):

* `CANCEL_BY_USER` (`TER_000`): O usuário cancelou o processo
* `TIMEOUT` (`TER_001`): Timeout no processo
* `COMPONENT_LICENSE_ERROR` (`TER_002`): A licença do componente está incorreta
* `EMPTY_LICENSE` (`TER_003`): A string da licença está vazia
* `INITIALIZATION_ERROR` (`TER_004`): Erro de Inicialização
* `NO_DATA_ERROR` (`TER_005`): Os dados de entrada são nulos
* `OPERATION_NOT_CREATED` (`TER_006`): Não há nenhuma operação em andamento
* `CANCEL_LAUNCH` (`TER_007`): Foi feito um cancelamento geral do SDK
* `ACTIVITY_RESULT_MSG_ERROR` (`TER_650`): O resultado da atividade está incorreto
* `APPLICATION_CONTEXT_ERROR` (`TER_651`): O contexto de aplicativo necessário é nulo
* `FETCH_DATA_ERROR` (`TER_652`): Erro ao coletar o resultado
* `MANAGER_NOT_INITIALIZED` (`TER_653`): Os managers são nulos
* `FLOW_VIDEO_RECORDING_ERROR` (`TER_654`): Erro na gravação de vídeo do flow
* `FLOW_TRACKING_ERROR` (`TER_655`): Erro no tracking do flow
* `TRACKING_STEP_ERROR` (`TER_656`): Erro na etapa de tracking
* `INTERNAL_ERROR` (`TER_657`): Erro interno
* `USER_REJECTED_TERMS_AND_CONDITIONS` (`TER_658`): O usuário rejeitou os termos e condições
* `FLOW_ERROR` (`TER_659`): Erro no processo do flow

### Recebimento do resultado correto - *data* <a href="#id-62-recepcion-del-resultado-correcto-data" id="id-62-recepcion-del-resultado-correcto-data"></a>

O usuário terá aceitado as condições se for recebido SdkResult.Success. O dado retornado é um objeto *TermsConditionsResult* sem campos.

***

## Informações avançadas <a href="#id-7-informacion-avanzada" id="id-7-informacion-avanzada"></a>

Esta seção complementa as informações do componente.

### Configuração avançada do componente <a href="#id-71-configuracion-avanzada-del-componente" id="id-71-configuracion-avanzada-del-componente"></a>

Para iniciar o componente atual, deve-se criar um objeto *TermsConditionsConfigurationData* que será a configuração do controlador do componente.

A seguir, são detalhados todos os campos que fazem parte desta classe.

* `termsConditions`: Texto dos termos e condições de uso que será exibido ao usuário
* `extractionTimeout`: Define o tempo máximo (em milissegundos) durante o qual a captura pode ser realizada. Valor padrão: 60000.

***

## Personalização do componente <a href="#id-8-personalizacion-del-componente" id="id-8-personalizacion-del-componente"></a>

Além das alterações que podem ser feitas no nível do SDK (explicadas no documento de [Personalização do SDK](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-mobile/android-sdk/personalizacion.md)), este componente permite especificamente modificar sua interface.

### Textos <a href="#id-81-textos" id="id-81-textos"></a>

Se desejar modificar os textos do SDK, inclua o seguinte arquivo XML no aplicativo do cliente e altere o valor de cada *String* pelo desejado.

| **Nome**                                   | **Valor**                                                          |
| ------------------------------------------ | ------------------------------------------------------------------ |
| disclaimer\_widget\_agree\_button          | Aceitar                                                            |
| disclaimer\_widget\_decline\_button        | Recusar                                                            |
| disclaimer\_widget\_cancel\_alert\_title   | Recusar o RGPD                                                     |
| disclaimer\_widget\_cancel\_alert\_desc    | Recusar o RGPD encerrará a sessão atual. Deseja encerrar a sessão? |
| disclaimer\_widget\_cancel\_alert\_accept  | Sair                                                               |
| disclaimer\_widget\_cancel\_alert\_dismiss | Cancelar                                                           |
