用於 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()