InsertService

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tidak Dapat Dibuat
Layanan

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

Metode

Properti

AllowClientInsertModels

Tidak Dapat Ditulis Skripnya
Baca Paralel

Metode

CreateMeshPartAsync

Hasil

Menciptakan MeshPart baru dengan CollisionFidelity dan RenderFidelity . Karena 2> Class.MeshPart.MeshId2> dibaca hanya,

Parameter

meshId: ContentId

ID aset Mesh.


Memberikan nilai

Baru MeshPart kejadian.

GetFreeDecals

Hasil

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

searchText: string

String digunakan untuk mencari stiker gratis di katalog.

pageNum: number

Nomor halaman di Katalog untuk dikembalikan.


Memberikan nilai

Tabel tunggal (dari stiker gratis yang dikemas dalam tabel) dibungkus dalam tabel.

Contoh Kode

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

Hasil

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

searchText: string

String digunakan untuk mencari stiker gratis di katalog.

pageNum: number

Nomor halaman di Katalog untuk dikembalikan.


Memberikan nilai

Tabel tunggal (dari model gratis yang dikembalikan) dibungkali dalam tabel.

Contoh Kode

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

Hasil

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

assetId: number

Memberikan nilai

LoadAsset

Hasil

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

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:

Parameter

assetId: number

ID aset dari aset yang dimuat.


Memberikan nilai

Sebuah instansi dari aset yang dimuat.

Contoh Kode

InsertService:LoadAsset

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

LoadAssetVersion

Hasil

Mengembalikan model yang ditempatkan di InsertService yang berisi aset dengan versi aset yang diberikan.

Parameter

assetVersionId: number

Memberikan nilai

Contoh Kode

InsertService:LoadAssetVersion

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

Acara