توليد الصورة إلى الصورة الرمزية

يمكنك إنشاء لعبة تسمح للاعبين بتوليد شخصية صورة رمزية وظيفية بالكامل باستخدام صورة ونص.

تشمل هذه العملية الخطوات التالية:

1. طلب جلسة توليد صورة رمزية.
2. دفع المستخدم لالتقاط صورة سيلفي وتوليد صورة معاينة ثنائية الأبعاد للصورة الرمزية.
3. توليد شخصية الصورة الرمزية الكاملة باستخدام HumanoidDescription.

طلب جلسة توليد صورة رمزية

للبدء في توليد الصورة إلى الصورة الرمزية، استدعِ AvatarCreationService:RequestAvatarGenerationSessionAsync() من الخادم لطلب جلسة للاعب. توفر الجلسة Player بعدد معين من معاينات الصورة الرمزية وتوليدات الصورة الرمزية.

نظرًا لأنه قد يستغرق بعض الوقت لتصبح الجلسة متاحة، فإن AvatarCreationService:RequestAvatarGenerationSessionAsync() تعيد RBXScriptConnection و waitTime بالثواني. يمكن استخدام waitTime لتزويد Player بمعلومات حول المدة التي ستستغرقها لبدء توليدها.

بمجرد أن تصبح الجلسة جاهزة، يتم استدعاء رد النداء مع Dictionary من المعلومات حول الجلسة. يتضمن Dictionary:

• SessionId — يتم تمريره كوسيط عند استدعاء AvatarCreationService:GenerateAvatar2DPreviewAsync() و AvatarCreationService:GenerateAvatarAsync().
• Allowed2DGenerations — عدد توليدات المعاينة الثنائية الأبعاد المسموح بها في الجلسة.
• Allowed3DGenerations — عدد توليدات الصورة الرمزية المسموح بها في الجلسة.
• SessionTime — الحد الأقصى للوقت لجلسة بالثواني.

دفع لالتقاط صورة سيلفي وتوليد معاينة ثنائية الأبعاد

بعد بدء الجلسة، ادفع المستخدم لالتقاط صورة سيلفي واحصل على fileId string عن طريق استدعاء AvatarCreationService:PromptSelectAvatarGenerationImageAsync() على الخادم. سيتم تمرير هذا fileId إلى AvatarCreationService:GenerateAvatar2DPreviewAsync().

لإنشاء صورة معاينة ثنائية الأبعاد للصورة الرمزية، استدعِ الطرق التالية:

1. AvatarCreationService:GenerateAvatar2DPreviewAsync() على الخادم.
2. AvatarCreationService:LoadAvatar2DPreviewAsync() على العميل.

تأخذ AvatarCreationService:GenerateAvatar2DPreviewAsync() SessionId و fileId ونص اختياري كمدخلات لتوليد معاينة ثنائية الأبعاد للصورة الرمزية. تعيد هذه الطريقة previewId.

يجب إرسال هذا previewId إلى العميل ويمكن استخدامه بعد ذلك لاسترجاع المعاينة كـ EditableImage.

إذا لم يكن المستخدم راضيًا عن المعاينة المولدة، يمكن تكرار هذه العملية.

توليد الصورة الرمزية

بمجرد أن يكون المستخدم راضيًا عن المعاينة، يمكنك توليد شخصية الصورة الرمزية ثلاثية الأبعاد الكاملة.

لتوليد شخصية الصورة الرمزية:

1. استدعِ AvatarCreationService:GenerateAvatarAsync() على الخادم مع Dictionary يحتوي على SessionId و PreviewId.

   1. تعيد هذه المكالمة method string generationId.
2. استرجع بيانات الصورة الرمزية المولدة كـ HumanoidDescription باستخدام AvatarCreationService:LoadGeneratedAvatarAsync() على كل من خادم اللعبة والعميل.
3. استخدم طريقة Players.CreateHumanoidModelFromDescription لإنشاء نموذج صورة رمزية من HumanoidDescription لعرضه على Player.

تُقدم أصول الشبكة والقوام ككائنات EditableMesh و EditableImage، على التوالي، للسماح بالتحرير المستمر للصورة الرمزية المولدة. يجب إجراء التعديلات على كل من خادم اللعبة ونسخة العميل للحفاظ على تزامنها للنشر.

نشر الصورة الرمزية

إذا كان المستخدم راضيًا عن الصورة الرمزية الناتجة، يمكن نشرها باستخدام AvatarCreationService:PromptCreateAvatarAsync().

لمزيد من المعلومات، راجع إنشاء داخل اللعبة.