InsertService
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
InsertService wird verwendet, um Assets von der Roblox-Website einzufügen, normalerweise die LoadAsset Funktion.
Um ein Objektzu laden, muss es vom Schöpfer der Erfahrung, die es lädt, zugänglich sein, was entweder ein Benutzer oder eine Gruppe sein kann. Wenn ein Asset von einem anderen Creator:inhochgeladen wird, ist das Asset-Daten nicht zugänglich. Siehe die Methode LoadAsset() für mehr Details zu diesem
Siehe auch
- AssetService, der Informationen über Assets bieten kann, die Sie mit der Einfügung von Diensten laden möchten
Zusammenfassung
Eigenschaften
Methoden
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
Erstellt ein neues MeshPart mit angegebenen Fidelitätswerten.
Bietet eine Liste von kostenlosen Aufklebern aus dem Katalog.
Bietet eine Liste von kostenlosen Modellen aus dem Katalog.
Gibt die neueste AssetVersionId eines Assets zurück, für Assets, die vom Creator:inerstellt wurden. Kann mit InsertService:LoadAssetVersion() kombiniert werden, um die neueste Version eines Modells zu laden, auch wenn sie während der Ausführung des Spiels aktualisiert wird.
Kehrt ein Model zurück, das die Objektenthält.
Gibt ein modell zurück, das in InsertService mit der asseTEM-Version angegeben ist.
Eigenschaften
AllowClientInsertModels
Methoden
CreateMeshPartAsync
Erstellt einen neuen MeshPart mit angegebenem CollisionFidelity und RenderFidelity. Da 1> Class.MeshPart.MeshId1> ist nur read-only, ist dies der Weg
Parameter
Rückgaben
GetFreeDecals
Die GetFreeDecals-Funktion ruft eine Liste von freien Decals aus dem Katalog ab. Der Rückgabe-Typ für diese Methode ist sehr seltsam, da sie eine einzelne Tabelle in einer Tabelle zurückgibt.
Der beste Weg, um das zu erklären, ist, eine visuelle des zurückgegebenen Arrays anzuzeigen:
[1] = {CurrentStartIndex = 1, -- Dies kann je nach Seite unterschiedlich sein.TotalCount = 21, -- Immer 21.Results = {-- Alle Argumente hier sind pseudo. Sie können je nach Objektunterschiedlich sein.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",},-- [2], [3], und so weiter... bis [21]},}
Ein Beispiel für die Wiederholung über diese Liste wurde am unteren Rand dieser Seite bereitgestellt.
Darüber hinaus, wenn Sie Models stattdessen einfügen möchten, können Sie die Funktion InsertService:GetFreeModels() verwenden.
Beachte: Die Seiten argument beginnt bei 0. So Seite 1 = 0, Seite 2 = 1 usw.
Parameter
String, der verwendet wird, um nach kostenlosen Aufklebern im Katalog zu suchen.
Die Seitenummer im Katalog, um die zurückgeben.
Rückgaben
Eine einzelne Tabelle (von zurückgegebenen freien Aufklebern) in einer Tabelle.
Code-Beispiele
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
Die GetFreeModels-Funktion ruft eine Liste von Free Models aus dem Katalogab. Der Rückgabe-Typ für diese Methode ist sehr seltsam, da sie eine einzelne Tabelle in einer Tabelle zurückgibt.
Der beste Weg, um das zu erklären, ist, eine visuelle des zurückgegebenen Arrays anzuzeigen:
[1] = {CurrentStartIndex = 1, -- Dies kann je nach Seite unterschiedlich sein.TotalCount = 21, -- Immer 21.Results = {-- Alle Argumente hier sind pseudo. Sie können je nach Objektunterschiedlich sein.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",}-- [2], [3], und so weiter... bis [21]}}
Ein Beispiel für die Wiederholung über diese Liste wurde am unteren Rand dieser Seite bereitgestellt.
Darüber hinaus, wenn Sie kostenlose Decals einfügen möchten, können Sie die Funktion InsertService:GetFreeDecals() verwenden.
Parameter
String, der verwendet wird, um nach kostenlosen Aufklebern im Katalog zu suchen.
Die Seitenummer im Katalog, um die zurückgeben.
Rückgaben
Eine einzelne Tabelle (von zurückgegebenen freien Modellen), die in einer Tabelle zusammengefasst ist.
Code-Beispiele
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
Gibt die neueste AssetVersionId eines Assets zurück, für Assets, die vom Creator:inerstellt wurden. Kann mit InsertService:LoadAssetVersion() kombiniert werden, um die neueste Version eines Modells zu laden, auch wenn sie während der Ausführung des Spiels aktualisiert wird.
Parameter
Rückgaben
LoadAsset
Die LoadAsset-Funktion ruft ein Asset über seine ID auf und gibt ein Model , das das Asset enthält, zurück. Zum Beispiel, um dieses öffentliche Doge-Asset Class.Model zu laden, das die Asset-ID enthält 257489726 1> , kannst du verwenden:
local assetId = 257489726local InsertService = game:GetService("InsertService")local model = InsertService:LoadAsset(assetId)model.Parent = workspace
Aufrufe zu dieser Funktion können fehlen, wenn ein Server, der ein Modell bereitstellt, Probleme hat. Als solches ist es in der Regel eine gute Idee, Aufrufe zu dieser Funktion in pcall zu wickeln, um diese Arten von Fehlern zu erfassen.
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
Sicherheitscheck
Ein Asset, das von dieser Funktion geladen wird, muss entweder vom Spiel Creator oder Roblox erstellt oder in Besitz sein. Darüber hinaus sind benigne Asset-Typen wie T-Shirts, Hemden, Hosen und Avatar-Accessoires von jedem Spiel ladenbar, da sie öffentlich sind.
Siehe auch:
- AssetService:GetBundleDetailsAsync() , um herauszufinden, welche Assets mit einem Bündelverbunden sind.
- Für Plugins, siehe DataModel:GetObjects()
Parameter
Die Asset-ID des zu laden Assets.
Rückgaben
Eine Instanz der geladenen Objekt.
Code-Beispiele
local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace
LoadAssetVersion
Gibt ein modell zurück, das in InsertService mit der asseTEM-Version angegeben ist.
Parameter
Rückgaben
Code-Beispiele
local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace