O Console do Desenvolvedor é uma ferramenta para depurar sua experiência ao testar no Studio ou ao executá-la em produção. Ele exibe mensagens de log e erros semelhantes à janela de saída e informações detalhadas sobre Memória e Rede.
Abrindo o Console do Desenvolvedor
Para abrir o Console do Desenvolvedor durante o teste ou execução de uma experiência, digite /console no chat ou pressione F9. Você também pode usar as configurações da experiência:
- Abra as Configurações da experiência.
- Role para baixo até encontrar Console do Desenvolvedor.
- Ao lado de Console do Desenvolvedor, clique em Abrir.
Guias do Console
A barra de atalhos na parte superior do console mostra o número de erros críticos e avisos, uso de memória do cliente e tempo médio de ping. Clique em qualquer um deles para ir para sua guia correspondente no console. Abaixo da barra de atalhos, há uma série de guias, incluindo Log, Memória e Rede.
Log
A guia Log exibe mensagens de diagnóstico de scripts. Ela possui duas seções: Cliente e Servidor.
- A seção Cliente mostra a saída de LocalScripts em execução no cliente. Qualquer pessoa executando uma experiência pode ver essas mensagens de saída locais.
- A seção Servidor mostra a saída de Scripts em execução nos servidores da Roblox. Somente o proprietário da experiência ou membros do grupo com permissão de edição podem acessar esta seção.
Você pode filtrar as mensagens de saída no log usando as seguintes caixas de seleção:
| Saída | Mensagens geradas por chamadas para print() e declarações warn() em scripts. |
| Informação | Mensagens geradas pela experiência que não são erros ou declarações de saída personalizadas. |
| Aviso | Mensagens que indicam um problema potencial, mas não um problema crítico. |
| Erro | Mensagens que indicam que algo crítico aconteceu. |
Barra de Comandos
A seção Servidor possui uma Barra de Comandos que permite que os usuários com permissões de edição executem código Luau arbitrário. Esta barra de comandos tem as mesmas restrições de segurança dos objetos Script e LocalScript, portanto, ao contrário da barra de comandos no Studio, ela não pode executar funções protegidas.
Memória
A guia Memória do console mostra métricas sobre o uso de memória. Modelos, terrenos, peças, efeitos visuais, scripts, engenhocas físicas, áudio e mais podem contribuir para o uso total de memória. A guia Memória possui a seguinte seção:
- MemóriaPrincipal – Memória usada por processos incorporados ao mecanismo da Roblox, como rede, avatares e elementos de GUI.
- MemóriaLocal – Memória que se ajusta como resultado direto das escolhas feitas ao criar uma experiência.
- MemóriaNãoRastreada – Alocações de memória arbitrárias que não são marcadas.
- MemóriaLocalScript – Memória usada por threads de script Luau do usuário. Esta seção inclui nomes de scripts e tags de memória personalizadas.
- MemóriaScriptPrincipal – Memória usada por threads de script internos da Roblox.
A seção MemóriaLocal possui subcategorias. A tabela a seguir descreve cada subcategoria e dá dicas para reduzir o uso de memória.
| Categoria | Descrição | Dicas de Gerenciamento de Memória |
|---|---|---|
| CacheHttp | Ativos (imagens, meshes, etc.) carregados dos servidores da Roblox e agora mantidos em cache na memória. | Carregue menos ativos ou ativos menores. |
| Instâncias | Instâncias no local. | Se possível, reduza o número total de Instâncias (objetos na janela Explorer). |
| Sinais | Sinais que disparam entre Instâncias (um evento disparando em uma Instância para acionar um evento em outra Instância). | Use menos conexões de eventos entre Instâncias. |
| HeapLua | Memória de heap para scripts principais (scripts que vêm com o cliente Roblox) e scripts personalizados. | Escreva scripts eficientes em termos de memória. |
| Script | Scripts Lua. | Use menos scripts ou scripts mais curtos. |
| ColisãoFísica | Dados de colisão para simulações físicas. | Se uma peça não precisa se mover, defina BasePart.Anchored para true. Se uma peça nunca precisa colidir com nada, defina BasePart.CanCollide para false. |
| PeçasFísicas | Geometria e cinemática física. | Use peças mais simples, menores ou menos peças. |
| ModelosSólidosGráficos | Dados gráficos para renderizar modelos sólidos. | Use menos modelos sólidos ou defina Enum.RenderFidelity para Automático. |
| PeçasMalhaGráficas | Gráficos para objetos MeshPart. | Use menos malhas ou malhas mais simples. |
| PartículasGráficas | Gráficos para sistemas de partículas. | Use menos sistemas de partículas ou produza menos partículas com durações menores. |
| PeçasGráficas | Gráficos para peças. | Use menos peças ou peças mais simples. |
| HashEspacialGráficos | Renderização geral. | Use menos peças, partículas, luzes e qualquer outra coisa que contribua para a renderização. |
| TerrenoGráficos | Gráficos para terrenos. | Use menos terreno. |
| TexturaGráficos | Memória de textura. | Use menos texturas ou texturas menores. |
| TexturaPersonagemGráficos | Memória de textura para personagens. | Use menos aparências de personagens únicas. |
| Sons | Sons na memória. | Use menos sons ou sons menores. |
| SonsStreaming | Sons em streaming. | Use menos sons em streaming. |
| VóxeisTerreno | Vóxeis de terreno. | Use menos terreno. |
| FísicaTerreno | Física do terreno. | Para objetos próximos ao terreno, defina BasePart.CanCollide para false e/ou BasePart.Anchored para true. |
| Gui | Memória usada por elementos de GUI comuns. | Reduza ou otimize o uso de instâncias de GUI. |
| Animação | Memória usada para dados de animação, como poses e dados em cache KeyframeSequence para animações de avatar. | Use menos animações distintas e otimize as animações, se possível. |
| Navegação | Memória usada por estruturas de suporte para PathfindingService. | Otimiza o uso e faça menos chamadas para PathfindingService. |
Rede
A guia Rede do Console do Desenvolvedor mostra o número de chamadas web que a experiência fez. Isso inclui chamadas explícitas feitas por meio de HttpService e solicitações web feitas pelos serviços da Roblox, como DataStoreService. A guia Rede possui duas seções: Resumo e Detalhe.
A seção Resumo lista um resumo de todas as chamadas web por tipo. Cada tipo tem detalhes sobre o número de solicitações, o número de solicitações falhadas e o tempo que a solicitação levou.
A seção Detalhes lista cada chamada web individual. Cada linha mostra o método HTTP, como GET ou POST, juntamente com o código de status, tempo de execução, tipo de solicitação e URL da solicitação. Clique na chamada web para ver os detalhes da resposta:
