InsertService
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
InsertService viene utilizzato per inserire risorse dal sito Web di 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 un'esperienza venisse caricata da un Creatorediverso, i dati delle risorse non sarebbero accessibili.Vedi il metodo LoadAsset() per maggiori dettagli su questo Controllare /Verificaredi sicurezza.Nota che non dovresti utilizzare questo servizio per caricare le chiavi API o altri segreti.Usa HttpService:GetSecret() invece.
Vedi anche
- AssetService , che può fornire informazioni su risorse che potresti voler caricare utilizzando InsertService
Sommario
Proprietà
Metodi
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
Crea una nuova MeshPart con i 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 l'ultima versione di un modello, anche se viene aggiornato mentre il gioco è in esecuzione.
Restituisce un Model contenente la risorsa.
Restituisce un modello inserito in InsertService contenente l'asset con l'assetVersionId specificato.
Proprietà
AllowClientInsertModels
Metodi
CreateMeshPartAsync
Crea un nuovo MeshPart con specificato CollisionFidelity e RenderFidelity .Poiché MeshPart.MeshId è solo in lettura, questa è la modalità per creare un MeshPart attraverso gli script senza dover clonare uno esistente.Lancia errori se la creazione fallisce.
Parametri
ID del risorsa mesh.
Imposta MeshPart.CollisionFidelity.
Imposta MeshPart.RenderFidelity.
Restituzioni
Nuova esempio.
GetFreeDecals
La funzione GetFreeDecals recupera un elenco di gratis Decals dal catalogo.Il tipo di restituzione di questo metodo è molto strano, poiché restituisce una singola tabella avvolta in una tabella.
Il modo migliore per spiegarlo è mostrare una visuale 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 l'iterazione su questa lista è stato fornito in fondo a questa pagina.
Inoltre, se vuoi inserire Models invece, puoi usare la funzione InsertService:GetFreeModels().
Nota: L'argomento pagina inizia a 0. Quindi pagina 1 = 0, pagina 2 = 1, ecc.
Parametri
Stringa utilizzata per cercare immagini gratuite nel catalogo.
Il numero di pagina nel Catalogo da Riportare.
Restituzioni
Un singolo tavolo (di ritagli gratuiti restituiti) avvolto in un tavolo.
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 Free Models dal catalogo.Il tipo di restituzione di questo metodo è molto strano, poiché restituisce una singola tabella avvolta in una tabella.
Il modo migliore per spiegarlo è mostrare una visuale 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 l'iterazione su questa lista è stato fornito in fondo a questa pagina.
Inoltre, se vuoi inserire gratuitamente Decals , puoi usare la funzione InsertService:GetFreeDecals().
Parametri
Stringa utilizzata per cercare immagini gratuite nel catalogo.
Il numero di pagina nel Catalogo da 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 l'ultima versione di un modello, anche se viene aggiornato mentre il gioco è in esecuzione.
Parametri
Restituzioni
LoadAsset
La funzione LoadAsset recupera un'asset data il suo ID e restituisce un Model contenente l'asset.Ad esempio, per caricare questo pubblico DogeModel , che ha l'ID risorsa *257489726 * , puoi usare:
local InsertService = game:GetService("InsertService")local Workspace = game:GetService("Workspace")local assetId = 257489726local 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 questo tipo di errori.
local InsertService = game:GetService("InsertService")local Workspace = game:GetService("Workspace")local assetId = 257489726local 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
Un'asset caricata da questa funzione deve essere creata o posseduta da either il creatore del gioco o Roblox.Inoltre, i tipi di risorsa benigni come t-shirt, camicie, pantaloni e accessori di avatar sono caricabili da qualsiasi gioco poiché sono pubblici.
Vedi anche:
- AssetService:GetBundleDetailsAsync() , per scoprire quali risorse sono associate a un pacchetto.
- Per i plugin, vedi DataModel:GetObjects()
Parametri
L'ID risorsa dell'elemento caricato.
Restituzioni
Un'istanza della 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 l'asset con l'assetVersionId specificato.
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