Requisitos
| Requisito | Versão Mínima |
|---|---|
| iOS | 17.0+ |
| Xcode | 15.0+ |
| Swift | 6.1+ |
Permissões Necessárias
O SDK requer a permissão de câmera noInfo.plist:
O SDK solicita automaticamente a permissão de câmera quando necessário. Se o
usuário negar a permissão, o SDK retornará o erro
cameraPermissionDenied.Instalação
Passo 1: Adicionar os XCFrameworks
Copie os arquivosHubLivenessSDK.xcframework e FaceTecSDK.xcframework para a raiz do seu projeto:
Passo 2: Adicionar ao Xcode
- Abra seu projeto no Xcode
- Selecione o target da sua aplicação
- Vá para a aba General
- Na seção Frameworks, Libraries, and Embedded Content, clique em +
- Clique em Add Other… → Add Files…
- Selecione os arquivos
.xcframeworkadicionados - Configure como Embed & Sign para cada framework
Passo 3: Configurar Build Phases
No target do app, vá em Build Phases:Link Binary With Libraries
Adicione ambos os frameworks:HubLivenessSDK.xcframeworkFaceTecSDK.xcframework
Embed Frameworks
Crie (ou edite) a fase “Embed Frameworks” e adicione ambos os xcframeworks com as opções:| Opção | Valor |
|---|---|
| Code Sign On Copy | Habilitado |
| Remove Headers On Copy | Habilitado |
Passo 4: Build Settings
Verifique a seguinte configuração no target:Configuração do Info.plist
Adicione as seguintes chaves ao seuInfo.plist:
A orientação Portrait é recomendada para melhor experiência de captura facial.
Configuração Inicial
O SDK deve ser inicializado antes de qualquer uso. A inicialização é assíncrona e deve ser feita comasync/await:
O SDK utiliza o padrão Singleton. Use
HubLiveness.shared para acessar a instância.Parâmetros de Configuração
| Parâmetro | Tipo | Descrição |
|---|---|---|
apiBaseUrl | String | URL base da API de liveness |
apiKey | String | Chave de API para autenticação |
appName | String | Nome da aplicação para identificação |
cek | String | Chave CEK codificada em Base64 |
localization | HubLocalization | Configuração de idioma e textos (opcional) |