La funzione di generazione di avatar da foto è attualmente in alpha. Per le informazioni più recenti, vedere l'annuncio del DevForum.
La seguente guida si applica ai creatori che sono familiari con la programmazione e Roblox Studio e intendono sviluppare giochi che consentono oggetti avatar generati dagli utenti.
Puoi creare un gioco che consente ai giocatori di generare un personaggio avatar completamente funzionale utilizzando una foto e un testo di invito.
Questo processo prevede i seguenti passaggi:
- Richiedere una sessione di generazione dell'avatar.
- Invitare l'utente a scattare un selfie e generare un'immagine di anteprima 2D dell'avatar.
- Generare il personaggio avatar completo utilizzando HumanoidDescription.
Richiedere una sessione di generazione dell'avatar
Per avviare una generazione di avatar da foto, chiama AvatarCreationService:RequestAvatarGenerationSessionAsync() dal server per richiedere una sessione per il giocatore. Una sessione fornisce a un Player un certo numero di anteprime avatar e generazioni di avatar.
Poiché potrebbe richiedere del tempo affinché una sessione diventi disponibile, AvatarCreationService:RequestAvatarGenerationSessionAsync() restituisce un RBXScriptConnection e un waitTime in secondi. Il waitTime può essere utilizzato per fornire al Player informazioni su quanto tempo ci vorrà per poter iniziare le loro generazioni.
Una volta che una sessione è pronta, il callback viene invocato con un Dictionary di informazioni sulla sessione. Il Dictionary include:
- SessionId — Passato come argomento quando si chiama AvatarCreationService:GenerateAvatar2DPreviewAsync() e AvatarCreationService:GenerateAvatarAsync().
- Allowed2DGenerations — Il numero di generazioni di anteprime 2D consentite in una sessione.
- Allowed3DGenerations — Il numero di generazioni di avatar consentite in una sessione.
- SessionTime — Il tempo massimo per una sessione in secondi.
Invitare a scattare un selfie e generare un'anteprima 2D
Dopo che una sessione è stata avviata, invita l'utente a scattare un selfie e ottieni il fileId string chiamando il metodo AvatarCreationService:PromptSelectAvatarGenerationImageAsync() sul server. Questo fileId sarà passato al metodo AvatarCreationService:GenerateAvatar2DPreviewAsync().
Per creare un'immagine di anteprima 2D dell'avatar, chiama i seguenti metodi:
- AvatarCreationService:LoadAvatar2DPreviewAsync() sul client.
Il metodo AvatarCreationService:GenerateAvatar2DPreviewAsync() prende il SessionId, il fileId e un testo di invito opzionale come input per generare un'anteprima 2D dell'avatar. Questo metodo restituisce un previewId.
Questo previewId dovrebbe essere inviato al client e può quindi essere utilizzato per recuperare l'anteprima come un EditableImage.
Se l'utente non è soddisfatto dell'anteprima generata, questo flusso di lavoro può essere ripetuto.
Generare l'avatar
Una volta che l'utente è soddisfatto dell'anteprima, puoi generare il personaggio avatar 3D completo.
Per generare un personaggio avatar:
- Chiama AvatarCreationService:GenerateAvatarAsync() sul server con un Dictionary contenente il SessionId e il PreviewId.
- Questa chiamata al metodo restituisce un string generationId.
- Recupera i dati dell'avatar generato come HumanoidDescription utilizzando il metodo AvatarCreationService:LoadGeneratedAvatarAsync() sia sul server di gioco che sul client.
- Usa il metodo Players.CreateHumanoidModelFromDescription per creare un modello avatar dalla HumanoidDescription da visualizzare al Player.
Le risorse mesh e texture sono fornite come oggetti EditableMesh e EditableImage, rispettivamente, per consentire la continua modifica dell'avatar generato. Le modifiche devono essere apportate sia sul server di gioco che sulla copia client per mantenerle sincronizzate per la pubblicazione.
Pubblicare l'avatar
Se l'utente è soddisfatto dell'avatar risultante, può essere pubblicato utilizzando il metodo AvatarCreationService:PromptCreateAvatarAsync().
Per ulteriori informazioni, vedere creazione in gioco.