InsertService

Hiển Thị Bản Đã Lỗi Thời

*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.

Không Thể Tạo
Dịch Vụ

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

Phương Pháp

Thuộc Tính

AllowClientInsertModels

Không Thể Viết Kịch Bản
Đọc Song Song

Phương Pháp

CreateMeshPartAsync

Sinh Lợi

Tạo một new MeshPart mới với CollisionFidelityRenderFidelity . Vì 1> Class.MeshPart.MeshId</

Tham Số

meshId: ContentId

ID tài nguyên lưới.


Lợi Nhuận

Cái mới MeshPart ví dụ / trường hợp

GetFreeDecals

Sinh Lợi

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ố

searchText: string

Chuỗi được sử dụng để tìm decal miễn phí trong Mục lục.

pageNum: number

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ã

InsertService:GetFreeDecals

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

Sinh Lợi

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ố

searchText: string

Chuỗi được sử dụng để tìm decal miễn phí trong Mục lục.

pageNum: number

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ã

InsertService:GetFreeModels

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

Sinh Lợi

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ố

assetId: number

Lợi Nhuận

LoadAsset

Sinh Lợi

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 = 257489726
local 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 = 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

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:

Tham Số

assetId: number

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ã

InsertService:LoadAsset

local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace

LoadAssetVersion

Sinh Lợi

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ố

assetVersionId: number

Lợi Nhuận

Mẫu mã

InsertService:LoadAssetVersion

local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace

Sự Kiện