InsertService
*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.
InsertService jest używany do wstawiania zasobów z witryny Roblox, zwykle funkcji LoadAsset.
Aby załadować zasób, musi być on dostępny dla twórcy doświadczenia, który go ładował, który może być użytkownikiem lub grupa.Jeśli doświadczenie zostanie przesłane przez innego twórca, dane o zasobie nie będą dostępne.Zobacz metodę LoadAsset() na więcej szczegółów na temat tego sprawdzaćbezpieczeństwa.Zwróć uwagę, że nie powinieneś nie używać tej usługi do ładowania kluczy API lub innych sekretów.Użyj HttpService:GetSecret() zamiast.
Zobacz także
- AssetService , który może dostarczyć informacje o zasobach, które możesz chcieć załadować za pomocą usługi Wstawiania
Podsumowanie
Właściwości
Metody
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
Tworzy nową MeshPart z określonymi wartościami wierności.
Zwraca listę darmowych dekalii z Katalog.
Zwraca listę wolnych modeli z Katalog.
Zwraca najnowszą wersję ID zasobu dla zasobów stworzonych przez twórcamiejsca.Można go używać w połączeniu z InsertService:LoadAssetVersion(), aby załadować najnowszą wersję modelu, nawet jeśli zostanie ona zaktualizowana podczas uruchamiania gry.
Zwraca Model zawierający zasób.
Zwraca model wstawiony do InsertService zawierający zasób z danym ID zasobu.
Właściwości
AllowClientInsertModels
Metody
CreateMeshPartAsync
Tworzy nowy MeshPart z określonym CollisionFidelity i RenderFidelity.Ponieważ MeshPart.MeshId jest tylko odczytywany, jest to sposób na stworzenie MeshPart za pomocą skryptów bez konieczności klonowania istniejącego.Wystawia błędy, jeśli tworzenie nie powiedzie się.
Parametry
ID zasobu siatki.
Ustaw MeshPart.CollisionFidelity.
Ustaw MeshPart.RenderFidelity.
Zwroty
GetFreeDecals
Funkcja GetFreeDecals odzyskuje listę darmowych Decals z Katalog.Typ zwrotu dla tej metody jest bardzo dziwny, ponieważ zwraca pojedynczą tabelę owiniętą w tabelę.
Najlepszym sposobem na wyjaśnienie tego jest pokazanie wizualizacji zwrotzonej matrycy:
[1] = {CurrentStartIndex = 1, -- Może to się różnić w zależności od strony, którą wpiszesz.TotalCount = 21, -- Zawsze 21.Results = {-- Wszystkie parametry tutaj są udane. Mogą się one różnić w zależności od aktywa.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",},-- [2], [3], i tak dalej... do [21]},}
Przykład iterowania nad tą listą został umieszczony na dole tej strony.
Ponadto, jeśli chcesz wstawić Models zamiast tego, możesz użyć funkcji InsertService:GetFreeModels().
Uwaga: Argument strony zaczyna się od 0. Więc strona 1 = 0, strona 2 = 1 itd.
Parametry
Sznurek używany do wyszukiwania darmowych naklejek w Katalog.
Numer strony w katalogu do zwrotu.
Zwroty
Jedna tabela (powracające darmowe nadruki) owinięta w tabelę.
Przykłady kodu
local InsertService = game:GetService("InsertService")
local page = unpack(InsertService:GetFreeDecals("Cats", 0)) -- Search for "Cats" on Page 1.
for i = 1, page.TotalCount do
local item = page.Results[i]
print("Item #" .. i)
for key, value in pairs(item) do
print(" " .. key .. ": " .. value)
end
end
GetFreeModels
Funkcja GetFreeModels odzyskuje listę Darmowych Models z Katalog.Typ zwrotu dla tej metody jest bardzo dziwny, ponieważ zwraca pojedynczą tabelę owiniętą w tabelę.
Najlepszym sposobem na wyjaśnienie tego jest pokazanie wizualizacji zwrotzonej matrycy:
[1] = {CurrentStartIndex = 1, -- Może to się różnić w zależności od strony, którą wpiszesz.TotalCount = 21, -- Zawsze 21.Results = {-- Wszystkie parametry tutaj są udane. Mogą się one różnić w zależności od aktywa.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",}-- [2], [3], i tak dalej... do [21]}}
Przykład iterowania nad tą listą został umieszczony na dole tej strony.
Ponadto, jeśli chcesz wstawić darmowe Decals, możesz użyć funkcji InsertService:GetFreeDecals().
Parametry
Sznurek używany do wyszukiwania darmowych naklejek w Katalog.
Numer strony w katalogu do zwrotu.
Zwroty
Jedna tabela (powracające wolne modele) owinięta w tabelę.
Przykłady kodu
local InsertService = game:GetService("InsertService")
local page = unpack(InsertService:GetFreeModels("Cats", 0)) -- Search for "Cats" on Page 1.
for i = 1, page.TotalCount do
local item = page.Results[i]
print("Item #" .. i)
for key, value in pairs(item) do
print(" " .. key .. ": " .. value)
end
end
GetLatestAssetVersionAsync
Zwraca najnowszą wersję ID zasobu dla zasobów stworzonych przez twórcamiejsca.Można go używać w połączeniu z InsertService:LoadAssetVersion(), aby załadować najnowszą wersję modelu, nawet jeśli zostanie ona zaktualizowana podczas uruchamiania gry.
Parametry
Zwroty
LoadAsset
Funkcja LoadAsset pobiera zasób podany jego ID i zwraca Model zawierający zasób.Na przykład, aby załadować tę publiczną DogeModel, która ma ID zasobu *257489726 * , możesz użyć:
local InsertService = game:GetService("InsertService")local Workspace = game:GetService("Workspace")local assetId = 257489726local model = InsertService:LoadAsset(assetId)model.Parent = Workspace
Wezwania do tej funkcji mogą zawieść, jeśli serwer dostarczający model ma problemy.W związku z tym ogólnie dobrym pomysłem jest owijanie wezwań do tej funkcji w pcall w celu złapania tego rodzaju błędów.
local InsertService = game:GetService("InsertService")local Workspace = game:GetService("Workspace")local assetId = 257489726local success, model = pcall(InsertService.LoadAsset, InsertService, assetId)if success and model thenprint("Model loaded successfully")model.Parent = Workspaceelseprint("Model failed to load!")end
Kontrola bezpieczeństwa
Zasób załadowany przez tę funkcję musi być stworzony lub posiadany przez twórcę gry lub Roblox.Ponadto bezpieczne typy zasobów, takie jak koszulki, koszule, spodnie i akcesoria do awatara, można ładować z dowolnej gry, ponieważ są one publiczne.
Zobacz także:
- AssetService:GetBundleDetailsAsync() , aby dowiedzieć się, które zasoby są powiązane z pakietem.
- Dla pluginów, patrz DataModel:GetObjects()
Parametry
ID zasobu zasobu ładowanego.
Zwroty
Instancja załadowanego zasobu.
Przykłady kodu
local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace
LoadAssetVersion
Zwraca model wstawiony do InsertService zawierający zasób z danym ID zasobu.
Parametry
Zwroty
Przykłady kodu
local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace