InsertService

Pokaż przestarzałe

*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.

Brak możliwości tworzenia
Usługa

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

Metody

Właściwości

AllowClientInsertModels

Brak możliwości dodawania do skryptu
Odczyt równoległy

Metody

CreateMeshPartAsync

Wynik

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

meshId: ContentId

ID zasobu siatki.

Wartość domyślna: ""
collisionFidelity: Enum.CollisionFidelity
Wartość domyślna: ""
renderFidelity: Enum.RenderFidelity
Wartość domyślna: ""

Zwroty

Nowa instancja MeshPart.

GetFreeDecals

Wynik

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

searchText: string

Sznurek używany do wyszukiwania darmowych naklejek w Katalog.

Wartość domyślna: ""
pageNum: number

Numer strony w katalogu do zwrotu.

Wartość domyślna: ""

Zwroty

Jedna tabela (powracające darmowe nadruki) owinięta w tabelę.

Przykłady kodu

InsertService:GetFreeDecals

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

Wynik

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

searchText: string

Sznurek używany do wyszukiwania darmowych naklejek w Katalog.

Wartość domyślna: ""
pageNum: number

Numer strony w katalogu do zwrotu.

Wartość domyślna: ""

Zwroty

Jedna tabela (powracające wolne modele) owinięta w tabelę.

Przykłady kodu

InsertService:GetFreeModels

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

Wynik

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

assetId: number
Wartość domyślna: ""

Zwroty

LoadAsset

Wynik

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 = 257489726
local 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 = 257489726
local success, model = pcall(InsertService.LoadAsset, InsertService, assetId)
if success and model then
print("Model loaded successfully")
model.Parent = Workspace
else
print("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:

Parametry

assetId: number

ID zasobu zasobu ładowanego.

Wartość domyślna: ""

Zwroty

Instancja załadowanego zasobu.

Przykłady kodu

InsertService:LoadAsset

local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace

LoadAssetVersion

Wynik

Zwraca model wstawiony do InsertService zawierający zasób z danym ID zasobu.

Parametry

assetVersionId: number
Wartość domyślna: ""

Zwroty

Przykłady kodu

InsertService:LoadAssetVersion

local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace

Zdarzenia