InsertService
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
InsertService được sử dụng để tải tài sản từ trang Roblox, thường là hào LoadAsset .
Để tải một tài nguyên, nó phải có thể truy cập bởi người tạo nội dung của trải nghiệm đang tải nó, có thể là một nhà sáng tạodùng hoặc nhóm. Nếu một trải nghiệm được tả
Xem thêm
- AssetService , which can provide information about assets you might want to load using dịch vụ nạp
Tóm Tắt
Thuộc Tính
Phương Pháp
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
Tạo một MeshPart mới với các giá trị độ tin cậy được xác định.
Lấy một danh sách các hình ảnh miễn phí từ Mục lục.
Lấy một danh sách các Mô Hình Miễn Phí từ Mục lục.
Làm trả lại AssetVersionId mới nhất của tài sản cho tài sản được tạo bởi người sáng nhà sáng tạo. Có thể được sử dụng kết hợp với InsertService:LoadAssetVersion() để tải phiên bản mới nhất của một mô hình, ngay cả khi nó được cập nhật trong khi game đang chạy.
Trả lại một Model chứa tài nguyên.
Trả lại một mô hình được thêm vào InsertService chứa tài nguyên với phiên bản tài nguyên đã được cung cấp.
Thuộc Tính
AllowClientInsertModels
Phương Pháp
CreateMeshPartAsync
Tạo một new MeshPart mới với CollisionFidelity và RenderFidelity . Vì 1> Class.MeshPart.MeshId</
Tham Số
Lợi Nhuận
GetFreeDecals
Hàm GetFreeDecals lấy một danh sách các hình ảnh miễn phí từ Mục lục. Loại trả về cho hàm này rất kỳ lạ, vì nó trả về một bảng mà được đóng gói trong một bảng.
Cách tốt nhất để giải thích nó là hiển thị một bảng thị những gì đã được trả về:
[1] = {CurrentStartIndex = 1, -- Điều này có thể thay đổi tùy thuộc vào trang bạn nhập.TotalCount = 21, -- Luôn 21.Results = {-- Tất cả các tham số ở đây là giả dối. Chúng có thể thay đổi tùy thuộc vào tài sản.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",},-- [2], [3], và như vậy tiếp tục ... lên đến [21]},}
Một ví dụ cho việc lặp lại trên danh sách này đã được cung cấp ở dưới cùng của trang này.
Ngoài ra, nếu bạn muốn thay vào đó Models thì bạn có thể sử dụng chức năng InsertService:GetFreeModels() .
Ghi chú: Theo cách này, trang bắt đầu tại 0. Vì vậy trang 1 = 0, trang 2 = 1, v.v.
Tham Số
Chuỗi được sử dụng để tìm decal miễn phí trong Mục lục.
Số trang trong Catalog để trả lại.
Lợi Nhuận
Một bảng (của những hình ảnh miễn phí được trả lại) được bao bọc trong một bảng.
Mẫu mã
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
Hàm GetFreeModels lấy một danh sách các Models miễn phí từ Mục lục. Loại trả về cho hàm này rất kỳ lạ, vì nó trả một bảng hiện đơn nhiên.
Cách tốt nhất để giải thích nó là hiển thị một bảng thị những gì đã được trả về:
[1] = {CurrentStartIndex = 1, -- Điều này có thể thay đổi tùy thuộc vào trang bạn nhập.TotalCount = 21, -- Luôn 21.Results = {-- Tất cả các tham số ở đây là giả dối. Chúng có thể thay đổi tùy thuộc vào tài sản.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",}-- [2], [3], và như vậy tiếp tục ... lên đến [21]}}
Một ví dụ cho việc lặp lại trên danh sách này đã được cung cấp ở dưới cùng của trang này.
Ngoài ra, nếu bạn muốn tạo một miếng dán miễn phí Decals , bạn có thể sử dụng chức năng InsertService:GetFreeDecals() .
Tham Số
Chuỗi được sử dụng để tìm decal miễn phí trong Mục lục.
Số trang trong Catalog để trả lại.
Lợi Nhuận
Một bảng (của các mô hình miễn phí đã trả lại) được bao bọc trong một bảng.
Mẫu mã
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
Làm trả lại AssetVersionId mới nhất của tài sản cho tài sản được tạo bởi người sáng nhà sáng tạo. Có thể được sử dụng kết hợp với InsertService:LoadAssetVersion() để tải phiên bản mới nhất của một mô hình, ngay cả khi nó được cập nhật trong khi game đang chạy.
Tham Số
Lợi Nhuận
LoadAsset
Hàm LoadAsset lấy một tài nguyên được cung cấp ID của nó và trả lại một Model chứa tài nguyên. Ví dụ, để tải công cụ này công cụ DogeModel , có ID tài nguyên 1>2> 2
local assetId = 257489726local InsertService = game:GetService("InsertService")local model = InsertService:LoadAsset(assetId)model.Parent = workspace
Các cuộc gọi đến chức năng này có thể bị lỗi nếu một máy chủ cung cấp một mô hình đang gặp vấn đề. Như vậy, nó thường là một lý tưởng tốt để bọc các gọi đến chức năng này trong pcall để bắt những loại lỗi này.
local assetId = 257489726local InsertService = game:GetService("InsertService")local success, model = pcall(InsertService.LoadAsset, InsertService, assetId)if success and model thenprint("Model loaded successfully")model.Parent = workspaceelseprint("Model failed to load!")end
Kiểm tra an ninh
Một tài nguyên được tải bởi chức năng này phải là tạo hoặc sở hữu bởi người sáng tạo game hoặc Roblox. Ngoài ra, các loại tài nguyên bình tĩnh như áo thun, áo len, quần và phụ kiện avatar là có thể tải từ bất kỳ trò chơi nào vì chúng là công cộngkhai.
Xem thêm:
- AssetService:GetBundleDetailsAsync() , để tìm hiểu các tài nguyên được liên kết với một gói.
- Đối với các plugin, xem DataModel:GetObjects()
Tham Số
ID tài sản của tài sản đang tải.
Lợi Nhuận
Một instace của tài nguyên đã tải.
Mẫu mã
local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace
LoadAssetVersion
Trả lại một mô hình được thêm vào InsertService chứa tài nguyên với phiên bản tài nguyên đã được cung cấp.
Tham Số
Lợi Nhuận
Mẫu mã
local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace