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

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ż 1> Class.MeshPart.MeshId1> jest czytany t

Parametry

meshId: ContentId

ID sieci.


Zwroty

Nowa instancja MeshPart.

GetFreeDecals

Wynik

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

searchText: string

Strona używana do wyszukiwania darmowych naklejek w Katalog.

pageNum: number

Numer strony w katalogu do powrotu.


Zwroty

Jedna tabela (zwróconych darmowych naklejek) zapakowana 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. 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

searchText: string

Strona używana do wyszukiwania darmowych naklejek w Katalog.

pageNum: number

Numer strony w katalogu do powrotu.


Zwroty

Jedna tabela (zwróconych darmowych modeli) zapakowana 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

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

assetId: number

Zwroty

LoadAsset

Wynik

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 = 257489726
local 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 = 257489726
local InsertService = game:GetService("InsertService")
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

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ż:

Parametry

assetId: number

Identyfikator zasobu ładowanego.


Zwroty

Instancja zasobu załadowanego.

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

Wróщает model w InsertService, zawierający zasób z określonym ID zasobu.

Parametry

assetVersionId: number

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