> 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/ios-sdk/manejo-de-errores-genericos.md).

# Tratamento de erros genéricos

A execução do SDK sempre retorna um resultado. O resultado pode ser negativo e conter um erro.

O SDK iOS dispõe de erros genéricos que fornecem feedback ao integrador sobre o motivo pelo qual o processo foi interrompido.

#### Comuns - Básicos

Estados gerais que não se enquadram em uma categoria funcional específica.

* `.NO_ERROR`: Estado padrão; indica que a operação foi concluída sem ocorrências.
* `.UNKNOWN_ERROR`: Ocorreu um erro que não foi identificado nem categorizado especificamente.
* `.OTHER(String)`: Erro genérico para casos não contemplados. Inclui uma mensagem personalizada por meio de um `String`.

#### Comuns - Requisitos

Erros relacionados à disponibilidade de dados, ao ciclo de vida dos processos ou à conectividade.

* `.NO_DATA_ERROR`: O processo precisa de um valor de configuração que não foi informado corretamente ou é nulo.
* `.OPERATION_NOT_CREATED`: A operação não pôde ser inicializada corretamente.
* `.NETWORK_CONNECTION`: Erro de comunicação; o dispositivo não tem acesso à internet ou o servidor não responde.

#### Comuns - Permissões

São acionados quando o usuário ou o sistema operacional negam o acesso a hardware ou arquivos.

* `CAMERA_PERMISSION_DENIED`: O acesso à câmera do dispositivo foi bloqueado.
* `MIC_PERMISSION_DENIED`: O acesso ao microfone foi bloqueado.
* `LOCATION_PERMISSION_DENIED`: Os serviços de localização (GPS) não estão autorizados.
* `STORAGE_PERMISSION_DENIED`: A permissão de leitura/gravação no armazenamento local foi negada.

#### Comuns - Interação do Usuário

Erros decorrentes do comportamento do usuário ou de restrições da sessão.

* `CANCEL_BY_USER`: O processo foi cancelado explicitamente pelo usuário.
* `SDK_TIMEOUT`: O processo de captura excedeu o tempo máximo de espera configurado.

#### Comuns - Erros de Licença

Erros de validação relacionados à chave de licença ou aos componentes do SDK.

* `.LICENSE_CHECKER_ERROR(String)`: Erro geral durante a validação da licença com o servidor. O parâmetro `String` indica o detalhe de forma mais explícita.
* `.MISSING_COMPONENT_LICENSE_DATA`: O componente que está sendo iniciado precisa de dados que não foram configurados corretamente na licença.
* `.COMPONENT_LICENSE_ERROR`: O componente que se tenta utilizar não está habilitado na licença.
* `.EMPTY_LICENSE`: O campo da licença está vazio.

**Além dos genéricos, cada módulo pode conter erros específicos que serão detalhados em suas respectivas páginas da documentação.**