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 để chèn tài sản từ trang web Roblox, thường là chức năng LoadAsset.
Để tải một tài sản, nó phải có thể truy cập bởi người tạo ra trải nghiệm đang tải nó, có thể là người dùng hoặc nhóm.Nếu một trải nghiệm được tải lên bởi một nhà sáng tạo khác, dữ liệu tài sản sẽ không thể truy cập được.Xem phương pháp LoadAsset() để có thêm chi tiết về kiểm tra bảo mật này.Lưu ý rằng bạn không nên không sử dụng dịch vụ này để tải các chìa khóa API hoặc bí mật khác.Sử dụng HttpService:GetSecret()
Xem thêm
- AssetService , có thể cung cấp thông tin về tài sản bạn có thể muốn tải bằng cách sử dụng Dịch vụ Chèn
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 mới MeshPart với các giá trị trung thành được định nghĩa.
Lấy danh sách Decal miễn phí từ Mục lục.
Lấy danh sách các mô hình miễn phí từ Mục lục.
Trả về AssetVersionId mới nhất của một tài sản cho các tài sản được tạo bởi người nhà sáng tạonơi.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 trò chơi đang chạy.
Trả về một Model chứa tài sản.
Trả về một mô hình được chèn vào InsertService chứa tài sản với ID tài sản được cung cấp.
Thuộc Tính
AllowClientInsertModels
Phương Pháp
CreateMeshPartAsync
Tạo một cái mới MeshPart với CollisionFidelity và RenderFidelity được định nghĩa.Bởi vì MeshPart.MeshId chỉ đọc, đây là cách tạo một MeshPart thông qua các kịch bản mà không cần phải sao chép một cái hiện có.Nó ném lỗi nếu quá trình tạo thất bại.
Tham Số
ID tài sản mesh.
Lợi Nhuận
GetFreeDecals
Chức năng GetFreeDecals truy xuất một danh sách các ảnh miễn phí Decals từ Mục lục.Loại trả lại cho phương pháp này rất kỳ lạ, vì nó trả lại một bảng duy nhất được bọc trong một bảng.
Cách tốt nhất để giải thích nó là hiển thị một hình ảnh của mảng đượ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 là 21.Results = {-- Tất cả các tham số ở đây là giả mạo. 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... cho đến [21]},}
Một ví dụ về việc lặp lại qua danh sách này đã được cung cấp ở phía dưới của trang này.
Ngoài ra, nếu bạn muốn chèn Models thay vào đó, bạn có thể sử dụng chức năng InsertService:GetFreeModels().
Ghi chú: Phần tham số 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 kiếm tem miễn phí trong Mục lục.
Số trang trong Catalog để trả về.
Lợi Nhuận
Một bảng duy nhất (của nhãn miễn phí được trả lại) được 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
Chức năng GetFreeModels lấy lại một danh sách Free Models từ Mục lục.Loại trả lại cho phương pháp này rất kỳ lạ, vì nó trả lại một bảng duy nhất được bọc trong một bảng.
Cách tốt nhất để giải thích nó là hiển thị một hình ảnh của mảng đượ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 là 21.Results = {-- Tất cả các tham số ở đây là giả mạo. 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... cho đến [21]}}
Một ví dụ về việc lặp lại qua danh sách này đã được cung cấp ở phía dưới của trang này.
Ngoài ra, nếu bạn muốn chè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 kiếm tem miễn phí trong Mục lục.
Số trang trong Catalog để trả về.
Lợi Nhuận
Một bảng duy nhất (của các mô hình miễn phí đã trở lại) được 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
Trả về AssetVersionId mới nhất của một tài sản cho các tài sản được tạo bởi người nhà sáng tạonơi.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 trò chơi đang chạy.
Tham Số
Lợi Nhuận
LoadAsset
Chức năng LoadAsset lấy một tài sản theo ID của nó và trả về một tài sản chứa Model chứa tài sản.Ví dụ, để tải công khai này DogeModel , có ID tài sản *257489726 * , bạn có thể sử dụng:
local InsertService = game:GetService("InsertService")local Workspace = game:GetService("Workspace")local assetId = 257489726local model = InsertService:LoadAsset(assetId)model.Parent = Workspace
Các cuộc gọi đến chức năng này có thể thất bại nếu một máy chủ cung cấp mô hình đang gặp sự cố.Vì vậy, nó thường là một ý tưởng tốt để bọc các cuộc gọi đến chức năng này trong pcall để bắt các loại lỗi như vậy.
local InsertService = game:GetService("InsertService")local Workspace = game:GetService("Workspace")local assetId = 257489726local 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 sản được tải bởi chức năng này phải là được tạo hoặc sở hữu bởi chủ sở hữu trò chơi hoặc Roblox.Ngoài ra, các loại tài sản lành tính như áo thun, áo sơ mi, quần và phụ kiện avatar có thể được tải từ bất kỳ trò chơi nào vì chúng công công cộng.
Xem thêm:
- AssetService:GetBundleDetailsAsync() , để tìm ra các tài sản nào được liên kết với một gói.
- Đối với plugin, xem DataModel:GetObjects()
Tham Số
ID tài sản của tài sản đang được tải.
Lợi Nhuận
Một ví dụ về tài sả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ả về một mô hình được chèn vào InsertService chứa tài sản với ID tài sả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