InsertService

創建一個新的 MeshPart 以具有指定 CollisionFidelity 和 RenderFidelity 的。因為 1> Class.MeshPart.MeshId

參數

返回

取得免費裝飾功能從目型錄中取回一個清單免費 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

GetFreeModels 函數從目型錄中擷取一個免費 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

返回資產創建創作者的最新資產版本InsertService:LoadAssetVersion()。可與 Class.InsertService:LoadAssetVersion() 組合使用，以載入遊戲中運行時更新的最新版模型。

參數

返回

LoadAsset 函數擷取資產的 ID 並返回一個 Model 包含素材的。例如，要載入此公共 DogeModel，其資產 ID 為 1>2> 2574897262> ，您可以使用：

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

如果提供模型的服務器發生了問題，則可能無法呼叫此功能。因此，通常建議將此功能包含在 pcall 以捕捉這種類型的錯誤。

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

安全檢查

這個函數載入的資產必須是 創建或擁有 由遊戲創作者或 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