VideoFrame
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Um VideoFrame rendiza um retângulo, como um Frame faz, com uma imagem de vídeo em movimento. O vídeo deve ser de um arquivo carregado no site do Roblox.
O vídeo é escalado para caber toda a largura do retângulo, mas parece melhor quando exibido em sua resolução nativa.
Áudio 2D e 3D
Um VideoFrame colocado abaixo de SurfaceGui em um BasePart emitirá o som daquela parte de BasePart.Position.
Um VideoFrame exibe o efeito Doppler, significando que sua frequência e altura variam com a movimentação relativa de qualquer parte a que está anexado.
O volume do VideoFrame será determinado pela distância entre o ouvinte de som do cliente (por padrão, a posição Camera ) e a posição da parte do VideoFrame.
Um VideoFrame é considerado "global" se não for colocado abaixo do SurfaceGui em uma BasePart.Neste caso, o som será reproduzido com o mesmo volume em todo o local.
Amostras de código
The code sample below demonstrates how to create and play a VideoFrame with SomeValidAssetID once the video has loaded.
local screenPart = Instance.new("Part")
screenPart.Parent = workspace
local surfaceGui = Instance.new("SurfaceGui")
surfaceGui.Parent = screenPart
local videoFrame = Instance.new("VideoFrame")
videoFrame.Parent = surfaceGui
videoFrame.Looped = true
videoFrame.Video = "rbxassetid://" -- add an asset ID to this
while not videoFrame.IsLoaded do
task.wait()
end
videoFrame:Play()Resumo
Propriedades
Indica quando o VideoFrame.Video foi carregado dos servidores do Roblox e está pronto para jogar.
Define se o VideoFrame.Video repete ou não uma vez que terminou quando estiver tocando.
Indica se o VideoFrame.Video está tocando atualmente. Pode ser definido para iniciar ou pausar a reprodução.
Obtém a resolução original da fonte do arquivo VideoFrame.Video .
Indica o comprimento do VideoFrame.Video em segundos.
Indica o progresso em segundos do VideoFrame.Video .
O ID de conteúdo do arquivo de vídeo a VideoFrame objeto está associado.
Indica quão alto o VideoFrame.Video está tocando no momento está voltar.
Determina se este elemento de UI afunda a entrada.
Determina o ponto de origem de um GuiObject , em relação ao seu tamanho absoluto.
Determina se o redimensionamento ocorre com base no conteúdo da criança.
Determina a cor de fundo GuiObject .
Determina a transparência do plano de fundo e da borda GuiObject.
Determina a cor da borda GuiObject .
Determina de que maneira a borda GuiObject é disposta em relação às suas dimensões.
Determina a largura do pixel da borda GuiObject .
Determina se descendente GuiObjects fora dos limites de um elemento GUI pai deve renderizar.
Determina se o mouse do jogador está sendo pressionado ativamente no GuiObject ou não.
Determina se o GuiButton pode ser interagido ou não, ou se o GuiState do GuiObject está mudando ou não.
Controla a ordem de classificação do GuiObject quando usado com um UIGridStyleLayout .
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para baixo.
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para a esquerda.
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para a direita.
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para cima.
Determina a posição do pixel e escalar da GuiObject .
Determina o número de graus em que o GuiObject é girado.
Determine se o GuiObject pode ser selecionado por um controle / controle de jogo.
Substitui o adorno de seleção padrão usado para gamepads.
A ordem de GuiObjects selecionada pela seleção da interface do gamepad.
Determina o tamanho do pixel e escalar do GuiObject .
Define os eixos Size que o GuiObject será baseado, em relação ao tamanho de seu pai.
Uma propriedade mista de BackgroundTransparency e TextTransparency.
Determina se o GuiObject e seus descendentes serão renderizados.
Determina a ordem em que um GuiObject renderiza em relação aos outros.
Descreve a posição real da tela de um elemento GuiBase2d , em pixels.
Descreve a rotação real da tela de um elemento GuiBase2d em graus.
Descreve o tamanho real da tela de um elemento GuiBase2d , em pixels.
Quando definido para true , a localização será aplicada a este GuiBase2d e seus descendentes.
Uma referência a um LocalizationTable para ser usado para aplicar localização automatizada a este GuiBase2d e seus descendentes.
Personaliza o comportamento de seleção de gamepad na direção de baixo.
Personaliza o comportamento de seleção do gamepad na direção esquerda.
Personaliza o comportamento de seleção do gamepad na direção certa.
Personaliza o comportamento de seleção do gamepad na direção de cima.
Permite a personalização do movimento de seleção do gamepad.
Métodos
Define VideoFrame.Playing para falso, pausando a reprodução se o VideoFrame.Video estiver tocando.
Define VideoFrame.Playing para verdadeiro, tocando o VideoFrame.Video a partir do atual VideoFrame.TimePosition.
- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Mova suavemente uma GUI para um novo UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Mova suavemente uma GUI para um novo tamanho e posição.
Eventos
Incêndios sempre que os loops VideoFrame.Video forem executados.
Incêndios quando o VideoFrame.Video completou a reprodução e parou.
Incêndios quando o VideoFrame.Video é carregado.
Este evento é disparado sempre que o VideoFrame.Video é pausado usando VideoFrame:Pause() ou definindo VideoFrame.Playing para falso.
Incêndios sempre que o VideoFrame.Video é tocado usando a função VideoFrame:Play() ou definindo VideoFrame.Playing como verdadeiro.
Dispedido quando um usuário começa a interagir através de um dispositivo de Interface Humano-Computador (botão do mouse para baixo, toque começa, botão do teclado para baixo, etc).
Dispedido quando um usuário muda como está interagindo através de um dispositivo de Interface Humano-Computador (botão do mouse para baixo, toque começa, botão da tecla para baixo, etc).
Dispedido quando um usuário para de interagir através de um dispositivo de Interface Humano-Computador (botão do mouse para baixo, toque começar, botão da tecla para baixo, etc).
Dispara quando um usuário move o mouse para um elemento de GUI.
Dispara quando um usuário move o mouse para fora de um elemento de GUI.
Incêndios sempre que um usuário move o mouse enquanto ele está dentro de um elemento de GUI.
Dispara quando um usuário rola a roda do mouse de volta quando o mouse está sobre um elemento de GUI.
Dispara quando um usuário rola a roda do mouse para a frente quando o mouse está sobre um elemento de GUI.
Disparado quando o GuiObject está sendo focado no seletor Gamepad.
Dispedido quando o seletor de Gamepad para de se concentrar no GuiObject.
Incêndios quando o jogador começa, continua e para de apertar a tecla da interface de usuário por muito tempo.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Dispara quando o jogador move o dedo sobre o elemento da interface.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Incêndios quando o jogador executa um gesto de pinça ou puxão usando dois dedos no elemento da interface.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Incêndios quando o jogador executa um gesto de rotação usando dois dedos no elemento da interface.
Incêndios quando o jogador executa um gesto de deslize no elemento da interface.
Dispara quando o jogador executa um gesto de toque no elemento da interface.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Incêndios quando a seleção do gamepad se move para, deixa ou muda dentro do conectado GuiBase2d ou qualquer descendente GuiObjects.
Propriedades
IsLoaded
Essa propriedade será verdadeira quando o VideoFrame.Video foi carregado dos servidores do Roblox e estiver pronto para jogar.
Looped
Essa propriedade define se o VideoFrame.Video repete ou não uma vez que terminou quando está tocando.
Playing
Essa propriedade indica se o VideoFrame.Video está tocando atualmente.Pode ser definido para iniciar ou pausar a reprodução como uma alternativa às funções VideoFrame:Play() e VideoFrame:Pause().
TimeLength
Essa propriedade indica o comprimento do VideoFrame.Video em segundos. Se o vídeo não for carregado, esse valor será 0.
TimePosition
Essa propriedade indica o progresso em segundos do VideoFrame.Video .Pode ser alterado para mover a posição de reprodução do vídeo antes e durante a reprodução.
Video
O ID de conteúdo do arquivo de vídeo a VideoFrame objeto está associado.
Amostras de código
The code sample below demonstrates how to create and play a VideoFrame with SomeValidAssetID once the video has loaded.
local screenPart = Instance.new("Part")
screenPart.Parent = workspace
local surfaceGui = Instance.new("SurfaceGui")
surfaceGui.Parent = screenPart
local videoFrame = Instance.new("VideoFrame")
videoFrame.Parent = surfaceGui
videoFrame.Looped = true
videoFrame.Video = "rbxassetid://" -- add an asset ID to this
while not videoFrame.IsLoaded do
task.wait()
end
videoFrame:Play()Volume
Essa propriedade determina o quão alto o VideoFrame.Video toca voltar. Pode ser definida para um número entre 0 e 100.
Métodos
Pause
Define VideoFrame.Playing para falso, pausando a reprodução se o VideoFrame.Video estiver tocando.
Como VideoFrame.TimePosition não é redefinir, quando o vídeo for retomado, ele continuará de sua posição anterior.
Devolução
Play
Define VideoFrame.Playing para verdadeiro, Isso joga o VideoFrame.Video, continuando a partir do atual VideoFrame.TimePosition.
Devolução
Amostras de código
The code sample below demonstrates how to create and play a VideoFrame with SomeValidAssetID once the video has loaded.
local screenPart = Instance.new("Part")
screenPart.Parent = workspace
local surfaceGui = Instance.new("SurfaceGui")
surfaceGui.Parent = screenPart
local videoFrame = Instance.new("VideoFrame")
videoFrame.Parent = surfaceGui
videoFrame.Looped = true
videoFrame.Video = "rbxassetid://" -- add an asset ID to this
while not videoFrame.IsLoaded do
task.wait()
end
videoFrame:Play()Eventos
DidLoop
Um evento que dispara sempre que os loops VideoFrame.Video são acionados. Retorna o ID de conteúdo do vídeo.
Parâmetros
O ID do conteúdo do vídeo que foi repetido.
Ended
Este evento é disparado quando o VideoFrame.Video completou a reprodução e parou.
Parâmetros
O ID do conteúdo do pausado que terminou.
Loaded
Este evento dispara quando o VideoFrame.Video é carregado.
Parâmetros
O ID do conteúdo do vídeo carregado.
Paused
Este evento é disparado sempre que o VideoFrame.Video é pausado usando VideoFrame:Pause() ou definindo VideoFrame.Playing para falso.
Parâmetros
O ID do conteúdo do vídeo pausado.
Played
Este evento dispara sempre que o VideoFrame.Video é tocado usando a função VideoFrame:Play() ou definindo VideoFrame.Playing como verdadeiro.
Parâmetros
O ID do conteúdo do vídeo reproduzido.