InsertService

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Non costruibile
Assistenza

InsertService è usato per inserire risorse dal sito Roblox, tipicamente la funzione LoadAsset .

Per caricare una risorsa, deve essere accessibile dal creatore dell'esperienza che la carica, che può essere un utente o un Gruppo. Se una risorsa viene caricata da un Creatorediverso, i dati dell'asset non saranno accessibili. Vedi il metodo LoadAsset() per ulteriori dettagli su questo controllo di sicurezza

Vedi anche

  • AssetService , che può fornire informazioni sui risorse che potresti voler caricare usando InsertService

Sommario

Metodi

Proprietà

AllowClientInsertModels

Non programmabile
Lettura Parallela

Metodi

CreateMeshPartAsync

Resa

Crea un nuovo MeshPart con CollisionFidelity e RenderFidelity . Poiché 1> Class.MeshPart.MeshId1> è letto solo, questo è il modo in

Parametri

meshId: ContentId

ID risorsa mesh.


Restituzioni

Nuova MeshPart esempio.

GetFreeDecals

Resa

La funzione GetFreeDecals recupera un elenco di Decals gratuiti dal catalogo. Il tipo di restituzione per questo metodo è molto strano, poiché restituisce una singola tabella avvolta in una tabella.

Il modo migliore per spiegare è mostrare una visual dell' array restituito:


[1] = {
CurrentStartIndex = 1, -- Questo può variare a seconda della pagina che inserisci.
TotalCount = 21, -- Sempre 21.
Results = {
-- Tutti i parametri qui sono pseudo. Possono variare a seconda della risorsa.
[1] = {
Name = "Asset Name",
AssetId = 0000000,
AssetVersionId = 0000000,
CreatorName = "Roblox",
},
-- [2], [3], e così via... fino a [21]
},
}

Un esempio per itérare su questa lista è stato fornito nella parte inferiore di questa pagina.

Inoltre, se vuoi inserire Models invece, puoi utilizzare la funzione InsertService:GetFreeModels().

Nota: L'argomento della pagina inizia con 0. Quindi la pagina 1 = 0, la pagina 2 = 1, ecc.

Parametri

searchText: string

Stringa utilizzata per cercare adesivi gratuiti nel catalogo.

pageNum: number

Il numero di pagina nel catalogo per Riportare.


Restituzioni

Una singola tabella (di adesivi gratuiti restituiti) avvolta in una tabella.

Campioni di codice

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

Resa

La funzione GetFreeModels recupera un elenco di Models gratuiti dal catalogo. Il tipo di restituzione per questo metodo è molto strano, poiché restituisce una singola tabella avvolta in una tabella.

Il modo migliore per spiegare è mostrare una visual dell' array restituito:


[1] = {
CurrentStartIndex = 1, -- Questo può variare a seconda della pagina che inserisci.
TotalCount = 21, -- Sempre 21.
Results = {
-- Tutti i parametri qui sono pseudo. Possono variare a seconda della risorsa.
[1] = {
Name = "Asset Name",
AssetId = 0000000,
AssetVersionId = 0000000,
CreatorName = "Roblox",
}
-- [2], [3], e così via... fino a [21]
}
}

Un esempio per itérare su questa lista è stato fornito nella parte inferiore di questa pagina.

Inoltre, se desideri inserire gratuiti Decals , puoi utilizzare la funzione InsertService:GetFreeDecals() .

Parametri

searchText: string

Stringa utilizzata per cercare adesivi gratuiti nel catalogo.

pageNum: number

Il numero di pagina nel catalogo per Riportare.


Restituzioni

Una singola tabella (di modelli gratuiti restituiti) avvolta in una tabella.

Campioni di codice

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

Resa

Restituisce l'ultimo AssetVersionId di una risorsa per le risorse create dal Creatoredel luogo. Può essere utilizzato in combinazione con InsertService:LoadAssetVersion() per caricare la versione più recente di un modello, anche se viene aggiornato mentre il gioco viene eseguito.

Parametri

assetId: number

Restituzioni

LoadAsset

Resa

La funzione LoadAsset recupera un risorsa dal suo ID e restituisce un Model contenente la risorsa. Ad esempio, per caricare questo pubblico DogeModel , che ha l'ID della risorsa 1>2> 257489726 2> >1> , puoi usare:


local assetId = 257489726
local InsertService = game:GetService("InsertService")
local model = InsertService:LoadAsset(assetId)
model.Parent = workspace

Le chiamate a questa funzione possono fallire se un server che fornisce un modello sta avendo problemi. Come tale, è generalmente una buona idea avvolgere le chiamate a questa funzione in pcall per catturare questi tipi di errori.


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

Controllo di sicurezza

Una risorsa caricata da questa funzione deve essere creata o di proprietà da uno qualsiasi del creatore del gioco o Roblox. Inoltre, i tipi di risorse benigne come t-shirt, magliette, pantaloni e accessori per l'avatar sono caricabili da qualsiasi gioco poiché sono pubblici.

Vedi anche:

Parametri

assetId: number

L'ID risorsa dell'asset che viene caricato.


Restituzioni

Un'istanza risorsa caricata.

Campioni di codice

InsertService:LoadAsset

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

LoadAssetVersion

Resa

Restituisce un modello inserito in InsertService contenente la risorsa con la versione risorsa specificata.

Parametri

assetVersionId: number

Restituzioni

Campioni di codice

InsertService:LoadAssetVersion

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

Eventi