Classe motore
AssetService
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Riepilogo
Proprietà
Metodi
Riferimento API
Proprietà
Metodi
ComposeDecalAsync
Restituzioni
()
Campioni di codice
Comporre un Decal
local AssetService = game:GetService("AssetService")
-- Crea due istanze di decal
local decalA = Instance.new("Decal")
local decalB = Instance.new("Decal")
-- Costruisci la tabella delle informazioni composite
local compositeInfo = {
{
ColorMap = decalA.ColorMapContent,
RoughnessMap = decalA.RoughnessMapContent,
MetalnessMap = decalA.MetalnessMapContent,
NormalMap = decalA.NormalMapContent,
},
{
ColorMap = Content.fromAssetId(123456),
RoughnessMap = decalB.RoughnessMapContent,
MetalnessMap = decalB.MetalnessMapContent,
NormalMap = decalB.NormalMapContent,
}
}
-- Crea un decal da comporre
local compositeDecal = Instance.new("Decal")
-- Componi un decal esistente usando AssetService
local success, errorMessage = pcall(function()
AssetService:ComposeDecalAsync(compositeDecal, compositeInfo)
end)
if success then
print("Decal composto con successo!")
-- Logica per mostrare/usare il decal va qui
else
warn("Impossibile comporre il decal:", errorMessage)
endCreateAssetAsync
AssetService:CreateAssetAsync(
Parametri
| Valore predefinito: nil |
Restituzioni
Campioni di codice
AssetService:CreateAssetAsync
local AssetService = game:GetService("AssetService")
local editableMesh = AssetService:CreateEditableMesh()
-- aggiungi vertici, facce e uvs alla mesh
local requestParameters = {
CreatorId = 123,
CreatorType = Enum.AssetCreatorType.User,
Name = "Il mio asset",
Description = "un buon asset",
}
local ok, result, idOrUploadErr = pcall(function()
return AssetService:CreateAssetAsync(editableMesh, Enum.AssetType.Mesh, requestParameters)
end)
if not ok then
warn(`errore durante la chiamata a CreateAssetAsync: {result}`)
elseif result == Enum.CreateAssetResult.Success then
print(`successo, nuovo ID asset: {idOrUploadErr}`)
else
warn(`errore di upload in CreateAssetAsync: {result}, {idOrUploadErr}`)
endCreateAssetVersionAsync
AssetService:CreateAssetVersionAsync(
Parametri
| Valore predefinito: nil |
Restituzioni
Campioni di codice
AssetService:CreateAssetVersionAsync
local AssetService = game:GetService("AssetService")
local assetIdToUpdate = 321
local model = Instance.new("Model")
local requestParameters = {
CreatorId = 123,
CreatorType = Enum.AssetCreatorType.User,
}
local ok, result, versionOrUploadErr = pcall(function()
return AssetService:CreateAssetVersionAsync(model, Enum.AssetType.Model, assetIdToUpdate, requestParameters)
end)
if not ok then
warn(`errore durante la chiamata a CreateAssetVersionAsync: {result}`)
elseif result == Enum.CreateAssetResult.Success then
print(`success, nuova versione dell'asset: {versionOrUploadErr}`)
else
warn(`errore di upload in CreateAssetVersionAsync: {result}, {versionOrUploadErr}`)
endCreateDataModelContentAsync
Parametri
Restituzioni
CreateDecalAsync
CreateEditableImage
Parametri
Restituzioni
CreateEditableImageAsync
AssetService:CreateEditableImageAsync(
Parametri
Restituzioni
CreateEditableMesh
Parametri
Restituzioni
CreateEditableMeshAsync
Parametri
Restituzioni
CreateMeshPartAsync
Parametri
| Valore predefinito: nil |
Restituzioni
CreatePlaceAsync
CreatePlaceInPlayerInventoryAsync
CreateSurfaceAppearanceAsync
Parametri
Restituzioni
Campioni di codice
AssetService:CreateSurfaceAppearanceAsync
local AssetService = game:GetService("AssetService")
local Workspace = game:GetService("Workspace")
-- Colore verde - Contenuto immagine modificabile
local colorEditableImage = AssetService:CreateEditableImage({ Size = Vector2.new(4, 4) })
colorEditableImage:DrawRectangle(Vector2.zero, colorEditableImage.Size, Color3.fromRGB(0, 255, 0), 0, Enum.ImageCombineType.Overwrite)
-- Emissivo (guarda solo il canale rosso) - Contenuto del DataModel
local mapSize = 128
local quarterMapSize = mapSize / 4
local emissiveEditableImage = AssetService:CreateEditableImage({ Size = Vector2.new(mapSize, mapSize) })
-- Crea un modello circolare facendo in modo che l'intero sfondo abbia un valore emissivo di 0, e due cerchi su lati opposti abbiano un valore emissivo di 1.
emissiveEditableImage:DrawRectangle(Vector2.zero, emissiveEditableImage.Size, Color3.new(0, 0, 0), 0, Enum.ImageCombineType.Overwrite)
emissiveEditableImage:DrawCircle(Vector2.new(quarterMapSize, quarterMapSize*3), quarterMapSize, Color3.new(1, 0, 0), 0, Enum.ImageCombineType.Overwrite)
emissiveEditableImage:DrawCircle(Vector2.new(quarterMapSize*3, quarterMapSize), quarterMapSize, Color3.new(1, 0, 0), 0, Enum.ImageCombineType.Overwrite)
local dmcResult, emissiveDataModelContent = AssetService:CreateDataModelContentAsync(Content.fromObject(emissiveEditableImage))
assert(dmcResult == Enum.CreateContentResult.Success)
-- Metallicità (guarda solo il canale rosso) - Contenuto ID asset
local METALNESS_ASSET_ID = "rbxassetid://658743164"
local surfaceAppearance = AssetService:CreateSurfaceAppearanceAsync({
ColorMap = Content.fromObject(colorEditableImage),
EmissiveMask = emissiveDataModelContent,
MetalnessMap = Content.fromUri(METALNESS_ASSET_ID)
})
-- Puoi ancora cambiare la maggior parte delle proprietà oltre al contenuto utilizzato per le mappe e EmissiveMask.
surfaceAppearance.EmissiveStrength = 20
local meshPart = AssetService:CreateMeshPartAsync(Content.fromAssetId(16799342206))
meshPart.Parent = Workspace
meshPart.Anchored = true
meshPart.Position = Vector3.new(0, 2, 0)
-- Applica l'aspetto della superficie alla parte mesh
surfaceAppearance.Parent = meshPartGetAssetIdsForPackage
GetAssetIdsForPackageAsync
GetAudioMetadataAsync
Parametri
Restituzioni
Campioni di codice
Ottieni i Metadati Audio
local AssetService = game:GetService("AssetService")
local SoundService = game:GetService("SoundService")
local trackIDs = {
SoundService.Sound1.SoundId,
SoundService.Sound2.SoundId,
SoundService.Sound3.SoundId,
SoundService.Sound4.SoundId,
}
local success, result = pcall(function()
return AssetService:GetAudioMetadataAsync(trackIDs)
end)
if success then
for i = 1, #trackIDs do
local contentId = "rbxassetid://" .. result[i].AssetId
if trackIDs[i] == contentId then
print(result[i].Title, "di", result[i].Artist)
else
warn("Nessuna metadata recuperata per l'asset richiesto #" .. tostring(i))
end
end
endGetBundleDetailsAsync
Parametri
Restituzioni
Campioni di codice
Ottenere i dettagli del pacchetto
local AssetService = game:GetService("AssetService")
local BUNDLE_ID = 14
local success, result = pcall(function()
return AssetService:GetBundleDetailsAsync(BUNDLE_ID)
end)
if success then
print(result)
--[[
{
["BundleType"] = "BodyParts",
["Description"] = "L'anno è 5003, Battlebot 5000 deve affrontare il suo avversario più temibile, o rischiare di diventare obsoleto.",
["Id"] = 14,
["Items"] = {
[1] = {...},
[2] = {
["Id"] = 1678225030,
["Name"] = "SinisterBot 5001 Braccio Sinistro",
["Type"] = "Asset"
},
[3] = {...},
[4] = {...},
[5] = {...},
[6] = {...},
[7] = {...}
},
["Name"] = "SinisterBot 5001"
}
--]]
endGetComposedDecalLayers
Parametri
Restituzioni
{ { [string]: Content | Vector2 } }
Campioni di codice
Copia un Decal Composto
local AssetService = game:GetService("AssetService")
local Workspace = game:GetService("Workspace")
local sourceDecal = Workspace.Part.Decal
-- Leggi lo stack dei livelli che ComposeDecalAsync ha memorizzato sul decal
local layers = AssetService:GetComposedDecalLayers(sourceDecal)
if #layers == 0 then
print("Questo decal non è composto")
return
end
for index, layer in layers do
print("Livello", index, "ColorMap:", layer.ColorMap)
end
-- I livelli usano il formato che ComposeDecalAsync accetta, quindi possono essere passati di nuovo a esso
local copy = Instance.new("Decal")
local success, errorMessage = pcall(function()
AssetService:ComposeDecalAsync(copy, layers)
end)
if success then
copy.Parent = sourceDecal.Parent
else
warn("Impossibile comporre il decal:", errorMessage)
endGetCreatorAssetID
GetGamePlacesAsync
Restituzioni
Campioni di codice
AssetService:GetGamePlacesAsync
local AssetService = game:GetService("AssetService")
local placePages = AssetService:GetGamePlacesAsync()
while true do
for _, place in placePages:GetCurrentPage() do
print("Nome:", place.Name)
print("PlaceId:", place.PlaceId)
end
if placePages.IsFinished then
break
end
placePages:AdvanceToNextPageAsync()
endLoadAssetAsync
PromptCreatePlatformContentAsync
AssetService:PromptCreatePlatformContentAsync(
Parametri
Restituzioni
PromptImportAnimationClipFromVideoAsync
SavePlaceAsync
Parametri
Restituzioni
()
SearchAudio
SearchAudioAsync
Parametri
Restituzioni
Campioni di codice
Ottenere i Titoli di Ricerca Musicale
local AssetService = game:GetService("AssetService")
local audioSearchParams = Instance.new("AudioSearchParams")
audioSearchParams.SearchKeyword = "happy"
local success, result = pcall(function()
return AssetService:SearchAudioAsync(audioSearchParams)
end)
if success then
local currentPage = result:GetCurrentPage()
for _, audio in currentPage do
print(audio.Title)
end
else
warn("Errore di AssetService: " .. result)
end
--[[ Formato dei dati restituiti
{
"AudioType": string,
"Artist": string,
"Title": string,
"Tags": {
"string"
},
"Id": number,
"IsEndorsed": boolean,
"Description": string,
"Duration": number,
"CreateTime": string,
"UpdateTime": string,
"Creator": {
"Id": number,
"Name": string,
"Type": number,
"IsVerifiedCreator": boolean
}
}
--]]