Meer informatie
Engine-klasse
AssetService
Niet maakbaar
Service

*Deze inhoud is vertaald met behulp van AI (bèta) en kan fouten bevatten. Klik hier om deze pagina in het Engels te bekijken.


Samenvatting

Methoden
ComposeDecalAsync(decal: Decal,layers: {any}):()
CreateAssetAsync(object: Object,assetType: Enum.AssetType,requestParameters: Dictionary):Tuple
CreateAssetVersionAsync(object: Object,assetType: Enum.AssetType,assetId: number,requestParameters: Dictionary):Tuple
CreateEditableImageAsync(content: Content,editableImageOptions: Dictionary?):EditableImage
CreateEditableMeshAsync(content: Content,editableMeshOptions: Dictionary?):EditableMesh
CreatePlaceAsync(placeName: string,templatePlaceID: number,description: string):number
CreatePlaceInPlayerInventoryAsync(player: Instance,placeName: string,templatePlaceID: number,description: string):number
Verouderd
GetAssetIdsForPackage(packageAssetId: number):{any}
Verouderd
GetComposedDecalLayers(decal: Decal):{ { [string]: Content | Vector2 } }
GetCreatorAssetID(creationID: number):number
Verouderd
SavePlaceAsync(requestParameters: Dictionary?):()
SearchAudio(searchParameters: AudioSearchParams):AudioPages
Verouderd
Overgenomen leden

API-referentie
Eigenschappen
AllowInsertFreeAssets
Roblox-scriptbeveiliging
Parallel lezen
AssetService.AllowInsertFreeAssets:boolean

Methoden
ComposeDecalAsync
Opbrengst
AssetService:ComposeDecalAsync(
decal:Decal, layers:{any}
):()
Parameters
decal:Decal
layers:{any}
Teruggaves
()
Codevoorbeelden
Een Decal Samenstellen
local AssetService = game:GetService("AssetService")
-- Maak twee decal-instanties aan
local decalA = Instance.new("Decal")
local decalB = Instance.new("Decal")
-- Bouw de samengestelde info-tabel
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,
}
}
-- Maak een decal om op samen te stellen
local compositeDecal = Instance.new("Decal")
-- Stel een bestaande decal samen met behulp van AssetService
local success, errorMessage = pcall(function()
AssetService:ComposeDecalAsync(compositeDecal, compositeInfo)
end)
if success then
print("Decal succesvol samengesteld!")
-- Logica om de decal te tonen/gebruiken gaat hier
else
warn("Samenstellen van decal mislukt:", errorMessage)
end

