视频帧

*此内容使用人工智能(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 是我们在美国及其他国家或地区的注册与未注册商标。