Por que meu aplicativo fica travado ao usar o modo de profundidade NEURAL?

Last updated: August 13, 2026

A partir do ZED SDK v5.0, todos os modos de profundidade disponíveis são baseados em IA e desenvolvidos pelo nosso mecanismo de IA TERRA AI:

sl::InitParameters::depth_mode = sl::DEPTH_MODE::NEURAL_LIGHT
sl::InitParameters::depth_mode = sl::DEPTH_MODE::NEURAL // default
sl::InitParameters::depth_mode = sl::DEPTH_MODE::NEURAL_PLUS

Você pode encontrar uma descrição detalhada de cada modo de profundidade na Documentação dos modos de profundidade.

Cada modelo de IA de profundidade, assim como os outros modelos de IA disponíveis nos módulos de Detecção de Objetos e Rastreamento corporal do ZED SDK, deve ser baixado dos servidores da Stereolabs e otimizado para a GPU instalada no dispositivo host na primeira vez em que for utilizado. O ZED SDK executa essas operações automaticamente.

O download é necessário porque cada modelo de IA ocupa uma quantidade significativa de espaço em disco; incluir todos eles no instalador do ZED SDK resultaria em um pacote de instalação muito grande.

A etapa de otimização permite que o mecanismo de IA do ZED SDK alcance seu desempenho máximo, adaptando o modelo à arquitetura da GPU NVIDIA instalada na máquina host.

Esse procedimento deve ser executado apenas uma vez após a instalação de uma nova versão do ZED SDK, para cada modo de profundidade que você utilizar.

O download e a otimização de um modelo de IA podem levar vários minutos, dependendo do modelo da GPU e da velocidade da conexão com a internet; se essa fase não for tratada corretamente pelo seu aplicativo, isso resultará em uma interface de usuário que não responde.

Como evitar o congelamento

Sugerimos baixar e otimizar os modelos de IA de profundidade antes de iniciar seu aplicativo, executando a ferramenta ZED Diagnostic pela linha de comando:

  • Windows (de C:\Program Files (x86)\ZED SDK\tools\):
"ZED Diagnostic.exe" -nrlo_all
  • Linux:
ZED_Diagnostic -nrlo_all

A opção -nrlo_all baixa e otimiza todos os modos de profundidade baseados em IA. Você também pode otimizar um único modo de profundidade:

  • -nrlo baixa e otimiza o modelo de profundidade NEURAL
  • -nrlo_plus baixa e otimiza o modelo de profundidade NEURAL PLUS
  • -nrlo_light baixa e otimiza o modelo de profundidade NEURAL LIGHT

Se você planeja usar outros módulos de IA (Detecção de Objetos, Rastreamento corporal), pode baixar e otimizar todos os modelos de IA de uma só vez com a opção -aio.

Como alternativa, você pode usar a GUI da ferramenta ZED Diagnostic: após executar um teste de diagnóstico, clique no botão AI MODELS, selecione os modelos a serem otimizados e clique em Optimize Selection. A otimização dos modelos de IA também pode ser iniciada pela GUI da ferramenta ZED Depth Viewer.

Para obter mais informações sobre todas as opções disponíveis, consulte a documentação do ZED Diagnostics.

Observação: se um modelo otimizado for corrompido ou a otimização travar, você poderá redefinir todos os modelos de IA baixados e otimizados com a opção -aic (ou o botão CLEAR ALL MODELS na GUI) e executar a otimização novamente.

Observação: os modos de profundidade baseados em IA exigem uma GPU NVIDIA com suporte a CUDA. A versão mais recente do ZED SDK está disponível na página de Desenvolvedores.