Reprodução de vídeo

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Você pode usar VideoFrame para reproduzir ativos de vídeo em seu jogo, seja em uma SurfaceGui no mundo 3D ou em uma interface ScreenGui. Como cada ativo de vídeo deve ser baixado para o dispositivo de cada jogador antes de ser reproduzido, a forma como seu jogo pré-carrega e reproduz vídeo tem um impacto direto no uso de dados e no desempenho. Monitorar com que frequência o vídeo é baixado em comparação com o que realmente é visualizado ajuda você a reduzir a transferência desnecessária de dados e a fornecer uma experiência mais suave, especialmente em dispositivos mais simples.

Observabilidade

O painel do Serviço de Vídeo fornece insights e análises para monitorar e otimizar como seu jogo baixa e reproduz ativos de vídeo. Você pode encontrá-lo na seção de Monitoramento do Painel do Criador. O painel apresenta dois gráficos principais: Divisão da Reprodução, que mostra a proporção de uso de vídeo eficiente versus ineficiente, e Horas de Reprodução, que rastreia o total de horas de reprodução de vídeo ao longo do período selecionado para que você possa ver como novos vídeos, atualizações e mudanças na sua lógica de reprodução afetam o uso ao longo do tempo.

Você pode filtrar ambos os gráficos usando os seguintes filtros:

FiltroDescrição
Intervalo de datasA janela de tempo para os dados exibidos, como os últimos 28 dias.
LocalO local específico dentro do seu jogo a ser analisado.
Intervalo de tempoA granularidade dos pontos de dados, como dias.

Categorias de uso de vídeo

Ambos os gráficos categorizam o uso de vídeo nas seguintes dimensões. O uso eficiente é o vídeo que é pré-carregado, reproduzido e realmente visualizado pelos seus jogadores.

StatusDescrição
Reproduzido, visualizadoVídeo que foi reproduzido e realmente visualizado pelos seus jogadores. Isso representa um uso eficiente de vídeo.
Pré-carregado, nunca reproduzidoVídeo que foi baixado (a propriedade Video ou VideoContent foi definida) mas nunca reproduzido. Esses dados foram baixados desnecessariamente.
Reproduzido, nunca visualizadoVídeo que foi reproduzido mas nunca realmente visualizado pelos jogadores, por exemplo, porque nenhum jogador estava por perto ou a interface relevante não estava visível. Essa reprodução ainda consumiu dados e memória sem fornecer nenhum benefício aos jogadores.

Se você decodificar um vídeo apenas para reproduzir seu áudio, não é contado como visualizado porque o conteúdo visual nunca é exibido. Se você só precisa do áudio, extraia-o e reproduza-o como um ativo de áudio separado em vez de usar um ativo de vídeo. Isso é mais eficiente e reduz o uso desnecessário de dados e memória.

Melhorando a eficiência do vídeo

Para melhorar a eficiência do vídeo, defina apenas a propriedade Video ou VideoContent e chame VideoFrame:Play() quando um jogador tiver uma alta chance de ver ou ouvir o VideoFrame, e limpe a propriedade (por exemplo, defina-a como "") assim que o vídeo não estiver mais visível ou em reprodução e nenhum jogador estiver por perto.

Ainda é recomendado pré-carregar e definir o conteúdo do vídeo com antecedência quando você estiver confiante de que o vídeo será visto ou ouvido, como uma cutscene obrigatória mais adiante no jogo ou um vídeo exibido em uma área central, como um hub principal. Nesses casos, o pré-carregamento ajuda a reproduzir o vídeo suavemente, sem um atraso de carregamento quando o jogador o alcança.

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.