Aprenda
Classe do mecanismo
VideoPlayer
Não navegável

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


Amostras de código
Reprodutor de Vídeo (Lado do Servidor)
-- Isso deve estar em um "Script" com RunContext definido como "Legacy" ou "Server"
-- Crie o que é exibido no vídeo
local videoScreenPart = Instance.new("Part")
videoScreenPart.Anchored = true
videoScreenPart.Size = Vector3.new(12, 6, 1)
videoScreenPart.CFrame = CFrame.new(0, 5, 0)
videoScreenPart.Parent = workspace
local videoScreenUI = Instance.new("SurfaceGui")
videoScreenUI.Parent = videoScreenPart
local videoDisplay = Instance.new("VideoDisplay")
videoDisplay.Size = UDim2.new(1, 0, 1, 0)
videoDisplay.Parent = videoScreenUI
-- Crie de onde um ativo de vídeo se origina
local videoSource = Instance.new("VideoPlayer")
videoSource.VideoContent = Content.fromUri("rbxassetid://5608359401")
videoSource.Looping = true
videoSource.Parent = videoScreenPart
-- Crie de onde o áudio do vídeo é emitido
local speakerPart = Instance.new("Part")
speakerPart.Anchored = true
speakerPart.Parent = workspace
local audioEmitter = Instance.new("AudioEmitter")
audioEmitter.Parent = speakerPart
-- Crie e conecte fios para que o vídeo seja renderizado visualmente e emita áudio
local videoWire = Instance.new("Wire")
videoWire.SourceInstance = videoSource
videoWire.TargetInstance = videoDisplay
videoWire.Parent = videoSource
local audioWire = Instance.new("Wire")
audioWire.SourceInstance = videoSource
audioWire.TargetInstance = audioEmitter
audioWire.Parent = videoSource
-- Reproduza o vídeo
-- Nota: Reproduzir um vídeo no servidor não garante que ele esteja carregado ou sincronizado para todos os clientes, reproduzir no cliente é preferido
videoSource:Play()
Reprodutor de Vídeo (Lado do Cliente)
-- Isso deve estar em um "LocalScript" ou "Script" com RunContext definido como "Client"
-- Mesmo código do exemplo acima até a seção "Reproduzir o vídeo"
-- Reproduza o vídeo após ele ter carregado
videoSource:GetPropertyChangedSignal("IsLoaded"):Connect(function()
if videoSource.IsLoaded then
print("O vídeo foi carregado, começando a reprodução em 2 segundos.")
wait(2)
videoSource:Play()
end
end)
-- Carregue o vídeo para tê-lo pronto quando precisarmos
videoSource:LoadAsync()
wait(5)
-- Descarregue o vídeo para economizar recursos
videoSource:Unload()

Referência API
Propriedades
AutoLoadInStudio
Não replicado
Não scriptável
Segurança do script Roblox
Ler Parallel
Recursos: Audio, UI
VideoPlayer.AutoLoadInStudio:boolean

AutoPlayInStudio
Não replicado
Não scriptável
Segurança do script Roblox
Ler Parallel
Recursos: Audio, UI
VideoPlayer.AutoPlayInStudio:boolean

IsLoaded
Somente leitura
Não replicado
Ler Parallel
Recursos: Audio, UI
VideoPlayer.IsLoaded:boolean

IsPlaying
Somente leitura
Não replicado
Ler Parallel
Recursos: Audio, UI
VideoPlayer.IsPlaying:boolean

Looping
Ler Parallel
Recursos: Audio, UI
VideoPlayer.Looping:boolean

MaximumResolution
Oculto
Ler Parallel
Recursos: Audio, UI, InternalTest
VideoPlayer.MaximumResolution:Enum.VideoSampleSize

PlaybackSpeed
Ler Parallel
Recursos: Audio, UI
VideoPlayer.PlaybackSpeed:number

Resolution
Somente leitura
Não replicado
Ler Parallel
Recursos: Audio, UI
VideoPlayer.Resolution:Vector2

TimeLength
Somente leitura
Não replicado
Ler Parallel
Recursos: Audio, UI
VideoPlayer.TimeLength:number

TimePosition
Ler Parallel
Recursos: Audio, UI
VideoPlayer.TimePosition:number

VideoContent
Ler Parallel
Recursos: Audio, UI
VideoPlayer.VideoContent:Content

Volume
Ler Parallel
Recursos: Audio, UI
VideoPlayer.Volume:number

Métodos
GetConnectedWires
Recursos: Audio, UI
VideoPlayer:GetConnectedWires(pin:string):{Wire}
Parâmetros
pin:string
Devolução

GetInputPins
Recursos: Audio, UI
VideoPlayer:GetInputPins():{any}
Devolução

GetOutputPins
Recursos: Audio, UI
VideoPlayer:GetOutputPins():{any}
Devolução

LoadAsync
Rendimentos
Recursos: Audio, UI
VideoPlayer:LoadAsync():Enum.AssetFetchStatus

Pause
Recursos: Audio, UI
VideoPlayer:Pause():()
Devolução
()

Play
Recursos: Audio, UI
VideoPlayer:Play():()
Devolução
()

Unload
Recursos: Audio, UI
VideoPlayer:Unload():()
Devolução
()

Eventos
DidEnd
Recursos: Audio, UI
VideoPlayer.DidEnd():RBXScriptSignal

DidLoop
Recursos: Audio, UI
VideoPlayer.DidLoop():RBXScriptSignal

PlayFailed
Recursos: Audio, UI
VideoPlayer.PlayFailed(error:Enum.AssetFetchStatus):RBXScriptSignal
Parâmetros

WiringChanged
Recursos: Audio, UI
VideoPlayer.WiringChanged(
connected:boolean, pin:string, wire:Wire, instance:Instance
Parâmetros
connected:boolean
pin:string
wire:Wire
instance:Instance

©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.