La funzione da Foto a Avatar è attualmente in fase alpha. Si prega di consultare l'annuncio del DevForum per le informazioni più recenti.
Guida si applica a 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 prompt di testo.
Questo processo coinvolge i seguenti passaggi:
- Richiesta di una sessione di generazione Avatar
- Invita l'utente a scattare un selfie e genera un'immagine di anteprima 2D dell'avatar
- Genera il personaggio avatar completo utilizzando HumanoidDescription
Richiesta di una sessione di generazione Avatar
Per avviare la generazione da foto a avatar, 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 Avatar.
Poiché potrebbe richiedere del tempo affinché una sessione diventi disponibile, AvatarCreationService:RequestAvatarGenerationSessionAsync() restituisce una RBXScriptConnection e un tempo di attesa in secondi. Il tempo di attesa può essere utilizzato per fornire al Player informazioni su quanto tempo impiegherà a poter iniziare le proprie 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 3D consentite in una sessione
- SessionTime — il tempo massimo per una sessione in secondi
Invita a scattare un selfie e genera un'anteprima 2D
Dopo che una sessione è avviata, invita l'utente a scattare un selfie e ottieni il fileId string chiamando il metodo AvatarCreationService:PromptSelectAvatarGenerationImageAsync() sul server. Questo fileId verrà passato al metodo AvatarCreationService:GenerateAvatar2DPreviewAsync().
Per creare un'immagine di anteprima 2D dell'Avatar chiama i seguenti metodi:
Il metodo AvatarCreationService:GenerateAvatar2DPreviewAsync() prende il SessionId, fileId e un prompt di testo opzionale come input per generare un'anteprima Avatar 2D. 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.
Genera l'avatar 3D
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 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.
- Puoi utilizzare il metodo Players.CreateHumanoidModelFromDescription per creare un modello avatar dalla HumanoidDescription da visualizzare al Player.
I materiali e le texture verranno forniti come oggetti EditableMesh e EditableImage, rispettivamente, per consentire la continua modifica dell'avatar generato. Le modifiche dovrebbero essere apportate sia sulla copia del server di gioco che su quella del client per mantenerle sincronizzate per la pubblicazione.
Pubblica
Se l'utente è soddisfatto dell'avatar risultante, può essere pubblicato utilizzando il metodo AvatarCreationService:PromptCreateAvatarAsync().
Per ulteriori dettagli su vedere creazione in-game.