Apprendre
Classe de moteur
VideoPlayer
Non navigable

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.


Échantillons de code
Lecteur Vidéo (Côté Serveur)
-- Cela doit être dans un "Script" avec RunContext réglé sur "Legacy" ou "Server"
-- Créez ce qui est affiché dans la vidéo
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
-- Créez l'endroit d'où provient un asset vidéo
local videoSource = Instance.new("VideoPlayer")
videoSource.VideoContent = Content.fromUri("rbxassetid://5608359401")
videoSource.Looping = true
videoSource.Parent = videoScreenPart
-- Créez l'endroit d'où le son de la vidéo est émis
local speakerPart = Instance.new("Part")
speakerPart.Anchored = true
speakerPart.Parent = workspace
local audioEmitter = Instance.new("AudioEmitter")
audioEmitter.Parent = speakerPart
-- Créez et connectez des fils afin que la vidéo se rende visuellement et émette du son
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
-- Jouez la vidéo
-- Remarque : Jouer une vidéo sur le serveur ne garantit pas qu'elle soit chargée ou synchronisée pour tous les clients, jouer sur le client est préféré
videoSource:Play()
Lecteur Vidéo (Côté Client)
-- Cela devrait être dans un "LocalScript" ou un "Script" avec RunContext défini sur "Client"
-- Même code que l'exemple ci-dessus jusqu'à la section "Lire la vidéo"
-- Lire la vidéo après qu'elle a été chargée
videoSource:GetPropertyChangedSignal("IsLoaded"):Connect(function()
if videoSource.IsLoaded then
print("La vidéo est chargée, début de la lecture dans 2 secondes.")
wait(2)
videoSource:Play()
end
end)
-- Charger la vidéo pour qu'elle soit prête quand nous en avons besoin
videoSource:LoadAsync()
wait(5)
-- Décharger la vidéo pour économiser des ressources
videoSource:Unload()

Référence API
Propriétés
AutoLoadInStudio
Non répliqué
Non scriptable
Sécurité des scripts Roblox
Lecture parallèle
Capacités : Audio, UI
VideoPlayer.AutoLoadInStudio:boolean

AutoPlayInStudio
Non répliqué
Non scriptable
Sécurité des scripts Roblox
Lecture parallèle
Capacités : Audio, UI
VideoPlayer.AutoPlayInStudio:boolean

IsLoaded
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Audio, UI
VideoPlayer.IsLoaded:boolean

IsPlaying
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Audio, UI
VideoPlayer.IsPlaying:boolean

Looping
Lecture parallèle
Capacités : Audio, UI
VideoPlayer.Looping:boolean

MaximumResolution
Caché
Lecture parallèle
Capacités : Audio, UI, InternalTest
VideoPlayer.MaximumResolution:Enum.VideoSampleSize

PlaybackSpeed
Lecture parallèle
Capacités : Audio, UI
VideoPlayer.PlaybackSpeed:number

Resolution
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Audio, UI
VideoPlayer.Resolution:Vector2

TimeLength
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Audio, UI
VideoPlayer.TimeLength:number

TimePosition
Lecture parallèle
Capacités : Audio, UI
VideoPlayer.TimePosition:number

VideoContent
Lecture parallèle
Capacités : Audio, UI
VideoPlayer.VideoContent:Content

Volume
Lecture parallèle
Capacités : Audio, UI
VideoPlayer.Volume:number

Méthodes
GetConnectedWires
Capacités : Audio, UI
VideoPlayer:GetConnectedWires(pin:string):{Wire}
Paramètres
pin:string
Retours

GetInputPins
Capacités : Audio, UI
VideoPlayer:GetInputPins():{any}
Retours

GetOutputPins
Capacités : Audio, UI
VideoPlayer:GetOutputPins():{any}
Retours

LoadAsync
Rendement
Capacités : Audio, UI
VideoPlayer:LoadAsync():Enum.AssetFetchStatus

Pause
Capacités : Audio, UI
VideoPlayer:Pause():()
Retours
()

Play
Capacités : Audio, UI
VideoPlayer:Play():()
Retours
()

Unload
Capacités : Audio, UI
VideoPlayer:Unload():()
Retours
()

Événements
DidEnd
Capacités : Audio, UI
VideoPlayer.DidEnd():RBXScriptSignal

DidLoop
Capacités : Audio, UI
VideoPlayer.DidLoop():RBXScriptSignal

PlayFailed
Capacités : Audio, UI
VideoPlayer.PlayFailed(error:Enum.AssetFetchStatus):RBXScriptSignal
Paramètres

WiringChanged
Capacités : Audio, UI
VideoPlayer.WiringChanged(
connected:boolean, pin:string, wire:Wire, instance:Instance
Paramètres
connected:boolean
pin:string
wire:Wire
instance:Instance

©2026 Société Roblox. Roblox, le logo Roblox et Powering Imagination font partie de nos marques déposées aux États-Unis et dans d'autres pays.