Tratamento de erros genéricos

A inicializaçã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 incidentes.

• .UNKNOWN_ERROR: Ocorreu um erro que não foi identificado ou 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 acesso ao hardware ou a 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 no nível do SDK. Os componentes Selphi e SelphID também podem retornar além .SELPHI_TIMEOUT ou .SELPHID_TIMEOUT com informações adicionais; serializados como SPI_TIMEOUT ou SPD_TIMEOUT por meio de toString(addComponentPrefix:).

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 usar 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.