Classe de moteur
AvatarCreationService
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
Résumé
Méthodes
Événements
AvatarAssetModerationCompleted(assetId: number,moderationStatus: Enum.ModerationStatus):RBXScriptSignal |
AvatarModerationCompleted(outfitId: number,moderationStatus: Enum.ModerationStatus):RBXScriptSignal |
Référence API
Méthodes
AutoSetupAvatarAsync
AvatarCreationService:AutoSetupAvatarAsync(
Paramètres
Retours
Échantillons de code
ConfigurationAutomatiqueAvatarAsync
local AvatarCreationService = game:GetService("AvatarCreationService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local LoadAvatarEvent = ReplicatedStorage.LoadAvatarEvent
local generatedAvatars = {}
-- Doit être appelé sur le serveur
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(`Progression d'AutoSetup: {progressInfo.Progress * 100}%`)
end
)
-- Charger et stocker sur le serveur pour utiliser avec PromptCreateAvatarAsync
local humanoidDescription = AvatarCreationService:LoadGeneratedAvatarAsync(generationId)
generatedAvatars[generationId] = humanoidDescription
-- Signaler le client pour qu'il puisse charger l'avatar pour un aperçu local
LoadAvatarEvent:FireClient(player, generationId)
end)
if not pcallSuccess then
warn("Échec de la configuration de l'avatar:", result)
end
endGenerateAvatar2DPreviewAsync
AvatarCreationService:GenerateAvatar2DPreviewAsync(
Paramètres
Retours
GenerateAvatarAsync
AvatarCreationService:GenerateAvatarAsync(
Paramètres
Retours
GetBatchTokenDetailsAsync
LoadAvatar2DPreviewAsync
Paramètres
Retours
LoadGeneratedAvatarAsync
Paramètres
Retours
Échantillons de code
ChargerAvatarGénéréAsync
local AvatarCreationService = game:GetService("AvatarCreationService")
local Players = game:GetService("Players")
-- Peut être appelé sur le serveur ou le client
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("Échec du chargement de l'avatar :", result)
return nil
end
endPrepareAvatarForPreviewAsync
PromptCreateAvatarAssetAsync
AvatarCreationService:PromptCreateAvatarAssetAsync(
Paramètres
Retours
Échantillons de code
InviteCréationAvatarActif
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("Téléchargement réussi avec AssetId: ", resultMessage)
else
print("Téléchargement échoué avec le message d'erreur:", resultMessage)
end
else
print("Échec de la création de l'actif d'avatar.")
end
endPromptCreateAvatarAsync
AvatarCreationService:PromptCreateAvatarAsync(
Paramètres
Retours
Échantillons de code
InviteCréerAvatarAsync
local AvatarCreationService = game:GetService("AvatarCreationService")
export type BodyPartInfo = {
bodyPart: Enum.BodyPart,
instance: Instance, --Dossier avec les MeshParts Créés
}
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("Téléchargement réussi avec BundleId : ", resultMessage)
else
print("Téléchargement non réussi avec message d'erreur :", resultMessage)
end
else
print("L'avatar a échoué à être créé.")
end
endPromptSelectAvatarGenerationImageAsync
RequestAvatarGenerationSessionAsync
ValidateUGCAccessoryAsync
AvatarCreationService:ValidateUGCAccessoryAsync(
Paramètres
Retours
ValidateUGCBodyPartAsync
AvatarCreationService:ValidateUGCBodyPartAsync(
Paramètres
Retours
ValidateUGCFullBodyAsync
AvatarCreationService:ValidateUGCFullBodyAsync(
Paramètres
Retours
Événements
AvatarAssetModerationCompleted
AvatarCreationService.AvatarAssetModerationCompleted(
Paramètres
Échantillons de code
local AvatarCreationService = game:GetService("AvatarCreationService")
local conn = AvatarCreationService.AvatarAssetModerationCompleted:Connect(function(assetId, moderationStatus)
print("Avoir, " .. assetId .. ", prêt avec le statut de modération : " .. moderationStatus)
end)AvatarModerationCompleted
AvatarCreationService.AvatarModerationCompleted(
Paramètres