> 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/conexion-con-plataforma.md).

# Conexão com a plataforma

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

O envio de eventos para a plataforma é feito por meio do ***Tracking Component***.

Ele é responsável por rastrear e monitorar as informações obtidas durante a execução das operações. É possível acompanhar esses dados em tempo real na **Plataforma**, enquanto o processo está sendo executado no dispositivo do cliente.

Ao contrário dos outros componentes, este não funciona de forma independente: ele atua de maneira transversal aos demais componentes instalados no *SDKMobile*.

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 é:

```kts
implementation "com.facephi.androidsdk:tracking_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="239.2734375"></th><th></th></tr></thead><tbody><tr><td><strong>Controlador</strong></td><td><strong>Descrição</strong></td></tr><tr><td>TrackingController</td><td>Controlador principal de tracking</td></tr><tr><td>TrackingErrorController</td><td>Controlador para <strong>gerenciar</strong> os possíveis <strong>erros</strong> que ocorrerem</td></tr><tr><td>ExtraDataController</td><td>Controlador para obter o <strong>ExtraData</strong> que permite a <strong>comunicação</strong> do cliente com o servidor com o <strong>SelphIDSdk</strong> instalado.</td></tr></tbody></table>

***

## Lançamento simplificado <a href="#id-4-lanzamiento-simplificado" id="id-4-lanzamiento-simplificado"></a>

O controlador deve ser incluído durante a inicialização do SDK.

```kotlin
SDKController.initSdk(
    SdkConfigurationData(
        ...
        trackingController = TrackingController(),
    )
)
```

*TrackingController* aceita dois parâmetros opcionais: `retryCount: Int = 3` (número de tentativas) e `retryDelay: Long = 1000` (intervalo inicial entre tentativas).

### Tratamento de erros <a href="#id-41-control-de-errores" id="id-41-control-de-errores"></a>

É possível configurar o callback para tratar os erros de tracking:

```kotlin
SDKController.launch(
     TrackingErrorController {
        Napier.d("Tracking Error: ${it.name} - ${it.error} - ${it.stepType}")
     }
)
```

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

### Controladores adicionais <a href="#id-51-controladores-adicionales" id="id-51-controladores-adicionales"></a>

#### **ExtraDataController**

Este controlador (*ExtraDataController*) permite obter um identificador da operação atual. Esse dado será enviado ao backend, onde serão realizadas as verificações pertinentes.

A chamada para obter o extraData, **precisa das informações da operação em andamento,** o que **obriga** a que tenha sido **realizada** anteriormente uma ***newOperation***.

```kotlin
val result = SDKController.launch(
    ExtraDataController()
)
when (result) {
    is SdkResult.Success -> logs.add("ExtraData: OK")
    is SdkResult.Error -> logs.add(
        "ExtraData: KO - ${result.error.name}"
    )
}
```

Em caso de sucesso, `result.data` é um *TrackingResult* com um único campo `result` (String) que contém o ExtraData tokenizado. Os erros são retornados como *TrackingError*.

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

Na parte de erro, teremos a classe TrackingError. A classe retornará 3 campos:

* name: String com o nome do erro
* error: Informação adicional, caso seja necessária
* stepType: Componente do SDK no qual ocorreu uma falha no envio do evento

Lista de erros:

* **APPLICATION\_CONTEXT\_ERROR**: Erro na inicialização do contexto
* **ASSET\_LINK**: Erro ao enviar o link do recurso
* **ASSET\_UPLOAD**: Erro durante o upload do recurso
* **COMPONENT\_LICENSE\_ERROR**: Licença do componente ausente ou inválida
* **CUSTOMER\_ID**: Erro ao obter ou validar o ID do cliente
* **DEVICE\_EVENT\_ERROR**: Falha durante um evento relacionado ao dispositivo
* **EMPTY\_LICENSE**: Dados da licença vazios ou inexistentes
* **FLOW**: Erro durante o fluxo de execução
* **INITIALIZATION\_ERROR**: Falha geral na inicialização
* **INIT\_IDS\_ERROR**: Erro ao gerar ou atribuir IDs durante a inicialização
* **INIT\_OPERATION**: Operação malsucedida na fase de inicialização
* **LICENSE\_ERROR**: Licença inválida ou corrompida
* **MANAGER\_NOT\_INITIALIZED**: Tentativa de usar o gerenciador sem inicializá-lo
* **NETWORK\_CONNECTION**: Problema com a conexão de rede
* **NETWORK\_ERROR**: Falha genérica de rede
* **NO\_OPERATION\_CREATED\_ERROR**: Nenhuma operação foi criada quando isso era esperado
* **OCR\_DATA**: Erro ao processar os dados de OCR
* **OPERATION\_NOT\_CREATED**: A operação esperada não foi gerada
* **OPERATION\_ID**: ID de operação inválido ou ausente
* **SESSION\_ID**: Erro na identificação da sessão
* **SIGNATURE\_RESULT**: Falha no processo ou no resultado da assinatura
* **STEP\_CHANGE**: Transição de etapa inesperada ou inválida
* **STEP\_RESULT\_CANCELLED**: A etapa foi cancelada inesperadamente
* **STEP\_RESULT\_ERROR**: A etapa foi concluída com um erro
* **STEP\_RESULT\_EXPIRED**: O resultado da etapa expirou antes da conclusão
* **STEP\_RESULT\_SUCCEEDED**: A etapa foi concluída com sucesso, mas gerou um problema inesperado
* **TOKEN\_ERROR**: Token ausente, expirado ou inválido
* **ADVANCED\_TRACKING\_UPLOAD**: Falha ao enviar os dados de acompanhamento avançado
* **TENANT\_ID\_EMPTY\_ERROR**: O ID do tenant estava vazio ou ausente
* **ADVANCED\_TRACKING\_SERIALIZATION\_ERROR**: Erro ao serializar os dados de acompanhamento avançado
* **ADVANCED\_TRACKING\_VALIDATION\_ERROR**: Falha na validação dos dados de acompanhamento
* **TOKENIZER\_ERROR**: Erro durante o processo de tokenização
* **ID\_CAPTURE**: Erro no evento de Captura de Documento
* **FINGER\_CAPTURE**: Erro no evento de Captura de Impressão Digital
* **NFC\_CAPTURE**: Erro no evento de captura NFC
* **SELFIE\_CAPTURE**: Erro no evento de Captura Facial
* **VIDEO\_ID\_CAPTURE**: Erro no evento de captura de identificação por vídeo
* **COORDINATES**: Erro nas coordenadas
* **ADVANCED\_TRACKING\_ERROR**: Erro geral no Tracking avançado
* **ASSET\_URL\_UPLOAD**: Erro ao enviar o recurso por URL
* **ASSET\_NOT\_FOUND**: Recurso não encontrado
* **EVENT\_NOT\_FOUND**: Evento não encontrado
* **STEP\_NOT\_FOUND**: Etapa não encontrada
* **ENVIRONMENT\_ERROR**: Erro relacionado ao ambiente
* **FILE\_CAPTURE\_ERROR**: Erro no evento de captura de arquivos
* **TERMS\_AND\_CONDITIONS**: Erro no evento de termos e condições
