com.rest.meshy

com.rest.meshy

عميل Rectful من الذكاء الاصطناعي غير الرسمي لمحرك لعبة الوحدة.

جميع حقوق الطبع والنشر والعلامات التجارية والشعارات والأصول هي ملك لأصحابها المعنيين.

هذا المستودع متاح للانتقال إلى المنظمة المشوية إذا اختاروا قبولها.

التثبيت

يتطلب الوحدة 2021.3 LTS أو أعلى.

طريقة التثبيت الموصى بها هي على الرغم من أن Manager Unity Package Manager و OpenUPM.

عبر Unity Package Manager و OpenUpm

• افتح إعدادات مشروع الوحدة الخاصة بك
• حدد Package Manager
• أضف سجل حزمة openupm:
  • الاسم: OpenUPM
  • عنوان URL: https://package.openupm.com
  • النطاق (النطاق):
    • com.rest.meshy
• افتح نافذة Unity Package Manager
• تغيير السجل من الوحدة إلى My Registries
• أضف الحزمة Meshy

عبر Manager Unity Package و GIT URL

• افتح مدير حزمة الوحدة الخاص بك
• إضافة حزمة من عنوان URL GIT: https://github.com/RageAgainstThePixel/com.rest.meshy.git#upm

  ملاحظة: هذا الريبو لديه تبعيات على مستودعات أخرى! أنت مسؤول عن إضافة هذه بنفسك.

  • com.Utable.async
  • com.Utable.Extensions
  • com.Utable.rest

---

الوثائق

جدول المحتويات

• المصادقة
• لوحة القيادة
• نص على الملمس
  • قائمة النص على مهام الملمس
  • إنشاء نص إلى مهمة الملمس
• النص إلى 3D
  • قائمة النص على المهام ثلاثية الأبعاد
  • إنشاء نص إلى مهمة ثلاثية الأبعاد
• صورة إلى 3D
  • قائمة الصورة على المهام ثلاثية الأبعاد
  • إنشاء صورة إلى مهمة ثلاثية الأبعاد

المصادقة

هناك 4 طرق لتوفير مفاتيح واجهة برمجة التطبيقات الخاصة بك ، حسب الأسبقية:

️ لقد أوصينا باستخدام متغيرات البيئة لتحميل مفتاح API بدلاً من ترميزه الثابت في المصدر الخاص بك. لا ينصح باستخدام هذه الطريقة في الإنتاج ، ولكن فقط لقبول بيانات اعتماد المستخدم والاختبار المحلي وسيناريوهات البدء السريع.

1. تمرير المفاتيح مباشرة مع المنشئ ️
2. الكائن القابل للسيناريو الوحدة ️
3. تحميل المفتاح من ملف التكوين
4. استخدام متغيرات بيئة النظام

يمكنك استخدام MeshyAuthentication عند تهيئة واجهة برمجة التطبيقات كما هو موضح:

تمرير المفاتيح مباشرة مع المنشئ

️ لقد أوصينا باستخدام متغيرات البيئة لتحميل مفتاح API بدلاً من ترميزه الثابت في المصدر الخاص بك. لا ينصح باستخدام هذه الطريقة في الإنتاج ، ولكن فقط لقبول بيانات اعتماد المستخدم والاختبار المحلي وسيناريوهات البدء السريع.

 var api = new MeshyClient ( " msy_apikey123 " ) ;

أو إنشاء كائن MeshyAuthentication يدويًا

 var api = new MeshyClient ( new MeshyAuthentication ( " msy_apikey123 " ) ) ; 

الكائن القابل للسيناريو الوحدة

يمكنك حفظ المفتاح مباشرة في كائن قابل للنص الموجود في مجلد Assets/Resources .

يمكنك إنشاء واحدة جديدة باستخدام قائمة السياق في جزء المشروع وإنشاء كائن قابل للتكنولوجيا MeshyConfiguration جديد.

️ احذر من التحقق من هذا الملف في عنصر تحكم المصدر ، حيث سيتمكن الأشخاص الآخرون من رؤية مفتاح API الخاص بك.

تحميل المفتاح من ملف التكوين

محاولات تحميل مفاتيح API من ملف التكوين ، بشكل افتراضي .meshy

لإنشاء ملف تكوين ، قم بإنشاء ملف نصي جديد يسمى .meshy ويحتوي على السطر:

إدخال المنظمة اختياري.

تنسيق JSON

