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

InsertService se usa para insertar recursos del sitio web de Roblox, generalmente la función LoadAsset .

Para cargar una recurso, debe ser accesible por el creador de la experiencia que la carga, que puede ser un usuario o un grupo. Si una experiencia se carga por un creador diferente, los datos de la experiencia no estarán accesibles. Vea el método LoadAsset() para más detalles en este cheque de seguridad. Tenga

Ver también

  • AssetService , que puede proporcionar información sobre los activos que desea cargar conInsertService

Resumen

Métodos

Propiedades

AllowClientInsertModels

No programable
Leer paralelo

Métodos

CreateMeshPartAsync

Proporciona

Crea una nueva MeshPart con CollisionFidelity y RenderFidelity especificados. Debido a que 2>Class.MeshPart2> es solo de lectura, esta es la forma de crear un 5>

Parámetros

meshId: ContentId

ID de la mesa de malla.

collisionFidelity: Enum.CollisionFidelity
renderFidelity: Enum.RenderFidelity

Devuelve

Nueva instancia de MeshPart.

GetFreeDecals

Proporciona

La función GetFreeDecals recupera una lista de calcomanías gratuitas Decals del catálogo. El tipo de regreso para este método es muy extraño, ya que regresa una sola tabla envuelta en una tabla.

La mejor manera de explicarlo es mostrar una vista del arreglo 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 cambiar 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 repetir sobre esta lista en la parte inferior de esta página.

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

Nota: El argumento de la página comienza en 0. Así que la página 1 = 0, la página 2 = 1, etc.

Parámetros

searchText: string

Cadena usada para buscar imágenes gratuitas en el catálogo.

pageNum: number

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


Devuelve

Una sola tabla (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 Free Models del catálogo. El tipo de regreso para este método es muy raro, ya que regresa una sola tabla envuelta en una tabla.

La mejor manera de explicarlo es mostrar una vista del arreglo 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 cambiar 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 repetir sobre esta lista en la parte inferior de esta página.

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

Parámetros

searchText: string

Cadena usada para buscar imágenes gratuitas en el catálogo.

pageNum: number

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


Devuelve

Una tabla (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 el último 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

Devuelve

LoadAsset

Proporciona

La función LoadAsset busca un activo por su ID y devuelve un Model que contiene el recurso. Por ejemplo, para cargar este público Doge Class.Model que tiene el ID del activo 257489726 >1> , puede usar:


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

Llamadas a esta función pueden fallar si un servidor que proporciona un modelo está teniendo problemas. Como tal, generalmente es una buena idea envolver llamadas a esta función en pcall para capturar estos tipos de errores.


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

Cheque de seguridad

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

Véase también:

Parámetros

assetId: number

El ID de la propiedad de la carga de activos.


Devuelve

Una instancia de la carga de la 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 la versión de activo proporcionada.

Parámetros

assetVersionId: number

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