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 để 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

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 cái mới MeshPart với CollisionFidelityRenderFidelity đượ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ố

meshId: ContentId

ID tài sản mesh.

Giá Trị Mặc Định: ""
collisionFidelity: Enum.CollisionFidelity
Giá Trị Mặc Định: ""
renderFidelity: Enum.RenderFidelity
Giá Trị Mặc Định: ""

Lợi Nhuận

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

GetFreeDecals

Sinh Lợi

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ố

searchText: string

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

Giá Trị Mặc Định: ""
pageNum: number

Số trang trong Catalog để trả về.

Giá Trị Mặc Định: ""

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ã

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

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ố

searchText: string

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

Giá Trị Mặc Định: ""
pageNum: number

Số trang trong Catalog để trả về.

Giá Trị Mặc Định: ""

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ã

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

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ố

assetId: number
Giá Trị Mặc Định: ""

Lợi Nhuận

LoadAsset

Sinh Lợi

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

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:

Tham Số

assetId: number

ID tài sản của tài sản đang được tải.

Giá Trị Mặc Định: ""

Lợi Nhuận

Một ví dụ về tài sả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ả 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ố

assetVersionId: number
Giá Trị Mặc Định: ""

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