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

Metode

Properti

AllowClientInsertModels

Tidak Dapat Ditulis Skripnya
Baca Paralel

Metode

CreateMeshPartAsync

Hasil

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

meshId: ContentId

ID aset mesh.

Nilai Default: ""
collisionFidelity: Enum.CollisionFidelity
Nilai Default: ""
renderFidelity: Enum.RenderFidelity
Nilai Default: ""

Memberikan nilai

kejadianbaru MeshPart .

GetFreeDecals

Hasil

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

searchText: string

String yang digunakan untuk mencari gambar gratis di katalog.

Nilai Default: ""
pageNum: number

Nomor halaman di Katalog untuk dikembalikan.

Nilai Default: ""

Memberikan nilai

Satu meja (decal gratis yang dikembalikan) dibungkus dalam meja.

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

searchText: string

String yang digunakan untuk mencari gambar gratis di katalog.

Nilai Default: ""
pageNum: number

Nomor halaman di Katalog untuk dikembalikan.

Nilai Default: ""

Memberikan nilai

Satu meja (model gratis yang dikembalikan) dibungkus dalam meja.

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

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

assetId: number
Nilai Default: ""

Memberikan nilai

LoadAsset

Hasil

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

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:

Parameter

assetId: number

ID aset dari aset yang dimuat.

Nilai Default: ""

Memberikan nilai

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

Kembalikan model yang dimasukkan ke InsertService berisi aset dengan asetVersionId yang diberikan.

Parameter

assetVersionId: number
Nilai Default: ""

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