Informacje o wersji
Edukacja
Klasa silnika
ContentProvider
Brak możliwości tworzenia
Usługa
Bez replikacji

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.


Podsumowanie
Metody
Preload(contentId: ContentId):()
Przestarzałe
PreloadAsync(contentIdList: {any},callbackFunction: function):()
RegisterEncryptedAsset(assetId: ContentId,encryptionKey: string):()
RegisterSessionEncryptedAsset(contentId: ContentId,sessionKey: string):()
UnregisterEncryptedAsset(assetId: ContentId):()
Zdarzenia
AssetFetchFailed(assetId: ContentId):RBXScriptSignal
Członkowie odziedziczeni
Przykłady kodu
ContentProvider
local ContentProvider = game:GetService("ContentProvider")
local LOGO_ID = "rbxassetid://658743164"
local PAGE_TURN_ID = "rbxassetid://12222076"
local decal = Instance.new("Decal")
decal.ColorMapContent = Content.fromUri(LOGO_ID)
local sound = Instance.new("Sound")
sound.SoundId = PAGE_TURN_ID
local assets = { decal, sound }
ContentProvider:PreloadAsync(assets)
print("Wszystkie zasoby załadowane.")

Materiały referencyjne dotyczące interfejsów API
Właściwości
BaseUrl
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: AssetManagement
ContentProvider.BaseUrl:string

RequestQueueSize
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: AssetManagement
ContentProvider.RequestQueueSize:number
Przykłady kodu
Pasek ładowania ContentProvider
local ContentProvider = game:GetService("ContentProvider")
local Players = game:GetService("Players")
local localPlayer = Players.LocalPlayer
local playerGui = localPlayer:WaitForChild("PlayerGui")
local screenGui = Instance.new("ScreenGui")
screenGui.Parent = playerGui
-- utwórz podstawowy pasek ładowania
local frame = Instance.new("Frame")
frame.Size = UDim2.new(0.5, 0, 0.1, 0)
frame.Position = UDim2.new(0.5, 0, 0.5, 0)
frame.AnchorPoint = Vector2.new(0.5, 0.5)
frame.Parent = screenGui
local bar = Instance.new("Frame")
bar.Size = UDim2.new(0, 0, 1, 0)
bar.Position = UDim2.new(0, 0, 0, 0)
bar.BackgroundColor3 = Color3.new(0, 0, 1)
bar.Parent = frame
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
local sound2 = Instance.new("Sound")
sound2.SoundId = "rbxassetid://9120385974"
local assets = {
sound,
sound2,
}
task.wait(3)
for i = 1, #assets do
local asset = assets[i]
ContentProvider:PreloadAsync({ asset }) -- 1 na raz, wstrzymuje
local progress = i / #assets
bar.Size = UDim2.new(progress, 0, 1, 0)
end
print("ładowanie zakończone")

Metody
GetAssetFetchStatus
Możliwości: AssetManagement
ContentProvider:GetAssetFetchStatus(contentId:ContentId):Enum.AssetFetchStatus
Parametry
contentId:ContentId
Przykłady kodu
Monitorowanie StatusuPobieraniaAktywu
local ContentProvider = game:GetService("ContentProvider")
-- Przykładowy aktyw do załadowania
local ASSET_ID = "rbxassetid://9120386436"
local exampleAsset = Instance.new("Sound")
exampleAsset.SoundId = ASSET_ID
-- Wyjście aktualnego StatusuPobieraniaAktywu aktywu
local initialAssetFetchStatus = ContentProvider:GetAssetFetchStatus(ASSET_ID)
print("Początkowy StatusPobieraniaAktywu:", initialAssetFetchStatus)
-- Nasłuchuj aktualizacji
local assetFetchStatusChangedSignal = ContentProvider:GetAssetFetchStatusChangedSignal(ASSET_ID)
local function onAssetFetchStatusChanged(newAssetFetchStatus: Enum.AssetFetchStatus)
print(`Nowy StatusPobieraniaAktywu: {newAssetFetchStatus}`)
end
assetFetchStatusChangedSignal:Connect(onAssetFetchStatusChanged)
-- Wyzwól aktyw do wstępnego ładowania
local function onAssetRequestComplete(contentId: string, assetFetchStatus: Enum.AssetFetchStatus)
print(`Status wstępnego ładowania {contentId}: {assetFetchStatus.Name}`)
end
ContentProvider:PreloadAsync({ exampleAsset }, onAssetRequestComplete)

