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 służy do wstawiania zasobów z witryny Roblox, zwykle funkcji LoadAsset.
Aby załadować zasoby, muszą one być dostępne przez twórcę doświadczenia, którego może być użytkownik lub grupa. Jeśli zasoby zostaną załadowane przez innego twórca, dane zasobów nie będą dostępne. Zobacz metodę LoadAsset()
Zobacz również
- AssetService , który może dostarczyć informacje o zasobach, które chcesz załadować za pomocąInsertService
Podsumowanie
Właściwości
Metody
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
Utwiera nowy MeshPart z określonymi wartościami fidelności.
Odzyskuje listę darmowych naklejek z Katalog.
Odzyskuje listę Darmowych Modeli z Katalogu.
Wyświetla najnowszą wersję AssetVersionId zasobu dla zasobów stworzonych przez twórcalokalnego. Można go używać w połączeniu z InsertService:LoadAssetVersion() , aby załadować najnowszą wersję modelu, nawet jeśli zostanie ona aktualizowana podczas uruchomienia gry.
Zwraca Model zawierającego zasób.
Wróщает model w InsertService, zawierający zasób z określonym ID zasobu.
Właściwości
AllowClientInsertModels
Metody
CreateMeshPartAsync
Tworzy nowy MeshPart z określonym CollisionFidelity i RenderFidelity. Ponieważ 1> Class.MeshPart.MeshId1> jest czytany t
Parametry
Zwroty
GetFreeDecals
Funkcja GetFreeDecals odzyskuje listę darmowych Decals z Katalog. Wynik zwracany dla tej metody jest bardzo dziwny, ponieważ zwraca pojedynczą tabelę zapisu w tabeli.
Najlepszym sposobem na to, aby to wyjaśnić, jest pokazanie wizualizacji zwróconej przez maszynę:
[1] = {CurrentStartIndex = 1, -- Może się to różnić w zależności od wpisanej strony.TotalCount = 21, -- Zawsze 21.Results = {-- Wszystkie parametry tutaj są pseudo. Można je zmieniać w zależności od zasobu.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",},-- [2], [3], itp. do [21]},}
Przykład dla powtarzania się nad tym listą został podany w dolnej części tej strony.
Dodatkowo, jeśli chcesz zamiast tego wstawić Models, możesz użyć funkcji InsertService:GetFreeModels().
Notatka: Arгумент strony zaczyna się od 0. Więc strona 1 = 0, strona 2 = 1 itp.
Parametry
Strona używana do wyszukiwania darmowych naklejek w Katalog.
Numer strony w katalogu do powrotu.
Zwroty
Jedna tabela (zwróconych darmowych naklejek) zapakowana 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. Wynikiem zwracanym dla tej metody jest bardzo dziwny, ponieważ zwraca pojedynczą tabelę otwartą w tabeli.
Najlepszym sposobem na to, aby to wyjaśnić, jest pokazanie wizualizacji zwróconej przez maszynę:
[1] = {CurrentStartIndex = 1, -- Może się to różnić w zależności od wpisanej strony.TotalCount = 21, -- Zawsze 21.Results = {-- Wszystkie parametry tutaj są pseudo. Można je zmieniać w zależności od zasobu.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",}-- [2], [3], itp. do [21]}}
Przykład dla powtarzania się nad tym listą został podany w dolnej części tej strony.
Dodatkowo, jeśli chcesz wstawić darmowe Decals, możesz użyć funkcji InsertService:GetFreeDecals().
Parametry
Strona używana do wyszukiwania darmowych naklejek w Katalog.
Numer strony w katalogu do powrotu.
Zwroty
Jedna tabela (zwróconych darmowych modeli) zapakowana 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
Wyświetla najnowszą wersję AssetVersionId zasobu dla zasobów stworzonych przez twórcalokalnego. Można go używać w połączeniu z InsertService:LoadAssetVersion() , aby załadować najnowszą wersję modelu, nawet jeśli zostanie ona aktualizowana podczas uruchomienia gry.
Parametry
Zwroty
LoadAsset
Funkcja LoadAsset weryfikuje zasoby podanego ich ID i w zwrotuje Model zawierające zasoby. Na przykład, aby załadować tego publicznego DogeModel, który ma ID zasobu 2>2574897262>, możesz użyć:
local assetId = 257489726local InsertService = game:GetService("InsertService")local model = InsertService:LoadAsset(assetId)model.Parent = workspace
Wezwania do tej funkcji mogą się nie powodzić, jeśli serwer dostarczający modelu ma problemy. Z tego powodu ogólnym dobrym pomysłem jest zapisanie wezwania do tej funkcji w pcall, aby złapać te rodzaje błędów.
local assetId = 257489726local InsertService = game:GetService("InsertService")local success, model = pcall(InsertService.LoadAsset, InsertService, assetId)if success and model thenprint("Model loaded successfully")model.Parent = workspaceelseprint("Model failed to load!")end
Sprawdzenie bezpieczeństwa
Przedmiot załadowany przez tę funkcję musi być stworzony lub posiadać przez grę twórcę lub Roblox. Ponadto, nieszkodliwe typy przedmiotów, takie jak koszule, koszule, spodnie i akcesoria dla awatara, można załadować z dowolnej gry, ponieważ są one publiczne.
Zobacz również:
- AssetService:GetBundleDetailsAsync() , aby dowiedzieć się, które zasoby są powiązane z pakiet.
- Dla wtyczek, zobacz DataModel:GetObjects()
Parametry
Identyfikator zasobu ładowanego.
Zwroty
Instancja zasobu załadowanego.
Przykłady kodu
local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace
LoadAssetVersion
Wróщает model w InsertService, zawierający zasób z określonym 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