InsertService
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
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
Proprietà
Metodi
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
Crea una nuova MeshPart con valori di fedeltà specificati.
Recupera un elenco di Adesivi gratuiti dal catalogo.
Recupera un elenco di Modelli Gratuiti dal catalogo.
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.
Restituisce un Model contenente la risorsa.
Restituisce un modello inserito in InsertService contenente la risorsa con la versione risorsa specificata.
Proprietà
AllowClientInsertModels
Metodi
CreateMeshPartAsync
Crea un nuovo MeshPart con CollisionFidelity e RenderFidelity . Poiché 1> Class.MeshPart.MeshId1> è letto solo, questo è il modo in
Parametri
ID risorsa mesh.
Imposta MeshPart.CollisionFidelity .
Imposta MeshPart.RenderFidelity .
Restituzioni
GetFreeDecals
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
Stringa utilizzata per cercare adesivi gratuiti nel catalogo.
Il numero di pagina nel catalogo per Riportare.
Restituzioni
Una singola tabella (di adesivi gratuiti restituiti) avvolta in una tabella.
Campioni di codice
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
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
Stringa utilizzata per cercare adesivi gratuiti nel catalogo.
Il numero di pagina nel catalogo per Riportare.
Restituzioni
Una singola tabella (di modelli gratuiti restituiti) avvolta in una tabella.
Campioni di codice
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
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
Restituzioni
LoadAsset
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 = 257489726local 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 = 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
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:
- AssetService:GetBundleDetailsAsync() , per sapere quali risorse sono associati a un pacchetto.
- Per i plugin, vedi DataModel:GetObjects()
Parametri
L'ID risorsa dell'asset che viene caricato.
Restituzioni
Un'istanza risorsa caricata.
Campioni di codice
local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace
LoadAssetVersion
Restituisce un modello inserito in InsertService contenente la risorsa con la versione risorsa specificata.
Parametri
Restituzioni
Campioni di codice
local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace