InsertService

Artık kullanılmayanları göster

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Oluşturulamaz
Hizmet

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

Yöntemler

Özellikler

AllowClientInsertModels

Betiklenemez
Paralel oku

Yöntemler

CreateMeshPartAsync

Bekletir

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

meshId: ContentId

Mesh varlık kimliği.

Varsayılan değer: ""
collisionFidelity: Enum.CollisionFidelity
Varsayılan değer: ""
renderFidelity: Enum.RenderFidelity
Varsayılan değer: ""

Dönüşler

Yeni MeshPart durum.

GetFreeDecals

Bekletir

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

searchText: string

Katalogücretsiz resimler aramak için kullanılan dize.

Varsayılan değer: ""
pageNum: number

Geri dönmek için Kataloğun sayfa numarası.

Varsayılan değer: ""

Dönüşler

Tek bir tablo (geri döndürülen ücretsiz çizimler) bir tabloya sarılmış.

Kod Örnekleri

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

Bekletir

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

searchText: string

Katalogücretsiz resimler aramak için kullanılan dize.

Varsayılan değer: ""
pageNum: number

Geri dönmek için Kataloğun sayfa numarası.

Varsayılan değer: ""

Dönüşler

Tek bir tablo (geri döndürülen ücretsiz modeller) bir tabloya sarılmış.

Kod Örnekleri

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

Bekletir

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

assetId: number
Varsayılan değer: ""

Dönüşler

LoadAsset

Bekletir

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

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:

Parametreler

assetId: number

Yüklenen varlığın varlık kimliği.

Varsayılan değer: ""

Dönüşler

Yüklü varlığın bir örneği.

Kod Örnekleri

InsertService:LoadAsset

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

LoadAssetVersion

Bekletir

Varlığı verilen assetVersionId ile içeren bir modeli InsertService içine döndürür.

Parametreler

assetVersionId: number
Varsayılan değer: ""

Dönüşler

Kod Örnekleri

InsertService:LoadAssetVersion

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

Etkinlikler