InsertService

创建一个新的 MeshPart 与指定的 CollisionFidelity 和 RenderFidelity 。因为 MeshPart.MeshId 是只读的，这是创建一个 MeshPart 通过脚本而不需要复制现有的方式。如果创建失败，它会抛出错误。

参数

返回

获取免费图标函数从目录中检索一列免费图标列表。Decals这个方法的返回类型很奇怪，因为它返回一个包含在表中的单个表。

最好的方法是显示返回的阵列的视觉效果：

[1] = {
	CurrentStartIndex = 1, -- 这可以根据你输入的页面而变化。
	TotalCount = 21, -- 总是 21。
	Results = {
		-- 这里所有参数都是假的。它们可以根据资产而变化。
		[1] = {
			Name = "Asset Name",
			AssetId = 0000000,
			AssetVersionId = 0000000,
			CreatorName = "Roblox",
		},
		-- [2]，[3]，等等……最多达[21]
	},
}

在本页底部提供了循环过这个列表的示例。

此外，如果你想要插入 Models 而不是它，你可以使用 InsertService:GetFreeModels() 函数。

注意： 页面参数从 0 开始。因此，页面 1 = 0、页面 2 = 1 等。

参数

返回

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

获取免费模型函数从目录中检索一列免费 Models 列表。这个方法的返回类型很奇怪，因为它返回一个包含在表中的单个表。

最好的方法是显示返回的阵列的视觉效果：

[1] = {
	CurrentStartIndex = 1, -- 这可以根据你输入的页面而变化。
	TotalCount = 21, -- 总是 21。
	Results = {
		-- 这里所有参数都是假的。它们可以根据资产而变化。
		[1] = {
			Name = "Asset Name",
			AssetId = 0000000,
			AssetVersionId = 0000000,
			CreatorName = "Roblox",
    		}
    		-- [2]，[3]，等等……最多达[21]
    	}
}

在本页底部提供了循环过这个列表的示例。

此外，如果你想插入免费的 Decals , 你可以使用 InsertService:GetFreeDecals() 函数。

参数

返回

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

返回地点创建创作者创建的资产的最新资产版本ID。可以与 InsertService:LoadAssetVersion() 结合使用，加载模型的最新版本，即使在游戏运行时也是如此。

参数

返回

加载资产函数获取一个资产，根据其ID返回包含素材的Model。例如，要加载这个公共DogeModel，其资产ID为 *257489726 *，你可以使用：

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

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

提供模型的服务器出现问题时，调用此函数可能会失败。因此，一般来说，将调用此函数的调用包装在 pcall 中以捕获这类错误是一个好主意。

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

安全检查

由此函数加载的资产必须由游戏创建者或 Roblox 创建或拥有 创建或拥有 。此外，如T恤衫、衬衫、裤子和虚拟形象配件等无害的资产类型可以从任何游戏加载，因为它们是公开共的。

还见：

• AssetService:GetBundleDetailsAsync() , 查找哪些资产与套装关联。
• 对于插件，请参阅 DataModel:GetObjects()

参数

返回

local InsertService = game:GetService("InsertService")

local ASSET_ID = 82353

local asset = InsertService:LoadAsset(ASSET_ID)

asset.Parent = workspace

返回插入到 InsertService 中的模型，包含指定的资产版本ID的资产。

参数

返回

local InsertService = game:GetService("InsertService")

local ASSET_VERSION_ID = 296050499

local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)

asset.Parent = game.Workspace