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 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

Metodi

Proprietà

AllowClientInsertModels

Non programmabile
Lettura Parallela

Metodi

CreateMeshPartAsync

Resa

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

meshId: ContentId

ID del risorsa mesh.

Valore predefinito: ""
collisionFidelity: Enum.CollisionFidelity
Valore predefinito: ""
renderFidelity: Enum.RenderFidelity
Valore predefinito: ""

Restituzioni

Nuova esempio.

GetFreeDecals

Resa

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

searchText: string

Stringa utilizzata per cercare immagini gratuite nel catalogo.

Valore predefinito: ""
pageNum: number

Il numero di pagina nel Catalogo da Riportare.

Valore predefinito: ""

Restituzioni

Un singolo tavolo (di ritagli gratuiti restituiti) avvolto in un tavolo.

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 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

searchText: string

Stringa utilizzata per cercare immagini gratuite nel catalogo.

Valore predefinito: ""
pageNum: number

Il numero di pagina nel Catalogo da Riportare.

Valore predefinito: ""

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 l'ultima versione di un modello, anche se viene aggiornato mentre il gioco è in esecuzione.

Parametri

assetId: number
Valore predefinito: ""

Restituzioni

LoadAsset

Resa

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 = 257489726
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 questo tipo di errori.


local InsertService = game:GetService("InsertService")
local Workspace = game:GetService("Workspace")
local assetId = 257489726
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

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:

Parametri

assetId: number

L'ID risorsa dell'elemento caricato.

Valore predefinito: ""

Restituzioni

Un'istanza della 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 l'asset con l'assetVersionId specificato.

Parametri

assetVersionId: number
Valore predefinito: ""

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