InsertService
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
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
Propiedades
Métodos
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
Crea un nuevo MeshPart con valores de fidelidad especificados.
Recupera una lista de calcomanías gratuitas del catálogo.
Recupera una lista de modelos gratuitos del catálogo.
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.
Devuelve un Model que contiene el activo.
Devuelve un modelo insertado en InsertService que contiene el activo con el ID de activo dado.
Propiedades
AllowClientInsertModels
Métodos
CreateMeshPartAsync
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
ID de activo de malla.
Establecer MeshPart.CollisionFidelity .
Establecer MeshPart.RenderFidelity .
Devuelve
GetFreeDecals
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
Texto utilizado para buscar imágenes gratuitas en el catálogo.
El número de página en el catálogo para devolver.
Devuelve
Una tabla única (de calcomanías gratuitas devueltas) envuelta en una tabla.
Muestras de código
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 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
Texto utilizado para buscar imágenes gratuitas en el catálogo.
El número de página en el catálogo para devolver.
Devuelve
Una tabla única (de modelos gratuitos devueltos) envuelta en una tabla.
Muestras de código
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
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
Devuelve
LoadAsset
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 = 257489726local 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 = 257489726local success, model = pcall(InsertService.LoadAsset, InsertService, assetId)if success and model thenprint("Model loaded successfully")model.Parent = Workspaceelseprint("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:
- AssetService:GetBundleDetailsAsync() , para descubrir qué recursos están asociados con un paquete.
- Para plugins, ver DataModel:GetObjects()
Parámetros
El ID del activo del activo que se está cargando.
Devuelve
Una instancia del activo recurso.
Muestras de código
local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace
LoadAssetVersion
Devuelve un modelo insertado en InsertService que contiene el activo con el ID de activo dado.
Parámetros
Devuelve
Muestras de código
local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace