---
title: Travamento
slug: portugues-brasil/travamento
createdAt: 2025-07-11T14:13:45.679Z
---

Para resolver um problema de travamento, é importante entender exatamente em qual parte da cadeia de rastreamento/renderização ele está ocorrendo.

Como já abordamos, o travamento é essencialmente a indisponibilidade de informações em uma determinada parte da cadeia quando elas são necessárias. Portanto, a solução de problemas consiste em analisar sistematicamente cada parte da cadeia de hardware e software e verificar se não há gargalos ou outras limitações.

::Image[]{src="https://api.archbee.com/api/optimize/qD4GJYL5qMffFW6GWjgo7-TNYEtEWDEl53-lnbwWtg7-20250728-104636.png" size="72" width="721" height="800" position="center" showCaption="false" darkWidth="721" darkHeight="800"}

Frequentemente, o primeiro passo é identificar se a causa está no lado "<font color="#2166ae">Input</font>", ou seja, no processamento de rastreamento Link, Origin.

Ou no lado "<font color="#2166ae">Output</font>", que se relaciona aos dados de rastreamento que saem do Origin e chegam e são usados no lado do renderizador.

:::ExpandableHeading
# Entrada

## Dados do CamBar

Os dados do sensor CamBar devem chegar ao Origin em tempo hábil para serem utilizados. Quando um Link está presente entre os dois dispositivos, existe a possibilidade de essa comunicação ser afetada.

Os seguintes testes podem ser realizados para verificar se o problema está sendo gerado devido a gargalos nos dados.

### Teste - Remova o Link temporariamente.

Isole temporariamente a conexão entre Link e Origin conectando o Cambar diretamente ao Origin. Se o problema de travamento for resolvido, provavelmente se trata de um problema com a interface Link ou Link>Origin.

### Teste - Ligue o Link/Origin usando uma fonte de alimentação.

Certifique-se de que os requisitos de energia do Link e do Origin estejam sendo atendidos. Se algum dos dispositivos estiver com energia insuficiente, isso pode causar gargalos de dados entre os dispositivos. O Link é particularmente suscetível a isso, pois normalmente é alimentado por saídas de câmera que podem não ser reguladas.

### Teste - Use as ferramentas de perfil do Grafana

A interface do Grafana fornece muitas métricas que podem ser úteis para identificar picos ou problemas com a conectividade entre o Link e o Origin

::Image[]{src="https://api.archbee.com/api/optimize/qD4GJYL5qMffFW6GWjgo7-I-AOts2YVsfLybPNxAkD0-20250711-142641.png" size="76" width="3513" height="1370" position="center" showCaption="false"}
:::

::::ExpandableHeading
# Saída

## Comunicação entre Origin e Renderizador

### Teste - Verifique os logs Scenario e do Renderizador

Os logs Scenario podem ser fornecidos através da função de relatório do sistema e exibirão quaisquer pacotes perdidos ou não recebidos. No lado do renderizador, uma funcionalidade semelhante deve estar disponível.

### Teste - Inspecione os dados de rastreamento, compare os dados de rastreamento localmente com os dados recebidos pela rede

Compare os dados gravados em Wrangler com os dados capturados no lado do renderizador. Se os dados capturados em Wrangler mostrarem quadros perdidos ou duplicados, isso sugere que o problema não está sendo causado pela rede ou pela sincronização entre Origin e Renderizador

### Teste - O problema ocorre ao usar um protocolo diferente?

O protocolo SDK Full usa TCP/IP, enquanto os protocolos FreeD e SDK LITE utilizam UDP. Verifique se o problema é consistente entre os protocolos.

### Teste - Conecte-se diretamente ao renderizador.

Se os dados de rastreamento entre o Origin e o renderizador não forem ponto a ponto, faça um teste temporário com uma conexão de rede direta. Isso pode eliminar a possibilidade de problemas na camada de rede, principalmente se houver switches gerenciáveis etc. em linha.

## Problemas de Renderização

Problemas de travamento geralmente são observados ao visualizar a saída de um mecanismo de renderização; portanto, é importante isolar se os problemas estão sendo gerados durante o processo de renderização como resultado de um problema de sincronização ou de uma limitação de desempenho.

Os seguintes testes são sugeridos para descartar problemas no lado da renderização

### Teste - Carregue uma cena de teste simples

Use uma cena de teste que você sabe que funciona no lado do renderizador e observe se o problema de travamento é mais ou menos frequente

### Teste - Compare os cones de calibração Scenario com a saída do renderizador

Às vezes, é possível comparar os cones de calibração com um gráfico semelhante no lado do mecanismo de renderização. Se os problemas forem observados apenas no gráfico do renderizador, isso sugere que o travamento está sendo gerado externamente a Scenario.

:::hint{type="warning"}
Ao visualizar os cones de calibração em Scenario, você deve visualizá-los com a opção "On Air" desativada para garantir a precisão da renderização. **(Quando "On Air" está ativo, a viewport é degradada para garantir o desempenho e não deve ser usada para verificações de diagnóstico)**
:::

### Teste - Verifique o Profiler da GPU

O renderizador em tempo real deve fornecer uma ferramenta de perfil para analisar ou notificar problemas de renderização, como quadros perdidos, etc. Compare se algum problema no profiler corresponde às travadas observadas.

### Teste - Certifique-se de que a sincronização esteja presente no renderizador

Verifique se o renderizador está sincronizando os dados corretamente com o sinal da câmera. No mecanismo Unreal, o "Monitor de Dados Temporizados" foi projetado para isso e indicará se há algum problema de sincronização.
::::

