Fitur foto-ke-avatar saat ini dalam tahap alpha. Untuk informasi terbaru, lihat pengumuman DevForum.
Panduan berikut berlaku untuk pembuat yang sudah familiar dengan scripting dan Roblox Studio serta berniat mengembangkan permainan yang memungkinkan item avatar yang dihasilkan pengguna.
Anda dapat membuat permainan yang memungkinkan pemain untuk menghasilkan karakter avatar yang sepenuhnya fungsional menggunakan foto dan prompt teks.
Proses ini melibatkan langkah-langkah berikut:
- Meminta sesi generasi avatar.
- Meminta pengguna untuk mengambil selfie dan menghasilkan gambar pratinjau 2D dari avatar.
- Menghasilkan karakter avatar lengkap menggunakan HumanoidDescription.
Meminta sesi generasi avatar
Untuk memulai generasi foto-ke-avatar, panggil AvatarCreationService:RequestAvatarGenerationSessionAsync() dari server untuk meminta sesi bagi pemain. Sesi memberikan Player sejumlah pratinjau avatar dan generasi avatar tertentu.
Karena mungkin memerlukan waktu bagi sesi untuk tersedia, AvatarCreationService:RequestAvatarGenerationSessionAsync() mengembalikan RBXScriptConnection dan waktu tunggu dalam detik. Waktu tunggu ini dapat digunakan untuk memberikan informasi kepada Player tentang berapa lama mereka harus menunggu untuk dapat memulai generasi mereka.
Setelah sesi siap, callback akan dipanggil dengan Dictionary informasi tentang sesi tersebut. Dictionary ini mencakup:
- SessionId — Diberikan sebagai argumen saat memanggil AvatarCreationService:GenerateAvatar2DPreviewAsync() dan AvatarCreationService:GenerateAvatarAsync().
- Allowed2DGenerations — Jumlah generasi pratinjau 2D yang diizinkan dalam sesi.
- Allowed3DGenerations — Jumlah generasi avatar yang diizinkan dalam sesi.
- SessionTime — Waktu maksimum untuk sesi dalam detik.
Meminta selfie dan menghasilkan pratinjau 2D
Setelah sesi dimulai, minta pengguna untuk mengambil selfie dan dapatkan fileId string dengan memanggil metode AvatarCreationService:PromptSelectAvatarGenerationImageAsync() di Server. fileId ini akan diteruskan ke metode AvatarCreationService:GenerateAvatar2DPreviewAsync().
Untuk membuat gambar pratinjau 2D dari avatar, panggil metode berikut:
AvatarCreationService:GenerateAvatar2DPreviewAsync() mengambil SessionId, fileId, dan prompt teks opsional sebagai input untuk menghasilkan pratinjau avatar 2D. Metode ini mengembalikan previewId.
previewId ini harus dikirim ke klien dan kemudian dapat digunakan untuk mengambil pratinjau sebagai EditableImage.
Jika pengguna tidak puas dengan pratinjau yang dihasilkan, alur kerja ini dapat diulang.
Menghasilkan avatar
Setelah pengguna puas dengan pratinjau, Anda dapat menghasilkan karakter avatar 3D lengkap.
Untuk menghasilkan karakter avatar:
- Panggil AvatarCreationService:GenerateAvatarAsync() di Server dengan Dictionary yang berisi SessionId dan PreviewId.
- Panggilan metode ini mengembalikan string generationId.
- Ambil data avatar yang dihasilkan sebagai HumanoidDescription menggunakan metode AvatarCreationService:LoadGeneratedAvatarAsync() di server permainan dan klien.
- Gunakan metode Players.CreateHumanoidModelFromDescription untuk membuat model avatar dari HumanoidDescription untuk ditampilkan kepada Player.
Aset mesh dan tekstur disediakan sebagai objek EditableMesh dan EditableImage, masing-masing, untuk memungkinkan pengeditan berkelanjutan dari avatar yang dihasilkan. Editan harus dilakukan di server permainan dan salinan klien untuk menjaga agar tetap sinkron untuk publikasi.
Mempublikasikan avatar
Jika pengguna puas dengan avatar yang dihasilkan, avatar tersebut dapat dipublikasikan menggunakan metode AvatarCreationService:PromptCreateAvatarAsync().
Untuk informasi lebih lanjut, lihat pembuatan dalam permainan.