For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Atualizado