{
  "apiKey" : " msy_apikey123 "
}

يمكنك أيضًا تحميل ملف التكوين مباشرةً مع المسار المعروف عن طريق استدعاء الطرق الثابتة في MeshyAuthentication :

• يقوم بتحميل التكوين الافتراضي .meshy meshy في الدليل المحدد:

 var api = new MeshyClient ( new MeshyAuthentication ( ) . LoadFromDirectory ( " path/to/your/directory " ) ) ;

• يقوم بتحميل ملف التكوين من مسار معين. لا يلزم تسمية الملف .meshy ما طالما أنه يتوافق مع تنسيق JSON:

 var api = new MeshyClient ( new MeshyAuthentication ( ) . LoadFromPath ( " path/to/your/file.json " ) ) ; 

استخدام متغيرات بيئة النظام

استخدم متغيرات بيئة نظامك ، حدد مفتاح API ومؤسسة لاستخدامها.

• استخدم MESHY_API_KEY لمفتاح API الخاص بك.

 var api = new MeshyClient ( new MeshyAuthentication ( ) . LoadFromEnvironment ( ) ) ;

لوحة القيادة

يمكنك تنفيذ نفس المهام في لوحة القيادة كما تفعل في WebApp.

PRO-TIP: يمكنك أيضًا استخدام نافذة السياق للوصول بسرعة إلى خيارات المحرر للبكتيريا المسبقة وكائنات المشهد!

الوصول إلى لوحة القيادة عبر Window/Dashboards/Meshy

• إنشاء قوام لنموذج ثلاثي الأبعاد موجود.
• إنشاء نموذج ثلاثي الأبعاد من موجه نص.
• إنشاء نموذج ثلاثي الأبعاد من صورة.

نص على الملمس

قم بإنشاء قوام عالية الجودة بسرعة لنماذج ثلاثية الأبعاد الحالية باستخدام مطالبات النص وفن المفهوم.

قائمة النص على مهام الملمس

 var api = new MeshyClient ( ) ;
var textToTextureTasks = await api . TextToTextureEndpoint . ListTasksAsync ( 1 , 12 , SortOrder . Descending ) ;

foreach ( var meshyTask in textToTextureTasks )
{
    Debug . Log ( $" { meshyTask . Id } | created_at: { meshyTask . CreatedAt } " ) ;
} 

إنشاء نص جديد لمهمة الملمس

ينشئ نصًا جديدًا لمهمة الملمس ، ويتقدم التقارير إلى أن يتم الانتهاء من المهمة.

تمرير في لعبة prefab أو scene compject لإعادة تكوينها:

 var api = new MeshyClient ( ) ;
var sphere = GameObject . CreatePrimitive ( PrimitiveType . Sphere ) ;
var request = new TextToTextureRequest ( sphere , " Basketball " , " game assets " , enableOriginalUV : false , resolution : Resolutions . X1024 , artStyle : ArtStyles . Realistic ) ;
var taskResult = await MeshyClient . TextToTextureEndpoint . CreateTextToTextureTaskAsync ( request , new Progress < TaskProgress > ( progress => Debug . Log ( $" [ { progress . Id } ] { progress . Status } : { progress . PrecedingTasks ?? progress . Progress } " ) ) ) ;
Assert . IsNotNull ( taskResult ) ;
Debug . Log ( $" { taskResult . Id } | created_at: { taskResult . FinishedAt } | expires_at: { taskResult . ExpiresAt } " ) ;

إذا كنت بحاجة إلى مزيد من التحكم في عملية تصدير GLB ، فيمكنك أيضًا تمريرها في GLTFast.Export.GameObjectExport كائن:

 var api = new MeshyClient ( ) ;
var sphere = GameObject . CreatePrimitive ( PrimitiveType . Sphere ) ;
var exportSettings = new ExportSettings
{
    Format = GltfFormat . Binary ,
    FileConflictResolution = FileConflictResolution . Overwrite ,
    ComponentMask = ~ ( ComponentType . Camera | ComponentType . Animation | ComponentType . Light ) ,
} ;
var gameObjectExportSettings = new GameObjectExportSettings
{
    OnlyActiveInHierarchy = false ,
    DisabledComponents = true ,
} ;
var glbExport = new GameObjectExport ( exportSettings , gameObjectExportSettings ) ;
glbExport . AddScene ( new [ ] { sphere } ) ;
var request = new TextToTextureRequest ( glbExport , " Planet " , " game asset, space, vibrant, highly detailed " , enableOriginalUV : false , resolution : Resolutions . X1024 , artStyle : ArtStyles . Realistic ) ;
var taskResult = await MeshyClient . TextToTextureEndpoint . CreateTextToTextureTaskAsync ( request , new Progress < TaskProgress > ( progress => Debug . Log ( $" [ { progress . Id } ] { progress . Status } : { progress . PrecedingTasks ?? progress . Progress } " ) ) ) ;
Assert . IsNotNull ( taskResult ) ;
Debug . Log ( $" { taskResult . Id } | created_at: { taskResult . FinishedAt } | expires_at: { taskResult . ExpiresAt } " ) ;

