InsertService
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
InsertService, Roblox web sitesinden varlıkların eklenmesi için kullanılır, genellikle LoadAsset fonksiyonu.
Bir varlığı yüklebilmek için, deneyimi yükleyen kişi tarafından erişilebilir olmalıdır, ki bu bir kullanıcı veya grup olabilir.Bir deneyim farklı bir yaratıcı tarafından yüklenmeli ise, varlık verilerine erişilemez.Bu güvenlik kontrol ethakkında daha fazla ayrıntı için LoadAsset() yöntemini görün.API anahtarlarını veya diğer sırları yükleme için bu hizmeti kullanmamanız gerektiğini unutmayın ve .Bunun yerine HttpService:GetSecret() kullanın.
Ayrıca bakın
- AssetService , kullanarak yüklemek istediğiniz varlıklarla ilgili bilgi sağlayabilir InsertService
Özet
Özellikler
Yöntemler
- CreateMeshPartAsync(meshId : ContentId,collisionFidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):MeshPart
Belirtilen sadakat değerleriyle yeni bir MeshPart oluşturur.
Kataloğdan ücretsiz Çizimlerin bir listesini alır.
Kataloğdan Boş Modellerin bir listesini alır.
Bir yer yaratıcıtarafından oluşturulan varlıklar için en son AssetVersionId'yi döndürür.Bir modelin en son sürümünü yüklemek için InsertService:LoadAssetVersion() ile birlikte kullanılabilir, oyun çalışırken güncellenirse bile.
İçinde varlık bulunduran bir Model döndürür.
Varlığı verilen assetVersionId ile içeren bir modeli InsertService içine döndürür.
Özellikler
AllowClientInsertModels
Yöntemler
CreateMeshPartAsync
Belirtilen MeshPart ve CollisionFidelity ile yeni bir oluşturur RenderFidelity .Çünkü MeshPart.MeshId sadece okunur, mevcut bir tanesini klonlamak zorunda olmadan bir MeshPart oluşturmanın yolu budur.Oluşturma başarısız olursa hatalar atar.
Parametreler
Mesh varlık kimliği.
Set MeshPart.RenderFidelity .
Dönüşler
GetFreeDecals
GetFreeDecals işlevi, Katalogücretsiz bir Decals listesi alır.Bu yöntemin dönüş türü çok tuhaf, çünkü bir tablo içinde sarılmış tek bir tablo döndürüyor.
Bunu açıklamanın en iyi yolu, döndürülen dizinin bir görselini göstermektir:
[1] = {CurrentStartIndex = 1, -- Bunun, girdiğiniz sayfaya bağlı olarak değişebilir.TotalCount = 21, -- Her zaman 21.Results = {-- Buradaki tüm parametler sahtedir. Varlığa bağlı olarak değişebilirler.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",},-- [2], [3], ve öylece... [21] kadar},}
Bu listeyi döndürmek için bir örnek bu sayfanın en altında verildi.
Ayrıca, bunun yerine Models yerleştirmek istiyorsanız, InsertService:GetFreeModels() işlevini kullanabilirsiniz.
Not: Sayfa argümanı 0'da başlar. Yani Sayfa 1 = 0, Sayfa 2 = 1, vb.
Parametreler
Katalogücretsiz resimler aramak için kullanılan dize.
Geri dönmek için Kataloğun sayfa numarası.
Dönüşler
Tek bir tablo (geri döndürülen ücretsiz çizimler) bir tabloya sarılmış.
Kod Örnekleri
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
GetFreeModels işlevi, Katalogbir liste ücretsiz Models alır.Bu yöntemin dönüş türü çok tuhaf, çünkü bir tablo içinde sarılmış tek bir tablo döndürüyor.
Bunu açıklamanın en iyi yolu, döndürülen dizinin bir görselini göstermektir:
[1] = {CurrentStartIndex = 1, -- Bunun, girdiğiniz sayfaya bağlı olarak değişebilir.TotalCount = 21, -- Her zaman 21.Results = {-- Buradaki tüm parametler sahtedir. Varlığa bağlı olarak değişebilirler.[1] = {Name = "Asset Name",AssetId = 0000000,AssetVersionId = 0000000,CreatorName = "Roblox",}-- [2], [3], ve öylece... [21] kadar}}
Bu listeyi döndürmek için bir örnek bu sayfanın en altında verildi.
Ayrıca, ücretsiz Decals eklemek istiyorsanız, InsertService:GetFreeDecals() işlevini kullanabilirsiniz.
Parametreler
Katalogücretsiz resimler aramak için kullanılan dize.
Geri dönmek için Kataloğun sayfa numarası.
Dönüşler
Tek bir tablo (geri döndürülen ücretsiz modeller) bir tabloya sarılmış.
Kod Örnekleri
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
Bir yer yaratıcıtarafından oluşturulan varlıklar için en son AssetVersionId'yi döndürür.Bir modelin en son sürümünü yüklemek için InsertService:LoadAssetVersion() ile birlikte kullanılabilir, oyun çalışırken güncellenirse bile.
Parametreler
Dönüşler
LoadAsset
LoadAsset işlevi, kimliğini verilen bir varlığı alır ve varlığı içeren bir Model döndürür.Örneğin, bu halka açık DogeModel, varlık kimliği *257489726 * olanı yüklemek için şunu kullanabilirsiniz:
local InsertService = game:GetService("InsertService")local Workspace = game:GetService("Workspace")local assetId = 257489726local model = InsertService:LoadAsset(assetId)model.Parent = Workspace
Bu işlevi çağırmak, bir model sağlayan sunucunun sorun yaşıyor olması durumunda başarısız olabilir.Bu nedenle, genellikle bu işlev için çağrıları pcall sararak bu tür hataları yakalamak için iyi bir fikirdir.
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
Güvenlik Kontrolü
Bu işlev tarafından yüklenen bir varlık, oyun yaratıcısı veya Roblox tarafından yaratılmış veya sahiplenmiş olmalı .Ayrıca, tişörtler, gömlekler, pantolonlar ve avatar aksesuarları gibi zararsız varlık türleri herhangi bir oyundan yüklenebilir, çünkü onlar da herkese açık.
Ayrıca bakın:
- AssetService:GetBundleDetailsAsync() , bir sethangi varlıkların ilişkili olduğunu bulmak için.
- Plaklar için, bakın DataModel:GetObjects()
Parametreler
Yüklenen varlığın varlık kimliği.
Dönüşler
Yüklü varlığın bir örneği.
Kod Örnekleri
local InsertService = game:GetService("InsertService")
local ASSET_ID = 82353
local asset = InsertService:LoadAsset(ASSET_ID)
asset.Parent = workspace
LoadAssetVersion
Varlığı verilen assetVersionId ile içeren bir modeli InsertService içine döndürür.
Parametreler
Dönüşler
Kod Örnekleri
local InsertService = game:GetService("InsertService")
local ASSET_VERSION_ID = 296050499
local asset = InsertService:LoadAssetVersion(ASSET_VERSION_ID)
asset.Parent = game.Workspace