Troubleshooting

Build Phases > Link Binary With Libraries
  ✅ HubLivenessSDK.xcframework
  ✅ FaceTecSDK.xcframework

Build Phases > Embed Frameworks
  ✅ HubLivenessSDK.xcframework (Code Sign On Copy)
  ✅ FaceTecSDK.xcframework (Code Sign On Copy)

seu-projeto/
  HubLivenessSDK.xcframework    ✅
  FaceTecSDK.xcframework        ✅ (obrigatório)
  SeuProjeto.xcodeproj

// ✅ Correto
Task {
    do {
        try await HubLiveness.shared.initialize(config: config)
        // Agora pode usar startLiveness
    } catch {
        print("Erro: \(error)")
    }
}

// ❌ Incorreto - chamar startLiveness sem inicializar
try await HubLiveness.shared.startLiveness(riskLevel: .high) { _ in }

<key>NSCameraUsageDescription</key>
<string>Este aplicativo precisa acessar a camera para realizar a verificacao de prova de vida.</string>

import AVFoundation

func checkCameraPermission() {
    switch AVCaptureDevice.authorizationStatus(for: .video) {
    case .authorized:
        startLiveness()
    case .notDetermined:
        AVCaptureDevice.requestAccess(for: .video) { granted in
            if granted {
                DispatchQueue.main.async { self.startLiveness() }
            }
        }
    case .denied, .restricted:
        // Mostrar alerta para abrir configurações
        openSettings()
    @unknown default:
        break
    }
}

func openSettings() {
    if let url = URL(string: UIApplication.openSettingsURLString) {
        UIApplication.shared.open(url)
    }
}

let config = HubConfig(
    apiBaseUrl: "https://api.example.com",  // URL válida com https
    apiKey: "sk_...",                        // API key válida
    appName: "MeuApp",                       // Nome não vazio
    cek: "eyJ2ZXJzaW9u...",                  // CEK válido em base64
    localization: .ptBR
)

curl -I https://api.yourserver.com/health

case .failure(let error):
    if case .livenessCheckFailed(let reason) = error {
        showRetryAlert(reason: reason)
    }