InsertService

Mostrar obsoleto

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

No creable
Servicio

Se usa el servicio de inserción para insertar recursos del sitio web de Roblox, generalmente la función LoadAsset.

Para cargar un recurso, debe ser accesible por el creador de la experiencia que lo carga, que puede ser un usuario o un grupo.Si una experiencia se sube por un creador diferente, los datos del activo no serían accesibles.Vea el método LoadAsset() para más detalles sobre esta verificar, comprobarde seguridad.Tenga en cuenta que no debe usar este servicio para cargar claves de API u otros secretos.Usa HttpService:GetSecret() en su lugar.

Ver también

  • AssetService , que puede proporcionar información sobre activos que quizás desees cargar usando el servicio de inserción

Resumen

Métodos

Propiedades

AllowClientInsertModels

No programable
Leer paralelo

Métodos

CreateMeshPartAsync

Proporciona

Crea un nuevo MeshPart con el especificado CollisionFidelity y RenderFidelity.Debido a que MeshPart.MeshId es solo de lectura, esta es la manera de crear un MeshPart a través de scripts sin tener que clonar uno existente.Lanza errores si la creación falla.

Parámetros

meshId: ContentId

ID de activo de malla.

Valor predeterminado: ""
collisionFidelity: Enum.CollisionFidelity
Valor predeterminado: ""
renderFidelity: Enum.RenderFidelity
Valor predeterminado: ""

Devuelve

Nueva instancia MeshPart nueva.

GetFreeDecals

Proporciona

La función GetFreeDecals recupera una lista de imágenes gratuitas Decals del catálogo.El tipo de devolución para este método es muy extraño, ya que devuelve una sola tabla envuelta en una tabla.

La mejor manera de explicarlo es mostrar una visualización del array devuelto:


[1] = {
CurrentStartIndex = 1, -- Esto puede variar dependiendo de la página que ingrese.
TotalCount = 21, -- Siempre 21.
Results = {
-- Todos los parámetros aquí son pseudo. Pueden variar dependiendo del activo.
[1] = {
Name = "Asset Name",
AssetId = 0000000,
AssetVersionId = 0000000,
CreatorName = "Roblox",
},
-- [2], [3], y así sucesivamente... hasta [21]
},
}

Se ha proporcionado un ejemplo para iterar sobre esta lista en la parte inferior de esta página.

Además, si quieres insertar Models en lugar, puedes usar la función InsertService:GetFreeModels().

Nota: El argumento de página comienza en 0. Por lo tanto, la página 1 = 0, la página 2 = 1, etc.

Parámetros

searchText: string

Texto utilizado para buscar imágenes gratuitas en el catálogo.

Valor predeterminado: ""
pageNum: number

El número de página en el catálogo para devolver.

Valor predeterminado: ""

Devuelve

Una tabla única (de calcomanías gratuitas devueltas) envuelta en una tabla.

Muestras de código

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

Proporciona

La función GetFreeModels recupera una lista de modelos gratuitos Models del catálogo.El tipo de devolución para este método es muy extraño, ya que devuelve una sola tabla envuelta en una tabla.

La mejor manera de explicarlo es mostrar una visualización del array devuelto:


[1] = {
CurrentStartIndex = 1, -- Esto puede variar dependiendo de la página que ingrese.
TotalCount = 21, -- Siempre 21.
Results = {
-- Todos los parámetros aquí son pseudo. Pueden variar dependiendo del activo.
[1] = {
Name = "Asset Name",
AssetId = 0000000,
AssetVersionId = 0000000,
CreatorName = "Roblox",
}
-- [2], [3], y así sucesivamente... hasta [21]
}
}

Se ha proporcionado un ejemplo para iterar sobre esta lista en la parte inferior de esta página.

Además, si desea insertar Decals, puede usar la función InsertService:GetFreeDecals().

Parámetros

searchText: string

Texto utilizado para buscar imágenes gratuitas en el catálogo.

Valor predeterminado: ""
pageNum: number

El número de página en el catálogo para devolver.

Valor predeterminado: ""

Devuelve

Una tabla única (de modelos gratuitos devueltos) envuelta en una tabla.

Muestras de código

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

Proporciona

Devuelve la última versión de AssetVersionId de un activo para los activos creados por el creador del lugar.Se puede utilizar en combinación con InsertService:LoadAssetVersion() para cargar la última versión de un aplicación de modelado, incluso si se actualiza mientras se ejecuta el juego.

Parámetros

assetId: number
Valor predeterminado: ""

Devuelve

LoadAsset

Proporciona

La función LoadAsset recupera un activo dado su ID y devuelve un Model que contiene el recurso.Por ejemplo, para cargar este perro público DogeModel , que tiene el ID de activo *257489726 * , puedes usar:


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

Las llamadas a esta función pueden fallar si un servidor que proporciona un modelo tiene problemas.Como tal, generalmente es una buena idea envolver las llamadas a esta función en pcall para capturar este tipo de errores.


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

Control de seguridad

Un recurso cargado por esta función debe ser creado o propiedad de por el creador del juego o Roblox.Además, los tipos de activos benignos como camisetas, camisas, pantalones y accesorios de avatar se pueden cargar de cualquier juego ya que son públicos.

Vea también:

Parámetros

assetId: number

El ID del activo del activo que se está cargando.

Valor predeterminado: ""

Devuelve

Una instancia del activo recurso.

Muestras de código

InsertService:LoadAsset

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

LoadAssetVersion

Proporciona

Devuelve un modelo insertado en InsertService que contiene el activo con el ID de activo dado.

Parámetros

assetVersionId: number
Valor predeterminado: ""

Devuelve

Muestras de código

InsertService:LoadAssetVersion

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

Eventos