InsertService

Cria um novo MeshPart com especificado CollisionFidelity e RenderFidelity .Como MeshPart.MeshId é apenas de leitura, esta é a maneira de criar um MeshPart através de scripts sem ter que clonar um existente.Ela lança erros se a criação falhar.

Parâmetros

Devolução

A função GetFreeDecals recupera uma lista de gratuitos Decals a partir do Catálogo.O tipo de retorno para este método é muito estranho, pois retorna uma única tabela embalada em uma tabela.

A melhor maneira de explicá-lo é mostrar um visual do array retornado:

[1] = {
	CurrentStartIndex = 1, -- Isso pode variar dependendo da página que você inserir.
	TotalCount = 21, -- Sempre 21.
	Results = {
		-- Todos os parâmetros aqui são pseudônimos. Eles podem variar dependendo do recurso.
		[1] = {
			Name = "Asset Name",
			AssetId = 0000000,
			AssetVersionId = 0000000,
			CreatorName = "Roblox",
		},
		-- [2], [3], e assim por diante... até [21]
	},
}

Um exemplo para iterar sobre essa lista foi fornecido no final desta página.

Além disso, se você quiser inserir Models em vez disso, você pode usar a função InsertService:GetFreeModels().

Nota: O argumento da página começa em 0. Então, Página 1 = 0, Página 2 = 1, etc.

Parâmetros

Devolução

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

A função GetFreeModels recupera uma lista de Free Models a partir do Catálogo.O tipo de retorno para este método é muito estranho, pois retorna uma única tabela embalada em uma tabela.

A melhor maneira de explicá-lo é mostrar um visual do array retornado:

[1] = {
	CurrentStartIndex = 1, -- Isso pode variar dependendo da página que você inserir.
	TotalCount = 21, -- Sempre 21.
	Results = {
		-- Todos os parâmetros aqui são pseudônimos. Eles podem variar dependendo do recurso.
		[1] = {
			Name = "Asset Name",
			AssetId = 0000000,
			AssetVersionId = 0000000,
			CreatorName = "Roblox",
    		}
    		-- [2], [3], e assim por diante... até [21]
    	}
}

Um exemplo para iterar sobre essa lista foi fornecido no final desta página.

Além disso, se você quiser inserir gratuitamente Decals, você pode usar a função InsertService:GetFreeDecals().

Parâmetros

Devolução

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

Retorna o último AssetVersionId de um recurso para recursos criados pelo criador do local.Pode ser usado em combinação com InsertService:LoadAssetVersion() para carregar a versão mais recente de um modelo, mesmo que seja atualizado enquanto o jogo está em execução.

Parâmetros

Devolução

A função LoadAsset pega um recurso dado seu ID e retorna um Model que contém o ativo.Por exemplo, para carregar este público DogeModel , que tem o ID de recurso *257489726 * , você pode usar:

local InsertService = game:GetService("InsertService")
local Workspace = game:GetService("Workspace")

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

Chamadas para essa função podem falhar se um servidor que fornece um modelo estiver tendo problemas.Como tal, geralmente é uma boa ideia envolver chamadas para essa função em pcall para capturar esse tipo de erro.

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

Verificação de Segurança

Um recurso carregado por essa função deve ser criado ou possuído por algum dos seguintes: criador do jogo ou Roblox.Além disso, tipos de recurso benignos, como camisetas, camisas, calças e acessórios de avatar são carregáveis de qualquer jogo, pois são públicos.

Veja também:

• AssetService:GetBundleDetailsAsync() , para descobrir quais recursos estão associados a um pacote.
• Para plugins, veja DataModel:GetObjects()

Parâmetros

Devolução

local InsertService = game:GetService("InsertService")

local ASSET_ID = 82353

local asset = InsertService:LoadAsset(ASSET_ID)

asset.Parent = workspace

Retorna um modelo inserido em InsertService que contém o recurso com o ID de versão dado.

Parâmetros

Devolução

local InsertService = game:GetService("InsertService")

local ASSET_VERSION_ID = 296050499

local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)

asset.Parent = game.Workspace