يمكنك أيضًا استخدام عنوان URL العام:

 var api = new MeshyClient ( ) ;
var modelUrl = " https://github.com/KhronosGroup/UnityGLTF/raw/master/UnityGLTF/Assets/StreamingAssets/Lantern/glTF-Binary/Lantern.glb "
var request = new TextToTextureRequest ( modelUrl , " Lantern " , " game assets " , resolution : Resolutions . X1024 , artStyle : ArtStyles . Realistic ) ;
var taskResult = await api . TextToTextureEndpoint . CreateTextToTextureTaskAsync ( request , new Progress < TaskProgress > ( progress => Debug . Log ( $" [ { progress . Id } ] { progress . Status } : { progress . PrecedingTasks ?? progress . Progress } " ) ) ) ;
Debug . Log ( $" { taskResult . Id } | created_at: { taskResult . FinishedAt } | expires_at: { taskResult . ExpiresAt } " ) ;

النص إلى 3D

قم بإنشاء نماذج ثلاثية الأبعاد رائعة باستخدام مطالبات النص.

قائمة النص على المهام ثلاثية الأبعاد

 var api = new MeshyClient ( ) ;
var textTo3DTasks = await MeshyClient . TextTo3DEndpoint . ListTasksAsync ( 1 , 12 , SortOrder . Descending ) ;

foreach ( var meshyTask in textTo3DTasks )
{
    Debug . Log ( $" { meshyTask . Id } | created_at: { meshyTask . CreatedAt } " ) ;
} 

إنشاء نص جديد لمهمة ثلاثية الأبعاد

 var request = new TextTo3DRequest ( " a treasure chest " , " realistic, wooden, carved, highest quality " , resolution : Resolutions . X1024 , artStyle : ArtStyles . Realistic ) ;
var taskResult = await MeshyClient . TextTo3DEndpoint . CreateTextTo3DTaskAsync ( request , new Progress < TaskProgress > ( progress => Debug . Log ( $" [ { progress . Id } ] { progress . Status } : { progress . PrecedingTasks ?? progress . Progress } " ) ) ) ;
Debug . Log ( $" { taskResult . Id } | created_at: { taskResult . FinishedAt } | expires_at: { taskResult . ExpiresAt } " ) ;

صورة إلى 3D

قم بتحويل صورك ثنائية الأبعاد بسرعة إلى نماذج ثلاثية الأبعاد مذهلة وتجلب صورك إلى الحياة.

قائمة الصورة على المهام ثلاثية الأبعاد

️ حاليا لا يعمل مع إصدار API الحالي.

 var api = new MeshyClient ( ) ;
var imageTo3dTasks = await api . ImageTo3DEndpoint . ListTasksAsync ( 1 , 12 , SortOrder . Descending ) ;

foreach ( var meshyTask in imageTo3dTasks )
{
    Debug . Log ( $" { meshyTask . Id } | created_at: { meshyTask . CreatedAt } " ) ;
} 

إنشاء صورة جديدة لمهمة ثلاثية الأبعاد

 var api = new MeshyClient ( ) ;
var imageUrl = " https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Assets/main/Models/Fox/screenshot/screenshot-x150.jpg " ;
var request = new ImageTo3DRequest ( imageUrl ) ;
var taskResult = await api . ImageTo3DEndpoint . CreateImageTo3DTaskAsync ( request , new Progress < TaskProgress > ( progress => Debug . Log ( $" [ { progress . Id } ] { progress . Status } : { progress . PrecedingTasks ?? progress . Progress } " ) ) ) ;
Assert . IsNotNull ( taskResult ) ;
Debug . Log ( $" { taskResult . Id } | created_at: { taskResult . FinishedAt } | expires_at: { taskResult . ExpiresAt } " ) ;