CreateAssetAsync
Opbrengst
Mogelijkheden: AssetCreateUpdate
AssetService:CreateAssetAsync(
object:Object, assetType:Enum.AssetType, requestParameters:Dictionary
Parameters
object:Object
assetType:Enum.AssetType
requestParameters:Dictionary
Standaardwaarde: nil
Teruggaves
Codevoorbeelden
AssetService:CreateAssetAsync
local AssetService = game:GetService("AssetService")
local editableMesh = AssetService:CreateEditableMesh()
-- voeg vertices, vlakken en uvs toe aan de mesh
local requestParameters = {
CreatorId = 123,
CreatorType = Enum.AssetCreatorType.User,
Name = "Mijn asset",
Description = "een goede asset",
}
local ok, result, idOrUploadErr = pcall(function()
return AssetService:CreateAssetAsync(editableMesh, Enum.AssetType.Mesh, requestParameters)
end)
if not ok then
warn(`fout bij het aanroepen van CreateAssetAsync: {result}`)
elseif result == Enum.CreateAssetResult.Success then
print(`succes, nieuwe asset ID: {idOrUploadErr}`)
else
warn(`uploadfout in CreateAssetAsync: {result}, {idOrUploadErr}`)
end

CreateAssetVersionAsync
Opbrengst
Mogelijkheden: AssetCreateUpdate
AssetService:CreateAssetVersionAsync(
object:Object, assetType:Enum.AssetType, assetId:number, requestParameters:Dictionary
Parameters
object:Object
assetType:Enum.AssetType
assetId:number
requestParameters:Dictionary
Standaardwaarde: nil
Teruggaves
Codevoorbeelden
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(`fout bij het aanroepen van CreateAssetVersionAsync: {result}`)
elseif result == Enum.CreateAssetResult.Success then
print(`succes, nieuwe assetversie: {versionOrUploadErr}`)
else
warn(`uploadfout in CreateAssetVersionAsync: {result}, {versionOrUploadErr}`)
end

CreateDataModelContentAsync
Opbrengst
Mogelijkheden: DynamicGeneration
AssetService:CreateDataModelContentAsync(
content:Content, options:Dictionary?
Parameters
content:Content
options:Dictionary?
Teruggaves

CreateDecalAsync
Opbrengst
Mogelijkheden: Basic
AssetService:CreateDecalAsync(content:Dictionary):Decal
Parameters
content:Dictionary
Teruggaves

CreateEditableImage
Mogelijkheden: DynamicGeneration
AssetService:CreateEditableImage(editableImageOptions:Dictionary?):EditableImage
Parameters
editableImageOptions:Dictionary?
Teruggaves

CreateEditableImageAsync
Opbrengst
Mogelijkheden: AssetRead
AssetService:CreateEditableImageAsync(
content:Content, editableImageOptions:Dictionary?
Parameters
content:Content
editableImageOptions:Dictionary?
Teruggaves

CreateEditableMesh
Mogelijkheden: DynamicGeneration
AssetService:CreateEditableMesh(editableMeshOptions:Dictionary?):EditableMesh
Parameters
editableMeshOptions:Dictionary?
Teruggaves

CreateEditableMeshAsync
Opbrengst
Mogelijkheden: AssetRead
AssetService:CreateEditableMeshAsync(
content:Content, editableMeshOptions:Dictionary?
Parameters
content:Content
editableMeshOptions:Dictionary?
Teruggaves

CreateMeshPartAsync
Opbrengst
Mogelijkheden: Basic
AssetService:CreateMeshPartAsync(
meshContent:Content, options:Dictionary
Parameters
meshContent:Content
options:Dictionary
Standaardwaarde: nil
Teruggaves

CreatePlaceAsync
Opbrengst
Mogelijkheden: AssetCreateUpdate
AssetService:CreatePlaceAsync(
placeName:string, templatePlaceID:number, description:string
Parameters
placeName:string
templatePlaceID:number
description:string
Teruggaves

CreatePlaceInPlayerInventoryAsync
Verouderd

CreateSurfaceAppearanceAsync
Opbrengst
Mogelijkheden: Basic
AssetService:CreateSurfaceAppearanceAsync(content:Dictionary):SurfaceAppearance
Parameters
content:Dictionary
Codevoorbeelden
AssetService:CreateSurfaceAppearanceAsync
local AssetService = game:GetService("AssetService")
local Workspace = game:GetService("Workspace")
-- Groene kleur - Bewerkbare afbeelding inhoud
local colorEditableImage = AssetService:CreateEditableImage({ Size = Vector2.new(4, 4) })
colorEditableImage:DrawRectangle(Vector2.zero, colorEditableImage.Size, Color3.fromRGB(0, 255, 0), 0, Enum.ImageCombineType.Overwrite)
-- Emissief (kijk alleen naar het rode kanaal) - DataModel-inhoud
local mapSize = 128
local quarterMapSize = mapSize / 4
local emissiveEditableImage = AssetService:CreateEditableImage({ Size = Vector2.new(mapSize, mapSize) })
-- Maak een cirkelpatroon door de hele achtergrond een emissieve waarde van 0 te geven, en twee cirkels aan tegenovergestelde zijden een emissieve waarde van 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)
-- Metaalheid (kijk alleen naar het rode kanaal) - Asset ID-inhoud
local METALNESS_ASSET_ID = "rbxassetid://658743164"
local surfaceAppearance = AssetService:CreateSurfaceAppearanceAsync({
ColorMap = Content.fromObject(colorEditableImage),
EmissiveMask = emissiveDataModelContent,
MetalnessMap = Content.fromUri(METALNESS_ASSET_ID)
})
-- Je kunt nog steeds de meeste eigenschappen wijzigen, behalve de inhoud die voor de kaarten en EmissiveMask wordt gebruikt.
surfaceAppearance.EmissiveStrength = 20
local meshPart = AssetService:CreateMeshPartAsync(Content.fromAssetId(16799342206))
meshPart.Parent = Workspace
meshPart.Anchored = true
meshPart.Position = Vector3.new(0, 2, 0)
-- Pas het oppervlakverschijning toe op het meshdeel
surfaceAppearance.Parent = meshPart

GetAssetIdsForPackage
Verouderd

GetAssetIdsForPackageAsync
Opbrengst
Mogelijkheden: AssetRead
AssetService:GetAssetIdsForPackageAsync(packageAssetId:number):{any}
Parameters
packageAssetId:number
Teruggaves

GetAudioMetadataAsync
Opbrengst
Mogelijkheden: AssetRead
AssetService:GetAudioMetadataAsync(idList:{any}):{any}
Parameters
idList:{any}
Teruggaves
Codevoorbeelden
Haal Audio Metadata Op
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, "door", result[i].Artist)
else
warn("Geen metadata opgehaald voor aangevraagd asset #" .. tostring(i))
end
end
end

GetBundleDetailsAsync
Opbrengst
Mogelijkheden: AssetRead
AssetService:GetBundleDetailsAsync(bundleId:number):Dictionary
Parameters
bundleId:number
Teruggaves
Codevoorbeelden
Bundlegegevens ophalen
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"] = "Het jaar is 5003, Battlebot 5000 moet zijn machtigste vijand onder ogen zien, of het risico lopen verouderd te worden.",
["Id"] = 14,
["Items"] = {
[1] = {...},
[2] = {
["Id"] = 1678225030,
["Name"] = "SinisterBot 5001 Linkerarm",
["Type"] = "Asset"
},
[3] = {...},
[4] = {...},
[5] = {...},
[6] = {...},
[7] = {...}
},
["Name"] = "SinisterBot 5001"
}
--]]
end

GetComposedDecalLayers
Mogelijkheden: PluginOrOpenCloud
AssetService:GetComposedDecalLayers(decal:Decal):{ { [string]: Content | Vector2 } }
Parameters
decal:Decal
Teruggaves
{ { [string]: Content | Vector2 } }
Codevoorbeelden
Kopieer een Samengestelde Decal
local AssetService = game:GetService("AssetService")
local Workspace = game:GetService("Workspace")
local sourceDecal = Workspace.Part.Decal
-- Lees de laagstapel die ComposeDecalAsync op de decal heeft opgeslagen
local layers = AssetService:GetComposedDecalLayers(sourceDecal)
if #layers == 0 then
print("Deze decal is niet samengesteld")
return
end
for index, layer in layers do
print("Laag", index, "KleurMap:", layer.ColorMap)
end
-- De lagen gebruiken het formaat dat ComposeDecalAsync accepteert, zodat ze weer aan het worden kunnen worden doorgegeven
local copy = Instance.new("Decal")
local success, errorMessage = pcall(function()
AssetService:ComposeDecalAsync(copy, layers)
end)
if success then
copy.Parent = sourceDecal.Parent
else
warn("Mislukt om decal samen te stellen:", errorMessage)
end

GetCreatorAssetID
Verouderd

GetGamePlacesAsync
Opbrengst
Mogelijkheden: AssetRead
AssetService:GetGamePlacesAsync():Instance
Teruggaves
Codevoorbeelden
AssetService:GetGamePlacesAsync
local AssetService = game:GetService("AssetService")
local placePages = AssetService:GetGamePlacesAsync()
while true do
for _, place in placePages:GetCurrentPage() do
print("Naam:", place.Name)
print("PlaatsId:", place.PlaceId)
end
if placePages.IsFinished then
break
end
placePages:AdvanceToNextPageAsync()
end

LoadAssetAsync
Opbrengst
Mogelijkheden: LoadUnownedAsset
AssetService:LoadAssetAsync(assetId:number):Instance
Parameters
assetId:number
Teruggaves

PromptCreatePlatformContentAsync
Opbrengst
Mogelijkheden: AssetCreateUpdate
AssetService:PromptCreatePlatformContentAsync(
player:Player, object:Object, assetType:Enum.AssetType
Parameters
player:Player
object:Object
assetType:Enum.AssetType
Teruggaves

PromptImportAnimationClipFromVideoAsync
Opbrengst
Mogelijkheden: AssetManagement
AssetService:PromptImportAnimationClipFromVideoAsync(
player:Player, progressCallback:function
Parameters
player:Player
progressCallback:function
Teruggaves

SavePlaceAsync
Opbrengst
Mogelijkheden: AssetCreateUpdate
AssetService:SavePlaceAsync(requestParameters:Dictionary?):()
Parameters
requestParameters:Dictionary?
Teruggaves
()

SearchAudio
Verouderd

SearchAudioAsync
Opbrengst
Mogelijkheden: AssetRead
AssetService:SearchAudioAsync(searchParameters:AudioSearchParams):AudioPages
Parameters
searchParameters:AudioSearchParams
Teruggaves
Codevoorbeelden
Muziek Zoek Titels Krijgen
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("AssetService fout: " .. result)
end
--[[ Returned data format
{
"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
}
}
--]]

©2026 Roblox Corporation. Roblox, het Roblox-logo en Powering Imagination behoren tot onze geregistreerde en niet-geregistreerde handelsmerken in de VS en andere landen.