> 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/captura-de-documentos.md).

# Captura de documentos - SelphID

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

A captura de documentos é realizada por meio do **SelphID Component**.

Esse componente é responsável por capturar documentos de identidade e analisar as informações obtidas. Durante o processo, são realizadas, entre outras, as seguintes etapas:

* Gerenciamento interno de câmeras e permissões.
* Assistência guiada durante a captura da **frente e do verso** do documento.
* Extração das informações contidas no documento.
* Obtenção de imagens do documento e de elementos associados:
  * Rosto do usuário.
  * Assinatura do usuário.
* Alto nível de configuração:
  * Países.
  * Idiomas.
  * Tipos de documento.

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 descritas as etapas básicas para a integração do SDK.\
Esta página detalha as informações específicas necessárias para iniciar e configurar esse componente.

***

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

A dependência específica do componente é:

```kotlin
implementation "com.facephi.androidsdk:selphid_component:$version"
```

***

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

| **Controlador**   | **Descrição**                                         |
| ----------------- | ----------------------------------------------------- |
| SelphIDController | Controlador principal de reconhecimento de documentos |

***

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

Depois que o SDK é iniciado e uma nova operação é criada, o componente pode ser iniciado usando seu controlador.

Inicialização da captura de documentos:

```kotlin
val response = SDKController.launch(
    SelphIDController(SelphIDConfigurationData(..))
)
when (response) {
    is SdkResult.Error -> Napier.d("SelphID: 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, é necessário criar um objeto **SelphIDConfigurationData**, que define o comportamento do widget.

Na configuração básica:

* É obrigatório definir o **país** e o **tipo de documento**.
* No campo `specificData` deve ser indicado o código do país correspondente (por exemplo, `ES` para a Espanha).

```kotlin
SelphIDConfigurationData(
  resourcesPath = "resources_file.zip",
  wizardMode = true,
  specificData = "ES|<ALL>",
  documentType = SelphIDDocumentType.ID_CARD,
)
```

**Tipos de documento disponíveis**

```
SelphIDDocumentType.ID_CARD
SelphIDDocumentType.PASSPORT
SelphIDDocumentType.DRIVERS_LICENSE
SelphIDDocumentType.FOREIGN_CARD
SelphIDDocumentType.CREDIT_CARD
SelphIDDocumentType.CUSTOM
SelphIDDocumentType.VISA
```

***

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

O resultado do início é retornado como um objeto **SdkResult**, que pode indicar sucesso ou erro.

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

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

Os erros são retornados como um objeto **SelphIDError**, que inclui as propriedades `name`, `reason` e `code`. A lista a seguir mostra o nome (`name`) e o código (`code`) de cada erro.

**Lista de erros**

* `ACTIVITY_RESULT_ERROR` (`SPD_312`): O resultado da atividade está incorreto.
* `ACTIVITY_RESULT_MSG_ERROR` (`SPD_313`): O resultado da atividade recebido na mensagem está incorreto.
* `APPLICATION_CONTEXT_ERROR` (`SPD_314`): O contexto de aplicação necessário é nulo.
* `BAD_CONFIGURATION_ERROR` (`SPD_310`): A configuração fornecida está incorreta.
* `BAD_EXTRACTOR_CONFIGURATION_ERROR` (`SPD_300`): Widget: Configuração do extrator incorreta
* `CAMERA_PERMISSION_DENIED` (`SPD_301`): O usuário recusou as permissões.
* `CANCEL_BY_USER` (`SPD_000`): O usuário cancelou o processo.
* `CANCEL_LAUNCH` (`SPD_007`): O SDK foi cancelado de forma geral.
* `COMPONENT_LICENSE_ERROR` (`SPD_002`): A licença do componente está incorreta.
* `CONSUMED_BY_LICENSE_ERROR` (`SPD_302`): Erro relacionado ao consumo da licença.
* `CONTROL_NOT_INITIALIZED_ERROR` (`SPD_303`): Widget: Erro de inicialização
* `EMPTY_LICENSE` (`SPD_003`): A string da licença está vazia.
* `EXTRACTION_LICENSE_ERROR` (`SPD_304`): Widget: Erro de licença
* `FETCH_DATA_ERROR` (`SPD_315`): Erro ao coletar o resultado.
* `FLOW_ERROR` (`SPD_337`): Erro no processo do flow.
* `FLOW_TRACKING_ERROR` (`SPD_331`): Erro no tracking do flow.
* `FLOW_VIDEO_RECORDING_ERROR` (`SPD_329`): Erro na gravação de vídeo do flow.
* `HARDWARE_ERROR` (`SPD_305`): Widget: erro de hardware
* `INITIALIZATION_ERROR` (`SPD_004`): Erro de Inicialização.
* `INTERNAL_ERROR` (`SPD_328`): Erro interno.
* `MANAGER_NOT_INITIALIZED` (`SPD_316`): Os managers são nulos.
* `NO_DATA_ERROR` (`SPD_005`): Os dados de entrada são nulos.
* `OPERATION_NOT_CREATED` (`SPD_006`): Não há nenhuma operação em andamento.
* `RESOURCES_FILE_NOT_FOUND` (`SPD_306`): O zip de recursos não foi encontrado
* `SETTINGS_PERMISSION_ERROR` (`SPD_307`): Widget: erro de permissões
* `SELPHID_TIMEOUT` (`SPD_001`): Timeout no processo. Inclui informações adicionais da captura (consulte [Erro de Timeout](#error-de-timeout-selphid_timeout)).
* `TRACKING_STEP_ERROR` (`SPD_330`): Erro no tracking da etapa.
* `UNEXPECTED_CAPTURE_ERROR` (`SPD_308`): Widget: erro na captura
* `UNKNOWN_ERROR` (`SPD_309`): Erro desconhecido
* `WIDGET_RESULT_DATA_ERROR` (`SPD_311`): Erro nos dados de saída do Widget

#### Erro de timeout (`SELPHID_TIMEOUT`)

Quando a captura termina por timeout, o erro `SelphIDError.SELPHID_TIMEOUT` inclui, além de `name`, `reason` e `code`, os seguintes campos:

* `error`: Diagnóstico do timeout (texto). Veja abaixo.
* `captureProgress`: Estado em que o processo de captura se encontrava. Veja abaixo.
* `rawDocumentFrontImage`: Imagem completa da câmera (`SdkImage`) da frente do documento, se disponível.
* `rawDocumentBackImage`: Imagem completa da câmera (`SdkImage`) do verso do documento, se disponível.
* `logs`: Logs gerados pelo extrator durante a captura.

**captureProgress**

Esta propriedade retorna o estado em que o processo de captura se encontrava quando o tempo de espera se esgotou. Estes são os possíveis valores:

```
Front_Detection_None = 0
Front_Detection_Uncertain = 1
Front_Detection_Completed = 2
Front_Document_Analyzed = 3
Back_Detection_None = 4
Back_Detection_Uncertain = 5
Back_Detection_Completed = 6
Back_Document_Analyzed = 7
```

* **0**: Na leitura da frente, o widget terminou sem conseguir detectar nada. Geralmente, isso ocorre quando nenhum documento é apresentado.
* **1**: Na leitura da frente, o widget terminou tendo detectado parcialmente um documento. Nesse caso, alguns dos elementos esperados foram detectados, mas não todos os necessários.
* **2**: Na leitura da frente, o widget terminou tendo concluído a detecção de todos os elementos do documento. Se o widget terminar nesse estado, é porque a análise de OCR não pôde ser concluída com sucesso.
* **3**: Na leitura da frente, o widget terminou tendo analisado e extraído todo o OCR do documento. Este é o estado final de uma leitura correta da frente de um documento.

Os estados de **4** a **7** são exatamente iguais, mas se referem ao resultado do processo ao analisar o verso.

**error**

Este campo retorna uma cadeia de texto que explica por que o tempo de espera do Widget se esgotou. Essa cadeia pode ser usada em uma tela de timeout posterior, na qual o aplicativo principal pode fornecer mais informações ao usuário sobre o que aconteceu durante a captura do documento.

Os possíveis valores são os textos definidos no arquivo zip de recursos do componente (`resourcesPath`), identificados pelos seguintes tokens:

| **Token**                          | **Valor**                                                                                                                                                 |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `timeout_no_front_document`        | A frente do documento não foi detectada. Certifique-se de colocar o documento dentro da moldura de captura                                                |
| `timeout_uncertain_front_document` | Parece que a frente do documento não é a esperada ou que há reflexos ou sombras que dificultam sua classificação                                          |
| `timeout_unclear_front_document`   | Não foi possível ler a frente do documento com sucesso. Certifique-se de que a imagem está nítida e que os dados do documento podem ser lidos com clareza |
| `timeout_no_back_document`         | O verso do documento não foi detectado. Certifique-se de colocar o documento dentro da moldura de captura                                                 |
| `timeout_uncertain_back_document`  | Parece que o verso do documento não é o esperado ou que há reflexos ou sombras que dificultam sua classificação                                           |
| `timeout_unclear_back_document`    | Não foi possível ler o verso do documento com sucesso. Certifique-se de que a imagem está nítida e que os dados do documento podem ser lidos com clareza  |
| `timeout_no_user_activity`         | O tempo máximo de espera foi excedido                                                                                                                     |

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

Quando o resultado é bem-sucedido (`SdkResult.Success`), é obtido um objeto **SelphIDResult**.

As imagens são retornadas no formato **SdkImage**.\
É possível acessar o bitmap por meio de `image.bitmap`.

Para converter uma imagem para Base64:

```kotlin
Base64.encodeToString(this.toByteArray(), Base64.NO_WRAP)
```

**Campos retornados**

**frontDocumentImage / tokenFrontDocument:**

A imagem frontal do documento processada, limpa e recortada nas bordas, e seu token correspondente.

**backDocumentImage / tokenBackDocument**

A imagem do verso do documento processada, limpa e recortada nas bordas, e seu token associado.

**faceImage / tokenFaceImage**

A imagem do rosto encontrado no documento, caso exista, e seu token associado.

Válida para o processo de MATCHING FACIAL.

**signatureImage / fingerprintImage**

Imagem da assinatura e da Impressão Digital encontradas no documento, caso existam.

**rawFrontDocumentImage / rawBackDocumentImage / tokenRawFrontDocument / tokenRawBackDocument**

Imagem completa da câmera e seu Token correspondente (consulte `generateRawImages`).

**tokenOCR**

Token associado aos dados de OCR extraídos.

**statistics**

String com informações estatísticas do processo de captura.

**logs**

String com os registros (logs) gerados pelo extrator durante o processo de captura.

**documentCaptured**

Esta propriedade indica o modelo de documento capturado quando é realizada uma busca no modo SMSearch. Dessa forma, o aplicativo pode saber qual modelo, entre todos os permitidos, foi detectado.

**matchingSidesScore**

Esta propriedade retorna um cálculo da similaridade dos dados lidos entre a frente e o verso do documento. O cálculo é realizado verificando a similaridade entre os campos comuns lidos em ambos os lados. O resultado do cálculo será um valor entre 0.0 e 1.0 caso existam campos comuns no documento. Quanto maior o valor, mais semelhantes são os dados comparados. Se o cálculo retornar -1.0, significa que o documento não contém campos comuns ou que ainda não há informações dos dois lados.

**ocrResults**

Este dicionário contém todos os dados detectados no documento. As chaves de cada campo são codificadas de forma que a própria chave contém informações sobre a origem do valor. Assim, por exemplo, a chave `Front/MRZ/DocumentNumber` indica o valor de DocumentNumber lido na frente do documento e na região do MRZ. Essas chaves dependem do documento capturado e, portanto, serão diferentes entre países e modelos de documento. O dicionário também contém chaves com nomes mais genéricos, que não incluem informações sobre a localização. Essas chaves contêm o dado mais completo dentre todos os lidos para esse campo.

Estas são as chaves:

* **FirstName**: O valor associado a esta chave contém o nome do usuário.
* **LastName**: O valor associado a esta chave contém os sobrenomes do usuário.
* **DateOfBirth**: O valor associado a esta chave contém a data de nascimento identificada no documento.
* **Gender**: O valor associado a esta chave contém o sexo do usuário identificado no documento.
* **Nationality**: O valor associado a esta chave contém a nacionalidade do usuário identificada no documento.
* **DocumentNumber**: O valor associado a esta chave contém o número do documento.
* **DateOfExpiry**: O valor associado a esta chave contém a data de validade do documento.
* **Issuer**: O valor associado a esta chave contém o emissor do documento.
* **DateofIssue**: O valor associado a esta chave contém a data de emissão do documento.
* **PlaceOfBirth**: O valor associado a esta chave contém o local de nascimento do usuário.
* **Address**: O valor associado a esta chave contém o endereço identificado no documento.

Além disso, são adicionadas chaves do próprio objeto results para facilitar a busca:

* **DocumentCaptured**: Valor do modelo de documento que foi capturado de acordo com o .xml de modelos. Corresponde à propriedade documentCaptured.
* **MatchingSidesScore**: Valor que indica a correspondência entre os lados lidos do documento. Corresponde à propriedade matchingSidesScore.

**countryCaptured**

País do documento.

**documentTypeCaptured**

Tipo de documento (`SelphIDDocumentType`).

**personalData**

Conjunto reduzido de dados obtidos do usuário:

* issuer
* documentNumber
* issueDate
* expiryDate
* name
* surname
* fullName
* gender
* birthDate
* birthPlace
* nationality
* address
* nfcKey
* numSupport
* MRZ

**encodedDataImages**

Lista de objetos `SelphIDEncodedDataImage` (`image`: SdkImage, `format`: String, `side`: SelphIDDocumentSide?) obtidos do modo de extração de códigos de barras (versão mbsdr com `encodedDataFocusEnabled` ativo). Por padrão, é uma lista vazia.

**tokenEncodedDataImages**

Lista de objetos `SelphIDEncodedDataToken` (`token`: String, `format`: String, `side`: SelphIDDocumentSide?) com as imagens tokenizadas obtidas do modo de extração de códigos de barras (versão mbsdr com `encodedDataFocusEnabled` ativo). Por padrão, é uma lista vazia.

***

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

### Seletor de documentos - OPCIONAL

**showDocumentSelector**

Ativação da tela do seletor de documentos. Ela será exibida assim que o controlador for iniciado. Por padrão: `false`.

**enabledCountries**

Lista de países em ISO2 que aparecerão no seletor. Se o valor for nulo ou não contiver valores válidos, todos os disponíveis pelo SDK serão exibidos.

**enabledDocumentTypes**

Lista de tipos de documentos que aparecerão no seletor de tipos de documentos. Se o valor for nulo ou não contiver valores, todos os disponíveis pelo SDK serão exibidos.

#### Configuração avançada do componente

O comportamento do componente é definido por meio de **SelphIDConfigurationData**.

**resourcesPath**

Indica o nome dos recursos do componente no formato ZIP. Exemplo: “resources-selphid-2-0.zip“.

Esse nome será usado para procurar o arquivo no caminho de *assets*.

<div align="left"><figure><img src="https://427654043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-15ce71837bf3d4cff1f1509e00d49ef3c005ef31%2Fassets.png?alt=media" alt=""><figcaption></figcaption></figure></div>

**wizardMode**

Indica se o widget fica configurado para capturar os dois lados do documento (frente e verso), um após o outro. Nesse modo, o widget é iniciado apenas uma vez e, ao terminar de capturar a frente, continua em seguida com o verso.

**showResultAfterCapture**

Indica se deve ser exibida uma tela com a imagem capturada do documento após o processo de análise. Nessa tela, o usuário tem a possibilidade de repetir o processo de captura caso a imagem obtida do documento não esteja correta.

**showTutorial**

Indica se o widget ativa a tela de tutorial. Nessa tela, é explicado de forma intuitiva como realizar a captura. Por padrão: `true`.

**tutorialOnly**

Indica se o widget deve ser iniciado apenas para exibir o tutorial. Por padrão: `false`.

**scanMode**

Indica o modo de digitalização OCR dos documentos. Dependendo da opção escolhida, serão digitalizados e pesquisados vários tipos de documentos ou um tipo específico. Há três modos disponíveis:

* **SelphIDScanMode.MODE\_GENERIC**: O modo genérico permite escanear qualquer tipo de documento, independentemente do país ou do tipo de documento. O resultado desse modo não é tão preciso quanto o dos modos a seguir, mas permite escanear vários documentos padrão.
* **SelphIDScanMode.MODE\_SEARCH**: O modo de busca permite usar uma whitelist e uma blacklist e procura documentos que atendam a essas condições. Essas condições são definidas na variável "specificData". Assim, é possível restringir a busca a um número menor de modelos, tornando-a muito mais precisa do que no modo genérico.
* **SelphIDScanMode.MODE\_SPECIFIC**: Busca de um documento específico. Essas condições são definidas na propriedade "specificData", apresentada a seguir.

**specificData**

Esta propriedade permite definir quais documentos serão escaneados durante o processo, caso o modo de escaneamento (scanMode) seja definido como **MODE\_SEARCH** ou **MODE\_SPECIFIC**.

Um exemplo de configuração que permite escanear todos os documentos de nacionalidade espanhola seria:

```
val selphIDConfiguration = SelphIDConfigurationData(
    scanMode = SelphIDScanMode.MODE_SEARCH,
    specificData = "ES|<ALL>",  // Código ISO da Espanha (ES)
)
```

**fullscreen**

Indica se a visualização terá prioridade para ser exibida em tela cheia, se o sistema permitir.

**tokenImageQuality**

Indica o nível de qualidade desejado para as imagens tokenizadas. Valor entre 0 e 1.

**documentType**

Os valores permitidos são os seguintes:

* **SelphIDDocumentType.ID\_CARD**: O widget fica configurado para capturar documentos de identidade.
* **SelphIDDocumentType.PASSPORT**: O widget fica configurado para capturar passaportes.
* **SelphIDDocumentType.DRIVERS\_LICENSE**: O widget fica configurado para capturar carteiras de habilitação.
* **SelphIDDocumentType.FOREIGN\_CARD**: O widget fica configurado para capturar documentos de estrangeiros.
* **SelphIDDocumentType.CUSTOM**: O widget fica configurado para capturar outros tipos de documentos que não se enquadram em nenhuma das categorias anteriores.
* **SelphIDDocumentType.CREDIT\_CARD**: O widget fica configurado para capturar cartões de crédito.
* **SelphIDDocumentType.VISA**: O widget fica configurado para capturar o visto de um país. (SDK min 2.1.2)

**documentSide**

Os valores permitidos são os seguintes:

* **SelphIDDocumentSide.FRONT**: O widget fica configurado para capturar a parte da frente do documento.
* **SelphIDDocumentSide.BACK**: O widget fica configurado para capturar a parte de trás do documento.

**timeout**

É um enum que define o timeout da captura de um lado do documento. Há 4 valores possíveis:

* SelphIDTimeout.SHORT: 15 segundos.
* SelphIDTimeout.MEDIUM: 20 segundos.
* SelphIDTimeout.LONG: 25 segundos.
* SelphIDTimeout.VERY\_LONG: 60 segundos.

**videoFilename**

Define o caminho absoluto do nome do arquivo no qual será gravado um vídeo do processo de captura. O aplicativo é responsável por solicitar ao telefone as permissões necessárias caso esse caminho exija permissões adicionais. Por padrão, o Widget não realizará nenhuma gravação, a menos que um caminho de arquivo seja especificado por meio deste método.

**documentModels**

Esta propriedade permite configurar, por meio de uma string no formato XML, a modelagem dos documentos que o widget tentará capturar. Por padrão, a definição dessa modelagem está em um arquivo .xml de modelos localizado no .zip de recursos. Com esta propriedade, um aplicativo pode atualizar as modelagens dos documentos em tempo de execução.

Observação: esta propriedade não altera o conteúdo do arquivo de recursos.

**generateRawImages**

Esta propriedade configura o widget para retornar a imagem completa da câmera usada para capturar o documento. Essas imagens são retornadas nas propriedades `rawFrontDocumentImage` e `rawBackDocumentImage` do objeto `SelphIDResult` respectivamente.

**tokenPreviousCaptureData**

Quando a captura do documento é realizada em duas chamadas, esta propriedade permite passar um dicionário com as informações da captura anterior. Dessa forma, o widget pode combinar de maneira inteligente os resultados das duas leituras e retornar as informações combinadas das duas capturas. Também permite ao widget calcular um grau de similaridade entre os dados das duas faces.

Se a captura das duas faces do documento for realizada em uma única chamada, isso não é necessário, pois o widget realiza esse processo internamente.

**translationsContent**

Esta propriedade avançada permite configurar, por meio de uma string no formato XML, a tradução dos textos exibidos durante o processo.

Observação: esta propriedade não altera o conteúdo do arquivo de recursos.

**viewsContent**

Esta propriedade avançada permite configurar as visualizações do Widget por meio de uma cadeia no formato XML.

Observação: esta propriedade não altera o conteúdo do arquivo de recursos.

**showDiagnostic**

Exibe telas de diagnóstico ao final do processo. Por padrão: `true`.

**showPreviousTip**

Exibe uma tela antes de iniciar a captura, com informações sobre o processo a ser realizado e um botão para iniciá-lo. Por padrão: `true`.

**vibrationEnabled**

Indica se deve haver uma resposta tátil por vibração ao final do processo. Por padrão: `false`.

**cameraId**

Identificador (`Int`) da câmera que se deseja usar.

**params**

Mapa (`HashMap<String, String>`) de parâmetros avançados adicionais que são passados diretamente ao widget.

**encodedDataFocusEnabled**

**Ativa o modo da etapa de extração de códigos de barras (versão mbsdr)**

***

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

Além da [Personalização do SDK](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-mobile/android-sdk/personalizacion.md) este componente permite modificar sua interface.

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

Os textos podem ser personalizados substituindo os valores em um arquivo XML de strings incluído no aplicativo cliente.

Exemplos de chaves disponíveis:

#### Diagnóstico

| Nome                                     | Valor                                                                                   |
| ---------------------------------------- | --------------------------------------------------------------------------------------- |
| `selphid_component_timeout_title`        | Tempo esgotado                                                                          |
| `selphid_component_timeout_desc`         | Verifique se o documento está dentro da moldura e se os dados estão visíveis.           |
| `selphid_component_timeout_front_desc`   | Verifique se a frente do documento está dentro da moldura e se os dados estão visíveis. |
| `selphid_component_timeout_back_desc`    | Verifique se o verso do documento está dentro da moldura e se os dados estão visíveis.  |
| `selphid_component_internal_error_title` | Ocorreu um problema técnico                                                             |
| `selphid_component_internal_error_desc`  | Pedimos desculpas. Não foi possível fazer a captura                                     |

#### Dica prévia

| Nome                                      | Valor                                                                             |
| ----------------------------------------- | --------------------------------------------------------------------------------- |
| `selphid_component_tip_message`           | Enquadre seu documento dentro da moldura. A foto será tirada automaticamente.     |
| `selphid_component_tip_message_alt`       | Enquadre seu documento dentro da moldura. A foto será tirada automaticamente.     |
| `selphid_component_tip_anim_id_alt`       | Coloque seu Documento de identidade na horizontal e aponte o celular na vertical. |
| `selphid_component_tip_anim_passport_alt` | Coloque seu Passaporte na horizontal e aponte o celular na vertical.              |
| `selphid_component_tip_anim_driving_alt`  | Coloque sua Licença para dirigir na horizontal e aponte o celular na vertical.    |
| `selphid_component_tip_title`             | Foto do documento                                                                 |
| `selphid_component_tip_button`            | COMEÇAR                                                                           |
| `selphid_component_tip_button_alt`        | Iniciar captura de documento                                                      |
| `selphid_component_tip_close_button_alt`  | VOLTAR                                                                            |
| `selphid_component_tip_info_button_alt`   | Ver dicas                                                                         |

#### Tutorial

| Nome                                            | Valor                                                                             |
| ----------------------------------------------- | --------------------------------------------------------------------------------- |
| `selphid_component_tutorial_message_1`          | Procure um fundo com bom contraste.                                               |
| `selphid_component_tutorial_message_2`          | Coloque o documento dentro da moldura.                                            |
| `selphid_component_tutorial_message_3`          | Evite reflexos que dificultem a leitura do documento.                             |
| `selphid_component_tutorial_1_anim_id_alt`      | Coloque o documento sobre uma superfície de cor diferente da do documento.        |
| `selphid_component_tutorial_2_anim_id_alt`      | Coloque seu Documento de identidade na horizontal e aponte o celular na vertical. |
| `selphid_component_tutorial_3_anim_id_alt`      | Há reflexos sobre o documento.                                                    |
| `selphid_component_tutorial_1_anim_pass_alt`    | Coloque o passaporte sobre uma superfície de cor diferente da do documento.       |
| `selphid_component_tutorial_2_anim_pass_alt`    | Coloque seu Passaporte na horizontal e aponte o celular na vertical.              |
| `selphid_component_tutorial_3_anim_pass_alt`    | Há reflexos sobre o documento.                                                    |
| `selphid_component_tutorial_1_anim_driving_alt` | Coloque o documento sobre uma superfície de cor diferente da do documento.        |
| `selphid_component_tutorial_2_anim_driving_alt` | Coloque seu Documento de identidade na horizontal e aponte o celular na vertical. |
| `selphid_component_tutorial_3_anim_driving_alt` | Há reflexos sobre o documento.                                                    |
| `selphid_component_tip_health_alt`              | Coloque seu cartão de saúde na horizontal e aponte o celular na vertical.         |
| `selphid_component_tutorial_1_anim_health_alt`  | Coloque o cartão de saúde sobre uma superfície de cor diferente da do documento.  |
| `selphid_component_tutorial_2_anim_health_alt`  | Coloque seu Documento de identidade na horizontal e aponte o celular na vertical. |
| `selphid_component_tutorial_3_anim_health_alt`  | Há reflexos sobre o documento.                                                    |
| `selphid_component_tip_custom_alt`              | --                                                                                |
| `selphid_component_tutorial_1_anim_custom_alt`  | --                                                                                |
| `selphid_component_tutorial_2_anim_custom_alt`  | --                                                                                |
| `selphid_component_tutorial_3_anim_custom_alt`  | --                                                                                |
| `selphid_component_tutorial_close_button_alt`   | Voltar ao tutorial anterior                                                       |

#### Seletor de Documento e País

| Nome                                          | Valor                        |
| --------------------------------------------- | ---------------------------- |
| `selphid_selector_title`                      | Faça seu Onboarding          |
| `selphid_selector_country_label`              | De que país é seu documento? |
| `selphid_selector_country_placeholder`        | Selecione um país            |
| `selphid_selector_country_search_label`       | Escolha um país              |
| `selphid_selector_country_search_placeholder` | Pesquise um país             |
| `selphid_selector_country_search_clear`       | Limpar pesquisa              |
| `selphid_selector_country_no_results`         | Nenhum resultado             |
| `selphid_selector_document_label`             | Qual documento você usará?   |
| `selphid_selector_document_placeholder`       | Selecione um documento       |
| `selphid_selector_document_dialog_title`      | Escolha o documento          |
| `selphid_selector_document_dialog_cancel`     | CANCELAR                     |
| `selphid_selector_document_dialog_select`     | SELECIONAR                   |
| `selphid_selector_continue`                   | Continuar                    |
| `selphid_selector_type_id_card`               | Documento de identidade      |
| `selphid_selector_type_passport`              | Passaporte                   |
| `selphid_selector_type_drivers_license`       | Carteira de motorista        |
| `selphid_selector_type_foreign_card`          | Cartão de residência         |
| `selphid_selector_type_credit_card`           | Cartão de crédito            |
| `selphid_selector_type_custom`                | Personalizado                |
| `selphid_selector_type_visa`                  | Visto                        |

### Animações <a href="#id-82-animaciones" id="id-82-animaciones"></a>

O componente usa animações **Lottie** (`.json`) tanto na *dica anterior* quanto nos *tutoriais*.

Se você quiser modificar as animações do SDK, deverá incluir os arquivos com **o mesmo nome** na pasta `res/raw/`

```
selphid_anim_tip_driver_h.json
selphid_anim_tip_driver_m.json
selphid_anim_tip_health.json
selphid_anim_tip_id_h.json
selphid_anim_tip_id_m.json
selphid_anim_tip_mrz.json
selphid_anim_tip_pass_h.json
selphid_anim_tip_pass_m.json

selphid_anim_tuto_driver_h_1.json
selphid_anim_tuto_driver_h_2.json
selphid_anim_tuto_driver_h_3.json
selphid_anim_tuto_driver_m_1.json
selphid_anim_tuto_driver_m_2.json
selphid_anim_tuto_driver_m_3.json

selphid_anim_tuto_id_h_1.json
selphid_anim_tuto_id_h_2.json
selphid_anim_tuto_id_h_3.json
selphid_anim_tuto_id_m_1.json
selphid_anim_tuto_id_m_2.json
selphid_anim_tuto_id_m_3.json

selphid_anim_tuto_pass_h_1.json
selphid_anim_tuto_pass_h_2.json
selphid_anim_tuto_pass_h_3.json
selphid_anim_tuto_pass_m_1.json
selphid_anim_tuto_pass_m_2.json
```
