在 VideoFrame 实例中使用的视频资源允许在体验中播放视频。您可以 上传 您确定有权限使用的视频,例如您自己制作的视频,并且 资产隐私 系统会自动确保您上传的视频的 ID 不会被没有适当权限的用户访问。
上传视频
如果您是 13 岁以上 ID 验证 的用户,您可以通过 资产管理器、创作者仪表盘 或 开放云 API 上传视频。只要视频符合以下要求,您就可以上传视频:
- 您有合法权利使用该视频资产。
- 它符合 Roblox 社区标准 和 使用条款。
- 它的时长为 5 分钟或更短,格式为 .mp4 或 .mov。
- 分辨率小于或等于 4096×2160。
- 文件大小小于 3.75 GB。
不符合这些要求的视频将被拒绝。不支持 Alpha 通道,将被忽略。上传视频时,请考虑以下事项:
- 每次视频上传费用为 2000 Robux。
- 每天最多可以上传 20 个视频。
播放视频
VideoFrame 必须是 ScreenGui、SurfaceGui 或 BillboardGui 的子节点才能播放。目前,最多可以同时播放两个视频。
要在体验中播放视频而无需代码:
创建一个 ScreenGui,如 屏幕 UI 容器 中所述,或创建一个 SurfaceGui 或 BillboardGui,如 体验内 UI 容器 中所述。
从 工具箱 或 资产管理器 中插入一个视频。会为该视频插入一个新的 VideoFrame 对象。
将 VideoFrame 作为子节点添加到容器中。

选择新的 VideoFrame,在 属性 窗口中启用其 循环播放 和 正在播放 属性。

如果您想通过代码在体验中播放视频,请将以下代码粘贴到 ServerScriptService 中的 Script 内,以创建一个 Part 并在其前表面播放视频。
local Workspace = game:GetService("Workspace")local screenPart = Instance.new("Part")screenPart.Size = Vector3.new(16, 9, 1)screenPart.Position = Vector3.new(0, 8, -20)screenPart.Orientation = Vector3.new(0, 180, 0)screenPart.Anchored = truescreenPart.Parent = Workspacelocal surfaceGui = Instance.new("SurfaceGui")surfaceGui.Parent = screenPartlocal videoFrame = Instance.new("VideoFrame")videoFrame.Size = UDim2.new(1, 0, 1, 0)videoFrame.Parent = surfaceGuivideoFrame.Looped = truevideoFrame.Video = "rbxassetid://5608384572" -- 用您的视频资产 ID 替换while not videoFrame.IsLoaded dovideoFrame.Loaded:Wait()endvideoFrame:Play()