InsertService

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Não criável
Serviço

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

Resumo

Métodos

Propriedades

AllowClientInsertModels

Não scriptável
Ler Parallel

Métodos

CreateMeshPartAsync

Rendimentos

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

Devolução

Nueva instancia de MeshPart.

GetFreeDecals

Rendimentos

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.


Devolução

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

Amostras 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

Rendimentos

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.


Devolução

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

Amostras 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

Rendimentos

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

Devolução

LoadAsset

Rendimentos

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.


Devolução

Una instancia de la carga de la recurso.

Amostras de código

InsertService:LoadAsset

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

LoadAssetVersion

Rendimentos

Devuelve un modelo insertado en InsertService que contiene el activo con la versión de activo proporcionada.

Parâmetros

assetVersionId: number

Devolução

Amostras 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