Meer informatie
Engine-klasse
AvatarCreationService
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

Overgenomen leden

API-referentie
Methoden
AutoSetupAvatarAsync
Opbrengst
Mogelijkheden: DynamicGeneration
AvatarCreationService:AutoSetupAvatarAsync(
player:Player, autoSetupParams:Dictionary, progressCallback:function?
Parameters
player:Player
autoSetupParams:Dictionary
progressCallback:function?
Teruggaves
Codevoorbeelden
AutoSetupAvatarAsync
local AvatarCreationService = game:GetService("AvatarCreationService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local LoadAvatarEvent = ReplicatedStorage.LoadAvatarEvent
local generatedAvatars = {}
-- Moet op de server worden aangeroepen
local function setupAvatar(player: Player, avatarModel: Model, layeredShirtModel : Model)
local arguments = {
Body = avatarModel,
Accessories = {}
}
local accessoryArgument = {
AccessoryType = Enum.AccessoryType.Shirt,
IsLayered = true,
Instance = layeredShirtModel,
}
table.insert(arguments.Accessories, accessoryArgument)
local pcallSuccess, result = pcall(function()
local generationId = AvatarCreationService:AutoSetupAvatarAsync(
player,
arguments,
function(progressInfo)
print(`AutoSetup voortgang: {progressInfo.Progress * 100}%`)
end
)
-- Laad en sla op de server op om te gebruiken met PromptCreateAvatarAsync
local humanoidDescription = AvatarCreationService:LoadGeneratedAvatarAsync(generationId)
generatedAvatars[generationId] = humanoidDescription
-- Signaal de client zodat deze de avatar voor lokale preview kan laden
LoadAvatarEvent:FireClient(player, generationId)
end)
if not pcallSuccess then
warn("Avatar setup is mislukt:", result)
end
end

GenerateAvatar2DPreviewAsync
Opbrengst
Mogelijkheden: DynamicGeneration
AvatarCreationService:GenerateAvatar2DPreviewAsync(
avatarGeneration2dPreviewParams:Dictionary, progressCallback:function?
Parameters
avatarGeneration2dPreviewParams:Dictionary
progressCallback:function?
Teruggaves
Codevoorbeelden
Genereer Avatar2 D Voorbeeld Async
local AvatarCreationService = game:GetService("AvatarCreationService")
function generateAvatar2DPreview(sessionId, fileId, textPrompt)
local pcallSuccess, result = pcall(function()
local args = {}
args.SessionId = sessionId
args.FileId = fileId
args.TextPrompt = textPrompt
return AvatarCreationService:GenerateAvatar2DPreviewAsync(args)
end)
if not pcallSuccess then
warn("Het genereren van 2D voorbeeld is mislukt: ", result)
end
return result
end

GenerateAvatarAsync
Opbrengst
Mogelijkheden: DynamicGeneration
AvatarCreationService:GenerateAvatarAsync(
avatarGenerationParams:Dictionary, progressCallback:function?
Parameters
avatarGenerationParams:Dictionary
progressCallback:function?
Teruggaves
Codevoorbeelden
Genereer Avatar Async
local AvatarCreationService = game:GetService("AvatarCreationService")
function generateAvatar(sessionId, previewId)
local pcallSuccess, result = pcall(function()
local args = {}
args.SessionId = sessionId
args.PreviewId = previewId
return AvatarCreationService:GenerateAvatarAsync(args)
end)
if not pcallSuccess then
warn("Het genereren van de avatar is mislukt: ", result)
end
return result
end

GetBatchTokenDetailsAsync
Opbrengst
Mogelijkheden: Monetization
AvatarCreationService:GetBatchTokenDetailsAsync(tokenIds:{any}):{any}
Parameters
tokenIds:{any}
Teruggaves

GetValidationRules
AvatarCreationService:GetValidationRules():Dictionary
Teruggaves

LoadAvatar2DPreviewAsync
Opbrengst
Mogelijkheden: DynamicGeneration
AvatarCreationService:LoadAvatar2DPreviewAsync(previewId:string):EditableImage
Parameters
previewId:string
Teruggaves
Codevoorbeelden
Laad Avatar2 D Voorbeeld Async
local AvatarCreationService = game:GetService("AvatarCreationService")
function loadAvatar2DPreview(previewId)
local pcallSuccess, result = pcall(function()
return AvatarCreationService:LoadAvatar2DPreviewAsync(previewId)
end)
if not pcallSuccess then
warn("Kon voorbeeld niet laden: ", result)
end
return result
end

LoadGeneratedAvatarAsync
Opbrengst
Mogelijkheden: DynamicGeneration
AvatarCreationService:LoadGeneratedAvatarAsync(generationId:string):HumanoidDescription
Parameters
generationId:string
Codevoorbeelden
LaadGegenereerdeAvatarAsync
local AvatarCreationService = game:GetService("AvatarCreationService")
local Players = game:GetService("Players")
-- Kan zowel op de server als op de client worden aangeroepen
local function loadAvatar(generationId: string): Model?
local pcallSuccess, result = pcall(function()
local humanoidDescription = AvatarCreationService:LoadGeneratedAvatarAsync(generationId)
local model = Players:CreateHumanoidModelFromDescriptionAsync(humanoidDescription, Enum.HumanoidRigType.R15)
return model
end)
if pcallSuccess then
return result
else
print("Avatar kon niet worden geladen:", result)
return nil
end
end

PrepareAvatarForPreviewAsync
Opbrengst
Mogelijkheden: AvatarAppearance
AvatarCreationService:PrepareAvatarForPreviewAsync(humanoidModel:Model):()
Parameters
humanoidModel:Model
Teruggaves
()

PromptCreateAvatarAssetAsync
Opbrengst
AvatarCreationService:PromptCreateAvatarAssetAsync(
tokenId:string, player:Player, assetInstance:Instance, assetType:Enum.AvatarAssetType
Parameters
tokenId:string
player:Player
assetInstance:Instance
Teruggaves
Codevoorbeelden
PromptCreateAvatarAssetAsync
local AvatarCreationService = game:GetService("AvatarCreationService")
local function publishAvatarAsset(tokenId: string, player: Player, assetInstance: Accessory, assetType: Enum.AvatarAssetType)
local pcallSuccess, result, resultMessage = pcall(function()
return AvatarCreationService:PromptCreateAvatarAssetAsync(tokenId, player, assetInstance, assetType)
end)
if pcallSuccess then
if result == Enum.PromptCreateAssetResult.Success then
print("Succesvol geüpload met AssetId: ", resultMessage)
else
print("Onsuccesvol geüpload met foutmelding:", resultMessage)
end
else
print("Avatar asset kon niet worden gemaakt.")
end
end

PromptCreateAvatarAsync
Opbrengst
Mogelijkheden: AssetCreateUpdate, Monetization
AvatarCreationService:PromptCreateAvatarAsync(
tokenId:string, player:Player, humanoidDescription:HumanoidDescription
Parameters
tokenId:string
player:Player
humanoidDescription:HumanoidDescription
Teruggaves
Codevoorbeelden
PromptCreateAvatarAsync
local AvatarCreationService = game:GetService("AvatarCreationService")
export type BodyPartInfo = {
bodyPart: Enum.BodyPart,
instance: Instance, --Map met gemaakte MeshParts
}
export type BodyPartList = { BodyPartInfo }
local function publishAvatar(bodyPartInstances: BodyPartList, player: Player, tokenId: string)
local humanoidDescription = Instance.new("HumanoidDescription")
for _, bodyPartInfo in bodyPartInstances do
local bodyPartDescription = Instance.new("BodyPartDescription")
bodyPartDescription.Instance = bodyPartInfo.instance
bodyPartDescription.BodyPart = bodyPartInfo.bodyPart
bodyPartDescription.Parent = humanoidDescription
end
local pcallSuccess, result, resultMessage = pcall(function()
return AvatarCreationService:PromptCreateAvatarAsync(tokenId, player, humanoidDescription)
end)
if pcallSuccess then
if result == Enum.PromptCreateAvatarResult.Success then
print("Succesvol geüpload met BundleId: ", resultMessage)
else
print("Onsuccesvol geüpload met foutmelding:", resultMessage)
end
else
print("Avatar kon niet worden gemaakt.")
end
end

PromptCreateMakeupAsync
Opbrengst
Mogelijkheden: AssetCreateUpdate, Monetization
AvatarCreationService:PromptCreateMakeupAsync(
player:Player, makeupAssetEntries:{any}, thumbnailHeadColor:Color3?
Parameters
player:Player
makeupAssetEntries:{any}
thumbnailHeadColor:Color3?
Standaardwaarde: nil
Teruggaves

PromptSelectAvatarGenerationImageAsync
Opbrengst
Mogelijkheden: SensitiveInput
AvatarCreationService:PromptSelectAvatarGenerationImageAsync(player:Player):string
Parameters
player:Player
Teruggaves

RequestAvatarGenerationSessionAsync
Opbrengst
Mogelijkheden: DynamicGeneration
AvatarCreationService:RequestAvatarGenerationSessionAsync(
player:Player, callback:function
Parameters
player:Player
callback:function
Teruggaves
Codevoorbeelden
Vraag Avatar Generatie Sessie Async
local AvatarCreationService = game:GetService("AvatarCreationService")
local playerSessions = {}
local playerSessionRequests = {}
function requestAvatarGenerationSession(player)
local pcallSuccess, conn, waitTime = pcall(function()
return AvatarCreationService:RequestAvatarGenerationSessionAsync(player, function(sessionInfo)
playerSessions[player.UserID] = sessionInfo
playerSessionRequests[player.UserID] = nil
end)
end)
if not pcallSuccess then
warn("Mislukt om Avatar generatie sessie aan te vragen: ", conn)
end
playerSessionRequests[player.UserID] = conn
print("Wachtijd voor sessie: ", tostring(waitTime))
end
function cancelAvatarGenerationSessionRequest(player)
if playerSessionRequests[player.UserID] ~= nil then
playerSessionRequests[player.UserID]:Disconnect()
end
end

ValidateUGCAccessoryAsync
Opbrengst
AvatarCreationService:ValidateUGCAccessoryAsync(
player:Player, accessory:Instance, accessoryType:Enum.AccessoryType
Parameters
player:Player
accessory:Instance
accessoryType:Enum.AccessoryType
Teruggaves

ValidateUGCBodyPartAsync
Opbrengst
AvatarCreationService:ValidateUGCBodyPartAsync(
player:Player, instance:Instance, bodyPart:Enum.BodyPart
Parameters
player:Player
instance:Instance
bodyPart:Enum.BodyPart
Teruggaves

ValidateUGCFullBodyAsync
Opbrengst
AvatarCreationService:ValidateUGCFullBodyAsync(
player:Player, humanoidDescription:HumanoidDescription
Parameters
player:Player
humanoidDescription:HumanoidDescription
Teruggaves

Evenementen
AvatarAssetModerationCompleted
Mogelijkheden: DynamicGeneration
AvatarCreationService.AvatarAssetModerationCompleted(
assetId:number, moderationStatus:Enum.ModerationStatus
Parameters
assetId:number
moderationStatus:Enum.ModerationStatus
Codevoorbeelden
Moderatie van Avatar Assets Voltooid
local AvatarCreationService = game:GetService("AvatarCreationService")
local conn = AvatarCreationService.AvatarAssetModerationCompleted:Connect(function(assetId, moderationStatus)
print("Asset, " .. assetId .. ", klaar met moderatiestatus: " .. moderationStatus)
end)

AvatarModerationCompleted
Verouderd

AvatarOutfitModerationCompleted
Mogelijkheden: DynamicGeneration
AvatarCreationService.AvatarOutfitModerationCompleted(
outfitId:number, moderationStatus:Enum.ModerationStatus, outfitType:Enum.OutfitType
Parameters
outfitId:number
moderationStatus:Enum.ModerationStatus
outfitType:Enum.OutfitType

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