GetAssetFetchStatusChangedSignal
Możliwości: AssetManagement
ContentProvider:GetAssetFetchStatusChangedSignal(contentId:ContentId):RBXScriptSignal
Parametry
contentId:ContentId
Przykłady kodu
Monitorowanie StatusuPobieraniaAktywu
local ContentProvider = game:GetService("ContentProvider")
-- Przykładowy aktyw do załadowania
local ASSET_ID = "rbxassetid://9120386436"
local exampleAsset = Instance.new("Sound")
exampleAsset.SoundId = ASSET_ID
-- Wyjście aktualnego StatusuPobieraniaAktywu aktywu
local initialAssetFetchStatus = ContentProvider:GetAssetFetchStatus(ASSET_ID)
print("Początkowy StatusPobieraniaAktywu:", initialAssetFetchStatus)
-- Nasłuchuj aktualizacji
local assetFetchStatusChangedSignal = ContentProvider:GetAssetFetchStatusChangedSignal(ASSET_ID)
local function onAssetFetchStatusChanged(newAssetFetchStatus: Enum.AssetFetchStatus)
print(`Nowy StatusPobieraniaAktywu: {newAssetFetchStatus}`)
end
assetFetchStatusChangedSignal:Connect(onAssetFetchStatusChanged)
-- Wyzwól aktyw do wstępnego ładowania
local function onAssetRequestComplete(contentId: string, assetFetchStatus: Enum.AssetFetchStatus)
print(`Status wstępnego ładowania {contentId}: {assetFetchStatus.Name}`)
end
ContentProvider:PreloadAsync({ exampleAsset }, onAssetRequestComplete)

ListEncryptedAssets
Możliwości: AssetManagement
ContentProvider:ListEncryptedAssets():{any}
Zwroty

Preload
Przestarzałe

PreloadAsync
Wynik
Możliwości: AssetManagement
ContentProvider:PreloadAsync(
contentIdList:{any}, callbackFunction:function
):()
Parametry
contentIdList:{any}
callbackFunction:function
Wartość domyślna: "nil"
Zwroty
()
Przykłady kodu
Wstępne ładowanie zasobów
local ContentProvider = game:GetService("ContentProvider")
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
local decal = Instance.new("Decal")
decal.ColorMapContent = Content.fromUri("rbxassetid://5447528495")
local assets = {
decal,
sound,
}
-- To będzie wywołane, gdy każdy zasób zostanie rozwiązany
local callback = function(assetId, assetFetchStatus)
print("PreloadAsync() rozwiązał identyfikator zasobu:", assetId)
print("PreloadAsync() końcowy AssetFetchStatus:", assetFetchStatus)
end
-- Wstępne załadowanie treści i pomiar czasu
local startTime = os.clock()
ContentProvider:PreloadAsync(assets, callback)
local deltaTime = os.clock() - startTime
print(("Wstępne ładowanie zakończone, zajęło %.2f sekundy"):format(deltaTime))

RegisterDefaultEncryptionKey
Możliwości: AssetManagement
ContentProvider:RegisterDefaultEncryptionKey(encryptionKey:string):()
Parametry
encryptionKey:string
Zwroty
()

RegisterDefaultSessionKey
Możliwości: AssetManagement
ContentProvider:RegisterDefaultSessionKey(sessionKey:string):()
Parametry
sessionKey:string
Zwroty
()

RegisterEncryptedAsset
Możliwości: AssetManagement
ContentProvider:RegisterEncryptedAsset(
assetId:ContentId, encryptionKey:string
):()
Parametry
assetId:ContentId
encryptionKey:string
Zwroty
()

RegisterSessionEncryptedAsset
Możliwości: AssetManagement
ContentProvider:RegisterSessionEncryptedAsset(
contentId:ContentId, sessionKey:string
):()
Parametry
contentId:ContentId
sessionKey:string
Zwroty
()

UnregisterDefaultEncryptionKey
Możliwości: AssetManagement
ContentProvider:UnregisterDefaultEncryptionKey():()
Zwroty
()

UnregisterEncryptedAsset
Możliwości: AssetManagement
ContentProvider:UnregisterEncryptedAsset(assetId:ContentId):()
Parametry
assetId:ContentId
Zwroty
()

Zdarzenia
AssetFetchFailed
Możliwości: AssetManagement
ContentProvider.AssetFetchFailed(assetId:ContentId):RBXScriptSignal
Parametry
assetId:ContentId

©2026 Roblox Corporation. Nazwa Roblox, logo Roblox oraz hasło „Powering Imagination” należą do naszych zarejestrowanych i niezarejestrowanych znaków towarowych na terenie Stanów Zjednoczonych oraz w innych krajach.