La fonctionnalité Photo-à-Avatar est actuellement en alpha. Veuillez consulter l' annonce DevForum pour les dernières informations.
Le guide suivant s'applique aux créateurs qui sont familiers avec le scripting et Roblox Studio et qui ont l'intention de développer des jeux permettant des objets d'avatar générés par les utilisateurs.
Vous pouvez créer un jeu qui permet aux joueurs de générer un personnage d'avatar entièrement fonctionnel en utilisant une photo et un texte prompt.
Ce processus implique les étapes suivantes :
- Demander une session de génération d'Avatar
- Inviter l'utilisateur à prendre un selfie et générer une image de prévisualisation 2D de l'avatar
- Générer le personnage Avatar complet en utilisant HumanoidDescription
Demander une session de génération d'Avatar
Pour commencer une génération photo-à-avatar, appelez AvatarCreationService:RequestAvatarGenerationSessionAsync() depuis le serveur pour demander une session pour le joueur. Une session fournit à un Player un certain nombre de prévisualisations d'Avatar et de générations d'Avatar.
Comme cela peut prendre un certain temps pour qu'une session soit disponible, AvatarCreationService:RequestAvatarGenerationSessionAsync() renvoie une RBXScriptConnection et un waitTime en secondes. Le waitTime peut être utilisé pour fournir au Player des informations sur le temps qu'il faudra pour qu'il puisse commencer ses générations.
Une fois qu'une session est prête, le rappel est invoqué avec un Dictionary d'informations sur la session. Le Dictionary comprend :
- SessionId — passé comme un argument lors de l'appel à AvatarCreationService:GenerateAvatar2DPreviewAsync() et AvatarCreationService:GenerateAvatarAsync()
- Allowed2DGenerations — le nombre de générations de prévisualisations 2D autorisées dans une session
- Allowed3DGenerations — le nombre de générations d'avatar 3D autorisées dans une session
- SessionTime — le temps maximum pour une session en secondes
Inviter à prendre un selfie et générer une prévisualisation 2D
Après le démarrage d'une session, invitez l'utilisateur à prendre un selfie et obtenez le fileId string en appelant la méthode AvatarCreationService:PromptSelectAvatarGenerationImageAsync() sur le serveur. Ce fileId sera passé à la méthode AvatarCreationService:GenerateAvatar2DPreviewAsync().
Pour créer une image de prévisualisation 2D de l'Avatar, appelez les méthodes suivantes :
- AvatarCreationService:GenerateAvatar2DPreviewAsync() sur le serveur
- AvatarCreationService:LoadAvatar2DPreviewAsync() sur le client
La méthode AvatarCreationService:GenerateAvatar2DPreviewAsync() prend le SessionId, le fileId et un texte prompt optionnel en entrée pour générer une prévisualisation 2D de l'Avatar. Cette méthode renvoie un previewId.
Ce previewId doit être envoyé au client et peut ensuite être utilisé pour récupérer la prévisualisation en tant que EditableImage.
Si l'utilisateur n'est pas satisfait de la prévisualisation générée, ce flux de travail peut être répété.
Générer l'avatar 3D
Une fois que l'utilisateur est satisfait de la prévisualisation, vous pouvez générer le personnage d'avatar 3D complet.
Pour générer un personnage d'avatar :
- Appelez AvatarCreationService:GenerateAvatarAsync() sur le serveur avec un Dictionary contenant le SessionId et le PreviewId.
- Cet appel de méthode renvoie un string generationId.
- Récupérez les données de l'avatar généré en tant que HumanoidDescription en utilisant la méthode AvatarCreationService:LoadGeneratedAvatarAsync() à la fois sur le serveur de jeu et le client.
- Vous pouvez utiliser la méthode Players.CreateHumanoidModelFromDescription pour créer un modèle d'avatar à partir de la HumanoidDescription à afficher au Player.
Les ressources de maillage et de texture seront fournies en tant qu'objets EditableMesh et EditableImage, respectivement, pour permettre une édition continue de l'avatar généré. Les modifications doivent être apportées à la fois sur le serveur de jeu et sur la copie client pour les maintenir synchronisées pour la publication.
Publier
Si l'utilisateur est satisfait de l'avatar résultant, il peut être publié en utilisant la méthode AvatarCreationService:PromptCreateAvatarAsync().
Pour plus de détails, consultez la création en jeu.