> For the complete documentation index, see [llms.txt](https://doc.ozforensics.com/oz-knowledge/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ozforensics.com/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/sdk/oz-mobile-sdk/ios/changelog.md).
# Registro de alterações
#### 10.2.0 – 12 de ago. de 2026
* O **One Shot** gesto agora está marcado como obsoleto. Em 1º de janeiro de 2027, ele ficará indisponível. Planeje sua [migração](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/guias-de-migracao/migracao-do-gesto-one-shot.md).
* A dica da tela de Liveness não se sobrepõe mais à barra de ferramentas nem a outros elementos de UI — agora é renderizada acima de todos os elementos da tela de Liveness.
* Melhorias internas.
#### 10.1.0 – 29 de jun. de 2026
* Agora é possível renomear a tabela de localização por meio do [`set(localizableTableName)`](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/sdk/oz-mobile-sdk/ios/ios-sdk-methods-and-properties.md#set-1) método.
* Fotos de referência maiores que 5 MB agora são compactadas.
* Corrigido o VoiceOver para o **Fechar** botão e a dica antiscam.
* O SDK não retorna mais o resultado DECLINED se a mídia de origem estiver compactada.
* Liveness não falha mais em compilações de debug que contêm a biblioteca Flex.
* Exemplo atualizado.
#### 10.0.0 – 3 de jun. de 2026
{% hint style="warning" %}
**Mudanças incompatíveis**: para o fluxo OzCapsula, esta versão do SDK requer API 6.6.0.1 ou superior.
{% endhint %}
* Dependências internas atualizadas.
* Segurança aprimorada.
#### 9.3.0 – 22 de mai. de 2026
* Os arquivos passados por meio de `UserMedia` em `MediaRequest` (OzCapsula) agora são nomeados usando um identificador UUID v4 com a extensão original do arquivo. O nome original do arquivo ainda pode ser transmitido por meio do `mediaMeta` campo.
* Os callbacks do observador de telemetria (`EventObserver.update()` e `EventObserver.onDetected()`) agora são enviados em uma thread em segundo plano.
* Atualizado o SDK para estar em conformidade com a Apple Required Reasons API.
* O crash de `dispatch_group_leave()` desbalanceado ao expirar a sessão no view controller não ocorre mais.
* Removido o `OZ_` prefixo dos casos de `ContainerType`.
* Agora enviamos a **One Shot** mídia do gesto como ZIP em vez de JPEG.
* Segurança aprimorada.
#### 9.2.0 – 23 de abr. de 2026
* Adicionado o novo `addAnalysisProfile` método. Ele permite anexar um AnalysisProfile adicional (por exemplo, uma foto de referência) a um contêiner OzCapsula existente gerado durante a captura, formando um pacote com vários contêineres para análises biométricas ou abrangentes. O token da sessão e a instância OzCapsula existente são lidos automaticamente da memória do dispositivo; nenhum parâmetro adicional é necessário. **Aviso: requer API 6.6.1 e superior**.
* O **Scan** gesto agora é mais fácil de executar: problema com dicas conflitantes resolvido.
* Exemplo atualizado para cobrir o caso de verificação biométrica usando OzCapsula.
* Resolvido o problema de conflito na integração com SQLCipher.
#### 9.1.0 – 17 de mar. de 2026
* Adicionado suporte para transmissão de dados otimizada ao usar contêiner.
#### 9.0.0 – 17 de fev. de 2026
* Agora é possível [personalizar a posição do logotipo](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/sdk/oz-mobile-sdk/ios/ios-sdk-methods-and-properties.md#logocustomization) (se permitido pela licença).
* O **Scan** gesto agora é anunciado corretamente.
#### 8.23.0 – 6 de fev. de 2026
* Exemplo de código atualizado em conformidade com a funcionalidade OzCapsula.
* Mensagens antiscam longas agora são exibidas corretamente.
* O SDK não trava mais quando a tela de Liveness é chamada várias vezes seguidas em intervalos curtos.
* Resolvido o problema de erros de contêiner não serem retornados.
* Dependências atualizadas.
#### 8.22.0 – 9 de dez. de 2025
{% hint style="info" %}
Implementado um novo formato de dados proprietário: [OzCapsula Data Container](/oz-knowledge/oz-knowledge/pt-br/geral/conceitos-chave-de-oz-liveness-e-biometria/formato-proprietario-ozcapsula-data-container.md).
{% endhint %}
* Resolvido o problema de o SDK não retornar os callbacks relacionados à licença.
* Segurança aprimorada.
#### 8.21.0 – 21 de nov. de 2025
* Resolvido o problema de o SDK às vezes não responder às ações do usuário em alguns dispositivos.
* SDK atualizado para oferecer suporte aos próximos recursos de segurança.
#### 8.20.0 – 17 de out. de 2025
* Corrigido o bug com travamentos que podiam ocorrer durante a análise BIOMETRY após tirar uma foto de referência usando a câmera.
* Segurança aprimorada.
#### 8.19.0 – 23 de set. de 2025
* O **Scan** a animação do gesto agora funciona corretamente.
* Corrigido o bug em que o SDK não chamava o completion durante a inicialização no modo debug.
* Segurança aprimorada.
#### 8.18.2 – 22 de ago. de 2025
* Corrigido um crash do SDK que ocasionalmente ocorria ao invocar a licença.
#### 8.18.1 – 6 de ago. de 2025
{% hint style="warning" %}
Recomenda-se fortemente atualizar para esta versão.
{% endhint %}
* Resolvido o problema de integração via Swift UI.
* O SDK não trava mais em smartphones com pouco armazenamento disponível.
* Atualizações de segurança e telemetria.
#### 8.17.0 – 12 de jun. de 2025
* Atualizações de segurança.
#### 8.16.2 – 22 de abr. de 2025
* Xcode atualizado para a versão 16 para atender aos requisitos da Apple.
#### 8.16.1 – 9 de abr. de 2025
* Atualizações de segurança.
#### 8.16.0 – 11 de mar. de 2025
* Atualizada a lógica de autorização.
* VoiceOver aprimorado.
* O SDK agora compacta vídeos se o tamanho deles exceder 10 MB.
* Os gestos de movimento da cabeça agora são tratados corretamente.
* Atualizações de segurança.
#### 8.15.0 – 30 de dez. de 2024
* A redação do gesto head\_down foi alterada: a nova redação é “tilt down”.
* Adicionada a ordem de foco correta para o VoiceOver quando a dica antiscam está ativada.
* Adicionada a configuração pública extract\_action\_shot no aplicativo de demonstração.
* Correções de bugs.
* Atualizações de segurança.
#### 8.14.0 – 3 de dez. de 2024
* Atualizações de acessibilidade de acordo com os requisitos WCAG: as dicas do SDK e os controles de UI podem ser anunciados.
* Experiência do usuário aprimorada com gestos de movimento da cabeça.
* Correções menores de bugs e atualizações de telemetria.
#### 8.13.0 – 11 de nov. de 2024
* O brilho da tela não muda mais quando a câmera traseira é usada.
* Corrigidos os problemas de gravação de vídeo em alguns modelos de smartphone.
* Atualizações de segurança e telemetria.
#### 8.12.2 – 24 de out. de 2024
* Melhorias internas do SDK.
#### 8.12.1 – 30 de set. de 2024
* Adicionado suporte ao Xcode 16.
* Atualizações de segurança e telemetria.
#### 8.11.0 – 10 de set. de 2024
* Atualizações de segurança.
#### 8.10.1 – 23 de ago. de 2024
* Correções de bugs.
#### 8.10.0 – 1º de ago. de 2024
* O SDK agora requer Xcode 15 e versões mais recentes.
* Atualizações de segurança.
* Correções de bugs.
#### 8.9.1 – 16 de jul. de 2024
* Melhorias internas do SDK.
#### 8.8.3 – 11 de jul. de 2024
* Melhorias internas do SDK.
#### 8.8.2 – 25 de jun. de 2024
* Correções de bugs.
#### 8.8.1 – 25 de jun. de 2024
* Atualizações de logging.
#### 8.8.0 – 18 de jun. de 2024
* Atualizações de segurança.
#### 8.7.0 – 10 de mai. de 2024
* Agora é possível instalar o iOS SDK via Swift Package Manager.
* O exemplo agora está disponível em SwiftUI. Consulte-o [aqui](https://gitlab.com/oz-forensics/oz-mobile-ios-sample-swiftui).
* Adicionada uma descrição para o erro que ocorre ao fornecer uma string vazia como ID no `addFolderID` método.
* Correções de bugs.
#### 8.6.0 – 10 de abr. de 2024
* As mensagens exibidas pelo SDK após o upload da mídia foram sincronizadas com Android.
* O bug que causava atrasos na análise que podiam ocorrer para o **One Shot** gesto foi corrigido.
#### 8.5.0 – 6 de mar. de 2024
* O tempo de duração do **Selfie** gesto agora é [configurável](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/sdk/oz-mobile-sdk/ios/ios-sdk-methods-and-properties.md#setselfielength) (afeta o tamanho do arquivo de vídeo).
* É possível [definir seu próprio logotipo](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/sdk/oz-mobile-sdk/ios/ios-sdk-methods-and-properties.md#logocustomization) em vez do logotipo Oz, se a licença permitir.
* Removida a pausa após o **Scan** gesto.
* O código em [Readme.md](https://gitlab.com/oz-forensics/oz-liveness-ios) está atualizado.
* Atualizações de segurança e logging.
#### 8.4.2 – 24 de jan. de 2024
* Atualizações de segurança.
#### 8.4.0 – 9 de jan. de 2024
* Alterado o comportamento padrão caso uma chave de localização esteja ausente: agora o valor da string em inglês é exibido em vez da chave.
* Corrigidos alguns bugs.
#### 8.3.3 – 11 de dez. de 2023
* Melhorias internas de licenciamento.
#### 8.3.0 – 17 de nov. de 2023
* Implementada a possibilidade de usar uma licença mestra que funciona com qualquer `bundle_id`.
* Corrigido o bug de piscar da cor de fundo.
#### 8.2.1 – 11 de nov. de 2023
* Correções de bugs.
#### 8.2.0 – 30 de out. de 2023
* O `Análise` estrutura agora contém o `sizeReductionStrategy` campo. Este campo define qual tipo de mídia está sendo enviada ao servidor no caso da análise híbrida, assim que a análise no dispositivo for concluída com sucesso.
* As mensagens dos erros recuperados da API agora são detalhadas.
* O `toFrameGradientColor` opção em `hintAnimationCustomization` está agora obsoleta, use a `hintGradientColor` opção em seu lugar.
* O suporte ao iOS 11 foi restaurado.
#### 8.1.1 – 9 de out. de 2023
* Se várias análises forem aplicadas à pasta simultaneamente, o sistema as envia como um grupo. Isso significa que o “pior” dos resultados será considerado como resolução, e não o mais recente. Consulte este artigo para detalhes.
* Para a análise de Liveness, o sistema agora trata a maior pontuação como resultado quantitativo. A saída da análise de Liveness é descrita [aqui](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/api/oz-api/types-of-analyses-and-what-they-check.md#output-1).
#### 8.1.0 – 7 de set. de 2023
* Atualizado o modelo Liveness no dispositivo.
* Adicionado o locale Português (Brasil).
* Agora é possível adicionar um pacote de idioma personalizado ou atualizar um existente. As instruções podem ser encontradas [aqui](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/sdk/oz-mobile-sdk/ios/ios-localization-adding-a-custom-or-updating-an-existing-language-pack.md).
* Se uma mídia não tiver sido enviada corretamente, o sistema agora repete o upload.
* Adicionado um novo método para recuperar o identificador de telemetria (logging): `getEventSessionId`.
* O `setPermanentAccessToken`, `configure` e `login` métodos estão agora obsoletos. Use o `setApiConnection` método em seu lugar.
* O `setLicense(from path:String)` método está agora obsoleto. Use o `setLicense(licenseSource: LicenseSource)` método em seu lugar.
* Corrigidos alguns bugs e aprimorado o funcionamento do SDK.
#### 8.0.2 – 15 de ago. de 2023
* Corrigidos alguns bugs e aprimorados os algoritmos do SDK.
#### 8.0.0 – 27 de jun. de 2023
* Adicionado o novo modo de análise – híbrido (somente Liveness). Se a pontuação recebida de uma análise no dispositivo for muito alta, o sistema inicia uma análise baseada em servidor como verificação adicional.
* Aprimorados os modelos no dispositivo.
* Atualizado o método run.
* Adicionadas novas estruturas: `RequestStatus` (estado da análise), `ResultMedia` (resultado da análise para uma única mídia) e `RequestResult` (resultado de análise consolidado para todas as mídias).
* A estrutura atualizada `AnalysisResult` deve ser usada em vez de `OzAnalysisResult`.
* Para o `OZMedia` objeto, agora é possível especificar tags adicionais que não estão incluídas em nossa lista de tags.
* A duração do vídeo Selfie agora é de cerca de 0,7 s; o tamanho do arquivo e o tempo de upload foram reduzidos.
* A largura do texto da dica agora pode exceder a largura do frame (ao usar a câmera principal).
* Os métodos abaixo não têm mais suporte:
| **Método removido** | **Substituição** |
| --------------------------- | ------------------- |
| analyse | AnalysisRequest.run |
| addToFolder | uploadMedia |
| documentAnalyse | AnalysisRequest.run |
| uploadAndAnalyse | AnalysisRequest.run |
| runOnDeviceBiometryAnalysis | AnalysisRequest.run |
| runOnDeviceLivenessAnalysis | AnalysisRequest.run |
| addMedia | uploadMedia |
#### 7.3.0 – 6 de jun. de 2023
* Adicionada a personalização do fundo da dica central.
* Adicionados novos formatos de moldura facial (Circle, Square).
* Adicionado o widget antiscam e sua personalização. Este recurso permite alertar seus clientes de que a gravação de vídeo está sendo realizada, por exemplo, para fins de solicitação de empréstimo. O objetivo disso é proteger contra golpistas que possam tentar enganar uma pessoa para que aprove uma transação fraudulenta.
* Sincronizados os valores padrão de personalização com Android.
* Adicionado o locale espanhol.
* iOS 11 não tem mais suporte; a versão mínima exigida é 12.
#### 7.2.1 – 24 de mai. de 2023
* Corrigido o problema com a análise One shot baseada em servidor.
#### 7.2.0 – 18 de mai. de 2023
* Aprimorados os algoritmos do SDK.
#### 7.1.6 – 4 de mai. de 2023
* Corrigido o tratamento de erros ao enviar um arquivo para a API. A partir desta versão, um erro será lançado para um aplicativo host em caso de erro durante o upload do arquivo.
#### 7.1.5 – 3 de abr. de 2023
* Aprimorado o Liveness no dispositivo.
#### 7.1.4 – 24 de mar. de 2023
* Corrigida a animação para óculos escuros/máscara.
* Corrigido o bug com o `.document` análise.
* Atualizadas as descrições dos métodos e estruturas de personalização.
#### 7.1.2 – 21 de fev. de 2023
* Atualizada a versão do TensorFlow para 2.11.
* Corrigidos vários bugs, incluindo as falhas de verificação BIOMETRY em alguns modelos de telefone.
#### 7.1.1 – 6 de fev. de 2023
* Adicionada personalização para a animação da dica.
#### 7.1.0 – 20 de jan. de 2023
* Integrado um novo modelo.
* Adicionado o `uploadMedia` método para `AnalysisRequest`. O `addMedia` método está agora obsoleto.
* Corrigido o erro de análise combo.
* Adicionado um botão para redefinir o tema e as configurações de idioma do SDK.
* Corrigidos alguns bugs e problemas de localização.
* Estendido o tempo limite da requisição de rede para 90 s.
* Adicionada uma configuração para o tamanho do ícone da animação.
#### 7.0.0 – 8 de dez. de 2022
* Implementada uma variedade de [personalização de UI](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/sdk/oz-mobile-sdk/ios/customizing-ios-sdk-interface.md) opções e migrado para o novo design. Para restaurar as configurações anteriores, consulte [este artigo](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/sdk/oz-mobile-sdk/ios/customizing-ios-sdk-interface/how-to-restore-the-previous-design-after-an-update.md).
#### 6.7.0
* O `run` método agora funciona de forma semelhante ao do Android SDK e retorna um array de resultados da análise.
#### 6.4.0
* Sincronizados os números de versão com Android SDK.
* Adicionado um novo campo à `Análise` estrutura. O `params` campo é para quaisquer parâmetros adicionais, por exemplo, se for necessário definir a extração do melhor quadro no servidor como true. O algoritmo de melhor quadro escolhe o frame de maior qualidade de um vídeo.
* Corrigidos alguns problemas de localização.
* Alterado o gesto Combo.
* Agora é possível iniciar a verificação de Liveness para analisar imagens capturadas com outro SDK.
#### 3.0.1
* Os gestos Zoom in e Zoom out não têm mais suporte.
#### 3.0.0
* Adicionada uma nova estrutura simplificada de análise – `AnalysisRequest`.
#### 2.3.0
* Adicionados métodos de análise no dispositivo: `runOnDeviceLivenessAnalysis` e `runOnDeviceBiometryAnalysis`.
* É possível escolher a versão de instalação. A instalação padrão dá acesso à funcionalidade completa. A `core` versão (`OzLivenessSDK/Core`) instala o SDK sem a funcionalidade no dispositivo.
* Adicionado um método para enviar dados ao servidor e iniciar a análise imediatamente: `uploadAndAnalyse`.
* Aprimorado o processo de licenciamento; agora é possível adicionar uma licença ao inicializar o SDK: `OZSDK(licenseSources: [LicenseSource], completion: @escaping ((LicenseData?, LicenseError?) -> Void))`, onde `LicenseSource` é um caminho para o local físico da sua licença, `LicenseData` contém as informações da licença.
* Adicionado o `setLicense` método para forçar a adição da licença.
#### 2.2.3
* Adicionado o locale turco.
#### 2.2.1
* Adicionado o locale quirguiz.
* Adicionado Completion Handler para os resultados da análise.
* Adicionadas informações de usuário de erro à telemetria para exibir informações detalhadas em caso de erro de análise.
#### 2.2.0
* Adicionada análise local no dispositivo.
* Adicionadas molduras ovais e retangulares.
* Adicionado suporte ao Xcode 12.5.1+.
#### 2.1.4
* Adicionada configuração do SDK com licenças.
#### 2.1.3
* Adicionado o gesto One Shot.
* Aprimorado `OZVerificationResult`: adicionado `bestShotURL` que contém a imagem do melhor frame e `preferredMediaURL` que contém uma URL para o vídeo da melhor qualidade.
* Ao executar uma verificação local, agora é possível escolher uma câmera principal ou traseira.
#### 2.1.2
* As sessões de autorização são estendidas automaticamente.
* Interfaces de autorização atualizadas.
#### 2.1.1
* Adicionado o locale cazaque.
* Adicionados textos de erro da licença.
#### 2.1.0
* É possível cancelar solicitações de rede.
* É possível especificar Bundle para a licença.
* Adicionada parametrização da análise `documentAnalyse`.
* Corrigidos erros de compilação (Xcode 12.4 / Cocoapods 1.10.1).
#### 2.0.0
* Adicionado suporte à licença.
* Adicionado suporte ao Xcode 12 em vez de 11.
* Corrigido o `documentAnalyse` erro em que era necessário preencher `analyseStates` para iniciar a análise.
* Corrigido o registro de logs.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://doc.ozforensics.com/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/sdk/oz-mobile-sdk/ios/changelog.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.