用于 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 = 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()