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 diakses oleh pencipta pengalaman yang memuatnya, yang bisa menjadi pengguna atau grup.Haruskah pengalaman diunggah oleh kreatoryang berbeda, data aset tidak akan dapat diakses.Lihat metode LoadAsset() untuk lebih banyak rincian tentang periksakeamanan ini.Perhatikan bahwa Anda tidak boleh tidak menggunakan layanan ini untuk memuat kunci API atau rahasia lainnya.Gunakan HttpService:GetSecret() sebagai gantinya.
Lihat Juga
- AssetService , yang dapat memberikan informasi tentang aset yang mungkin ingin Anda muat menggunakan Layanan Masuk
Rangkuman
Properti
Metode
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
Membuat baru MeshPart dengan nilai kesetiaan yang ditentukan.
Mengambil daftar Stiker gratis dari katalog.
Mengambil daftar Model Gratis dari katalog.
Kembalikan AssetVersionId terbaru dari aset untuk aset yang dibuat oleh kreatortempat.Dapat digunakan bersama dengan InsertService:LoadAssetVersion() untuk memuat versi terbaru model, bahkan jika diperbarui saat permainan berjalan.
Kembalikan Model yang berisi aset.
Kembalikan model yang dimasukkan ke InsertService berisi aset dengan asetVersionId yang diberikan.
Properti
AllowClientInsertModels
Metode
CreateMeshPartAsync
Membuat baru MeshPart dengan spesifikasi CollisionFidelity dan RenderFidelity .Karena MeshPart.MeshId dibaca hanya, inilah cara untuk membuat MeshPart melalui skrip tanpa harus menyalin yang sudah ada.Ia melempar kesalahan jika penciptaan gagal.
Parameter
ID aset mesh.
Tetapkan MeshPart.CollisionFidelity.
Tetapkan MeshPart.RenderFidelity.
Memberikan nilai
GetFreeDecals
Fungsi GetFreeDecals memulihkan daftar gratis Decals dari katalog.Jenis pengembalian untuk metode ini sangat aneh, karena mengembalikan satu tabel yang dibungkus dalam tabel.
Cara terbaik untuk menjelaskannya adalah dengan menunjukkan visual array yang dikembalikan:
[1] = {CurrentStartIndex = 1, -- Ini bisa bervariasi tergantung pada halaman yang Anda masukkan.TotalCount = 21, -- Selalu 21.Results = {-- Semua parameter di sini adalah palsu. Mereka dapat bervariasi tergantung pada aset.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",},-- [2], [3], dan seterusnya... sampai [21]},}
Contoh untuk mengulangi atas daftar ini telah disediakan di bagian bawah halaman ini.
Selain itu, jika Anda ingin menyisipkan Models sebagai gantinya, Anda dapat menggunakan fungsi InsertService:GetFreeModels().
Catatan: Argumen halaman dimulai pada 0. Jadi Halaman 1 = 0, Halaman 2 = 1, dll.
Parameter
String yang digunakan untuk mencari gambar gratis di katalog.
Nomor halaman di Katalog untuk dikembalikan.
Memberikan nilai
Satu meja (decal gratis yang dikembalikan) dibungkus dalam meja.
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 memulihkan daftar Gratis Models dari katalog.Jenis pengembalian untuk metode ini sangat aneh, karena mengembalikan satu tabel yang dibungkus dalam tabel.
Cara terbaik untuk menjelaskannya adalah dengan menunjukkan visual array yang dikembalikan:
[1] = {CurrentStartIndex = 1, -- Ini bisa bervariasi tergantung pada halaman yang Anda masukkan.TotalCount = 21, -- Selalu 21.Results = {-- Semua parameter di sini adalah palsu. Mereka dapat bervariasi tergantung pada aset.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",}-- [2], [3], dan seterusnya... sampai [21]}}
Contoh untuk mengulangi atas daftar ini telah disediakan di bagian bawah halaman ini.
Selain itu, jika Anda ingin menyisipkan gratis Decals , Anda dapat menggunakan fungsi InsertService:GetFreeDecals().
Parameter
String yang digunakan untuk mencari gambar gratis di katalog.
Nomor halaman di Katalog untuk dikembalikan.
Memberikan nilai
Satu meja (model gratis yang dikembalikan) dibungkus dalam meja.
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
Kembalikan AssetVersionId terbaru dari aset untuk aset yang dibuat oleh kreatortempat.Dapat digunakan bersama dengan InsertService:LoadAssetVersion() untuk memuat versi terbaru model, bahkan jika diperbarui saat permainan berjalan.
Parameter
Memberikan nilai
LoadAsset
Fungsi LoadAsset mengambil aset dengan IDnya dan kembalikan aset Model yang berisi aset.Sebagai contoh, untuk memuat ini publik DogeModel , yang memiliki ID aset *257489726 * , Anda dapat menggunakan:
local InsertService = game:GetService("InsertService")local Workspace = game:GetService("Workspace")local assetId = 257489726local model = InsertService:LoadAsset(assetId)model.Parent = Workspace
Panggilan ke fungsi ini mungkin gagal jika server yang menyediakan model mengalami masalah.Dengan demikian, umumnya merupakan ide bagus untuk melapisi panggilan ke fungsi ini di pcall untuk menangkap jenis kesalahan ini.
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
Pemeriksaan Keamanan
Aset yang dimuat oleh fungsi ini harus diciptakan atau dimiliki oleh pembuat game atau Roblox.Selain itu, jenis aset yang tidak berbahaya seperti kaus, kemeja, celana, dan aksesori avatar dapat dimuat dari game apa pun karena mereka 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
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
Kembalikan model yang dimasukkan ke InsertService berisi aset dengan asetVersionId 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