视频帧

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

VideoFrame 实例中使用的视频资源允许在体验中播放视频。您可以 上传 您确定有权限使用的视频,例如您自己制作的视频,并且 资产隐私 系统会自动确保您上传的视频的 ID 不会被没有适当权限的用户访问。

上传视频

如果您是 13 岁以上 ID 验证 的用户,您可以通过 资产管理器创作者仪表盘开放云 API 上传视频。只要视频符合以下要求,您就可以上传视频:

  • 您有合法权利使用该视频资产。
  • 它的时长为 5 分钟或更短,格式为 .mp4.mov
  • 分辨率小于或等于 4096×2160。
  • 文件大小小于 3.75 GB。

不符合这些要求的视频将被拒绝。不支持 Alpha 通道,将被忽略。上传视频时,请考虑以下事项:

  • 每次视频上传费用为 2000 Robux。
  • 每天最多可以上传 20 个视频。

播放视频

VideoFrame 必须是 ScreenGuiSurfaceGuiBillboardGui 的子节点才能播放。目前,最多可以同时播放两个视频。

要在体验中播放视频而无需代码:

  1. 创建一个 ScreenGui,如 屏幕 UI 容器 中所述,或创建一个 SurfaceGuiBillboardGui,如 体验内 UI 容器 中所述。

  2. 工具箱资产管理器 中插入一个视频。会为该视频插入一个新的 VideoFrame 对象。

  3. VideoFrame 作为子节点添加到容器中。

  4. 选择新的 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 = true
screenPart.Parent = Workspace
local surfaceGui = Instance.new("SurfaceGui")
surfaceGui.Parent = screenPart
local videoFrame = Instance.new("VideoFrame")
videoFrame.Size = UDim2.new(1, 0, 1, 0)
videoFrame.Parent = surfaceGui
videoFrame.Looped = true
videoFrame.Video = "rbxassetid://5608384572" -- 用您的视频资产 ID 替换
while not videoFrame.IsLoaded do
videoFrame.Loaded:Wait()
end
videoFrame:Play()
©2026 Roblox Corporation、Roblox、Roblox 标志及 Powering Imagination 是我们在美国及其他国家或地区的注册与未注册商标。