InsertService
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
InsertService digunakan untuk menyisipkan aset dari situs web Roblox, biasanya fungsi LoadAsset .
Untuk memuat aset, itu harus dapat diakses oleh pembuat pengalaman yang memuatnya, yang dapat menjadi pengguna atau grup. Jika pengalaman diunggah oleh pembuat kreatoryang berbeda, data aset tidak akan dapat diakses. Lihat metode Class.Insert
Lihat Juga
- AssetService , yang dapat memberikan informasi tentang aset yang mungkin Anda inginkan untuk dimuat menggunakan LayananInsert
Rangkuman
Properti
Metode
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
Menciptakan Class.MeshPart baru dengan nilai kesesuaian yang ditentukan.
Mengambil daftar Stiker gratis dari katalog.
Mengambil daftar Model Gratis dari katalog.
Mengembalikan AssetVersionId terbaru dari aset untuk aset yang dibuat oleh kreatortempat. Dapat digunakan dalam kombinasi dengan InsertService:LoadAssetVersion() untuk memuat versi terbaru dari model, bahkan jika itu diperbarui saat game berjalan.
Mengembalikan Class.Model yang berisi aset.
Mengembalikan model yang ditempatkan di InsertService yang berisi aset dengan versi aset yang diberikan.
Properti
AllowClientInsertModels
Metode
CreateMeshPartAsync
Menciptakan MeshPart baru dengan CollisionFidelity dan RenderFidelity . Karena 2> Class.MeshPart.MeshId2> dibaca hanya,
Parameter
ID aset Mesh.
Tetapkan MeshPart.CollisionFidelity .
Tetapkan MeshPart.RenderFidelity .
Memberikan nilai
GetFreeDecals
Fungsi GetFreeDecals mengambil daftar Decals bebas dari katalog. Jenis kembalian untuk metode ini sangat aneh, karena mengembalikan tabel tunggal yang dibungkung dalam tabel.
Cara terbaik untuk menjelaskannya adalah dengan menunjukkan visual dari array yang dikembalikan:
[1] = {CurrentStartIndex = 1, -- Ini dapat bervariasi tergantung pada halaman yang Anda masukkan.TotalCount = 21, -- Selalu 21.Results = {-- Semua parameter di sini adalah pseudo. Mereka dapat bervariasi tergantung pada aset.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",},-- [2], [3], dan seterusnya ... hingga [21]},}
Sebuah contoh untuk mengulangi atas daftar ini telah diberikan di bagian bawah halaman ini.
Selain itu, jika Anda ingin menyisipkan Models sebagai gantinya, Anda dapat menggunakan fungsi InsertService:GetFreeModels() .
Catatan: Alamat halaman dimulai dari 0. Jadi halaman 1 = 0, halaman 2 = 1, dll.
Parameter
String digunakan untuk mencari stiker gratis di katalog.
Nomor halaman di Katalog untuk dikembalikan.
Memberikan nilai
Tabel tunggal (dari stiker gratis yang dikemas dalam tabel) dibungkus dalam tabel.
Contoh Kode
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
Fungsi GetFreeModels mengambil daftar Free Models dari katalog. Jenis kembalian untuk metode ini sangat aneh, karena kembalinya tabel tunggal dibungkung tabel.
Cara terbaik untuk menjelaskannya adalah dengan menunjukkan visual dari array yang dikembalikan:
[1] = {CurrentStartIndex = 1, -- Ini dapat bervariasi tergantung pada halaman yang Anda masukkan.TotalCount = 21, -- Selalu 21.Results = {-- Semua parameter di sini adalah pseudo. Mereka dapat bervariasi tergantung pada aset.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",}-- [2], [3], dan seterusnya ... hingga [21]}}
Sebuah contoh untuk mengulangi atas daftar ini telah diberikan di bagian bawah halaman ini.
Selain itu, jika Anda ingin menyisipkan Decals gratis, Anda dapat menggunakan fungsi InsertService:GetFreeDecals().
Parameter
String digunakan untuk mencari stiker gratis di katalog.
Nomor halaman di Katalog untuk dikembalikan.
Memberikan nilai
Tabel tunggal (dari model gratis yang dikembalikan) dibungkali dalam tabel.
Contoh Kode
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
Mengembalikan AssetVersionId terbaru dari aset untuk aset yang dibuat oleh kreatortempat. Dapat digunakan dalam kombinasi dengan InsertService:LoadAssetVersion() untuk memuat versi terbaru dari model, bahkan jika itu diperbarui saat game berjalan.
Parameter
Memberikan nilai
LoadAsset
Fungsi LoadAsset mengambil aset berdasarkan ID-nya dan mengembalikan Model yang berisi aset. Misalnya, untuk memuat aset ini publik DogeModel , yang memiliki ID aset 1>2> 2574897262> , Anda dapat menggunakan:
local assetId = 257489726local InsertService = game:GetService("InsertService")local model = InsertService:LoadAsset(assetId)model.Parent = workspace
Panggilan ke fungsi ini dapat gagal jika server yang menyediakan model mengalami masalah. Sebagai solusi, umumnya ide yang baik untuk mengemas panggilan ke fungsi ini dalam pcall untuk menangkap jenis kesalahan ini.
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
Pemeriksaan Keamanan
Sebuah aset dimuat oleh fungsi ini harus dibuat atau dimiliki oleh salah satu pembuat game atau Roblox. Selain itu, jenis aset yang tidak berbahaya seperti kaos, kemeja, celana, dan aksesori avatar dapat dimuat dari game mana pun karena mereka adalah publik.
Lihat juga:
- AssetService:GetBundleDetailsAsync() , untuk mengetahui aset mana yang terkait dengan bundel.
- Untuk plugin, lihat DataModel:GetObjects()
Parameter
ID aset dari aset yang dimuat.
Memberikan nilai
Sebuah instansi dari aset yang dimuat.
Contoh Kode
local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace
LoadAssetVersion
Mengembalikan model yang ditempatkan di InsertService yang berisi aset dengan versi aset yang diberikan.
Parameter
Memberikan nilai
Contoh Kode
local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace