La función de generación de foto a avatar está actualmente en alfa. Para obtener la información más reciente, consulte el anuncio del DevForum.
La siguiente guía se aplica a los creadores que están familiarizados con la programación y Roblox Studio y que tienen la intención de desarrollar juegos que permitan elementos de avatar generados por los usuarios.
Puedes crear un juego que permita a los jugadores generar un personaje de avatar completamente funcional utilizando una foto y un mensaje de texto.
Este proceso implica los siguientes pasos:
- Solicitar una sesión de generación de avatar.
- Invitar al usuario a tomarse una selfie y generar una imagen de vista previa 2D del avatar.
- Generar el personaje de avatar completo utilizando HumanoidDescription.
Solicitar una sesión de generación de avatar
Para comenzar una generación de foto a avatar, llama a AvatarCreationService:RequestAvatarGenerationSessionAsync() desde el servidor para solicitar una sesión para el jugador. Una sesión proporciona a un Player un cierto número de vistas previas de avatar y generaciones de avatar.
Dado que puede tardar un tiempo en que una sesión esté disponible, AvatarCreationService:RequestAvatarGenerationSessionAsync() devuelve una RBXScriptConnection y un tiempo de espera en segundos. El tiempo de espera se puede utilizar para proporcionar al Player información sobre cuánto tiempo tardará en poder comenzar sus generaciones.
Una vez que una sesión esté lista, se invoca la devolución de llamada con un Dictionary de información sobre la sesión. El Dictionary incluye:
- SessionId — Pasado como un argumento al llamar a AvatarCreationService:GenerateAvatar2DPreviewAsync() y AvatarCreationService:GenerateAvatarAsync().
- Allowed2DGenerations — El número de generaciones de vista previa 2D permitidas en una sesión.
- Allowed3DGenerations — El número de generaciones de avatar permitidas en una sesión.
- SessionTime — El tiempo máximo para una sesión en segundos.
Invitar a tomarse una selfie y generar una vista previa 2D
Después de que se inicie una sesión, invita al usuario a tomarse una selfie y obtener el fileId string llamando al método AvatarCreationService:PromptSelectAvatarGenerationImageAsync() en el servidor. Este fileId se pasará al método AvatarCreationService:GenerateAvatar2DPreviewAsync().
Para crear una imagen de vista previa 2D del avatar, llama a los siguientes métodos:
- AvatarCreationService:GenerateAvatar2DPreviewAsync() en el servidor.
- AvatarCreationService:LoadAvatar2DPreviewAsync() en el cliente.
El método AvatarCreationService:GenerateAvatar2DPreviewAsync() toma el SessionId, fileId y un mensaje de texto opcional como entrada para generar una vista previa 2D del avatar. Este método devuelve un previewId.
Este previewId debe enviarse al cliente y luego puede usarse para recuperar la vista previa como un EditableImage.
Si el usuario no está satisfecho con la vista previa generada, este flujo de trabajo se puede repetir.
Generar el avatar
Una vez que el usuario esté satisfecho con la vista previa, puedes generar el personaje de avatar 3D completo.
Para generar un personaje de avatar:
- Llama a AvatarCreationService:GenerateAvatarAsync() en el servidor con un Dictionary que contenga el SessionId y PreviewId.
- Esta llamada al método devuelve un string generationId.
- Recupera los datos del avatar generado como un HumanoidDescription utilizando el método AvatarCreationService:LoadGeneratedAvatarAsync() tanto en el servidor del juego como en el cliente.
- Utiliza el método Players.CreateHumanoidModelFromDescription para crear un modelo de avatar a partir de la HumanoidDescription para mostrarlo al Player.
Los activos de malla y textura se proporcionan como objetos EditableMesh y EditableImage, respectivamente, para permitir la edición continua del avatar generado. Las ediciones deben realizarse tanto en el servidor del juego como en la copia del cliente para mantenerlas sincronizadas para la publicación.
Publicar el avatar
Si el usuario está satisfecho con el avatar resultante, se puede publicar utilizando el método AvatarCreationService:PromptCreateAvatarAsync().
Para obtener más información, consulte creación en el juego.