InsertService

Erstellt ein neues MeshPart mit angegebenem CollisionFidelity und RenderFidelity.Da MeshPart.MeshId nur lesbar ist, ist dies der Weg, um eine MeshPart durch Skripte zu erstellen, ohne eine vorhandene zu klonen zu müssen.Es wirft Fehler, wenn die Erstellung fehlschlägt.

Parameter

Rückgaben

Die Funktion GetFreeDecals ruft eine Liste von kostenlosen Decals aus dem Katalog ab.Die Rückgabetyp für diese Methode ist sehr seltsam, da sie eine einzige Tabelle zurückgibt, die in einer Tabelle verwickelt ist.

Die beste Art, es zu erklären, ist, ein visuelles der zurückgegebenen Liste anzuzeigen:

[1] = {
	CurrentStartIndex = 1, -- Dies kann je nach der von Ihnen eingegebenen Seite variieren.
	TotalCount = 21, -- Immer 21.
	Results = {
		-- Alle Parameter hier sind pseudo. Sie können je nach Objektvariieren.
		[1] = {
			Name = "Asset Name",
			AssetId = 0000000,
			AssetVersionId = 0000000,
			CreatorName = "Roblox",
		},
		-- [2], [3], und so weiter ... bis [21]
	},
}

Ein Beispiel für die Iteration über diese Liste wurde am Ende dieser Seite bereitgestellt.

Zusätzlich, wenn du stattdessen Models einfügen möchtest, kannst du die InsertService:GetFreeModels()-Funktion verwenden.

Hinweis: Das Seitenargument beginnt bei 0. Also Seite 1 = 0, Seite 2 = 1 usw.

Parameter

Rückgaben

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

Die Funktion GetFreeModels ruft eine Liste von Free Models aus dem Katalog ab.Die Rückgabetyp für diese Methode ist sehr seltsam, da sie eine einzige Tabelle zurückgibt, die in einer Tabelle verwickelt ist.

Die beste Art, es zu erklären, ist, ein visuelles der zurückgegebenen Liste anzuzeigen:

[1] = {
	CurrentStartIndex = 1, -- Dies kann je nach der von Ihnen eingegebenen Seite variieren.
	TotalCount = 21, -- Immer 21.
	Results = {
		-- Alle Parameter hier sind pseudo. Sie können je nach Objektvariieren.
		[1] = {
			Name = "Asset Name",
			AssetId = 0000000,
			AssetVersionId = 0000000,
			CreatorName = "Roblox",
    		}
    		-- [2], [3], und so weiter ... bis [21]
    	}
}

Ein Beispiel für die Iteration über diese Liste wurde am Ende dieser Seite bereitgestellt.

Zusätzlich, wenn Sie kostenlose Decals einfügen möchten, können Sie die InsertService:GetFreeDecals() Funktion verwenden.

Parameter

Rückgaben

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

Gibt die neueste AssetVersionId eines Assets für Assets aus, die vom Creator:inerstellt wurden.Kann in Kombination mit InsertService:LoadAssetVersion() verwendet werden, um die neueste Version eines Modells zu laden, auch wenn es während des Spiels aktualisiert wird.

Parameter

Rückgaben

Die Funktion LoadAsset holt ein Asset ab, angegeben durch seine ID, und gibt ein Model zurück, das das Objektenthält.Zum Beispiel, um diese öffentliche Doge zu laden, die die Asset-ID 257489726 hat, können Sie verwenden:

local InsertService = game:GetService("InsertService")
local Workspace = game:GetService("Workspace")

local assetId = 257489726
local model = InsertService:LoadAsset(assetId)
model.Parent = Workspace

Anrufe bei dieser Funktion können fehlschlagen, wenn ein Server, der ein Modell bereitstellt, Probleme hat.Als solches ist es im Allgemeinen eine gute Idee, Anrufe an diese Funktion in pcall zu wickeln, um diese Art von Fehlern zu erfassen.

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

Sicherheitsprüfung

Ein Asset, das von dieser Funktion geladen wird, muss vom Spiel创造者 oder von Roblox erstellt oder im Besitz sein durch den Spiel创造者 oder Roblox.Zusätzlich können harmlose Asset-Typen wie T-Shirts, Hemden, Hosen und Avatar-Zubehör von jedem Spiel geladen werden, da sie öffentlich sind.

Siehe auch:

• AssetService:GetBundleDetailsAsync() , um herauszufinden, welche assets mit einem bündel verbunden sind.
• Für Plugins, siehe DataModel:GetObjects()

Parameter

Rückgaben

local InsertService = game:GetService("InsertService")

local ASSET_ID = 82353

local asset = InsertService:LoadAsset(ASSET_ID)

asset.Parent = workspace

Gibt ein Modell zurück, das in InsertService eingefügt wurde, das das Asset mit der angegebenen assetVersionId enthält.

Parameter

Rückgaben

local InsertService = game:GetService("InsertService")

local ASSET_VERSION_ID = 296050499

local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)

asset.Parent = game.Workspace