InsertService

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Nicht erstellbar
Dienst

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

Methoden

Eigenschaften

AllowClientInsertModels

Nicht skriptfähig
Parallel lesen

Methoden

CreateMeshPartAsync

Angehalten

Erstellt einen neuen MeshPart mit angegebenem CollisionFidelity und RenderFidelity. Da 1> Class.MeshPart.MeshId1> ist nur read-only, ist dies der Weg

Parameter

meshId: ContentId

Mesh-Asset-ID.


Rückgaben

Neue MeshPart Instanz.

GetFreeDecals

Angehalten

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

searchText: string

String, der verwendet wird, um nach kostenlosen Aufklebern im Katalog zu suchen.

pageNum: number

Die Seitenummer im Katalog, um die zurückgeben.


Rückgaben

Eine einzelne Tabelle (von zurückgegebenen freien Aufklebern) in einer Tabelle.

Code-Beispiele

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

Angehalten

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

searchText: string

String, der verwendet wird, um nach kostenlosen Aufklebern im Katalog zu suchen.

pageNum: number

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

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

Angehalten

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

assetId: number

Rückgaben

LoadAsset

Angehalten

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 = 257489726
local 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 = 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

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:

Parameter

assetId: number

Die Asset-ID des zu laden Assets.


Rückgaben

Eine Instanz der geladenen Objekt.

Code-Beispiele

InsertService:LoadAsset

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

LoadAssetVersion

Angehalten

Gibt ein modell zurück, das in InsertService mit der asseTEM-Version angegeben ist.

Parameter

assetVersionId: number

Rückgaben

Code-Beispiele

InsertService:LoadAssetVersion

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

Ereignisse