يعد GoCube Unity Plugin عبارة عن مجموعة من فئات C# التي تشكل جسرًا بين Unity ونظام Android™ وiOS™ الأصلي. يمكن لـ Unity الاتصال بالرمز الأصلي لكل نظام أساسي لأوامر GoCube وتلقي عمليات الاسترجاعات من الكود الأصلي إلى Unity. أسهل طريقة لبدء استخدام المكون الإضافي هي البدء بالنموذج الذي أنشأناه.
Notice: The GoCube Unity Plugin only works with Android and iOS.
اتصل بـ GoCube، ثم سيعرض مكعبًا افتراضيًا يمثل مرآة للمكعب الفعلي. تحتوي العينة على بعض استدعاءات API السهلة.
ما عليك سوى فتح مشروع Unity وتحديد المجلد الذي يحتوي على المجلدين "Assets" و"ProjectSettings". افتح مشهد GoCubeConnectionScene (قم بالتبديل إلى نظام Android أو iOS الأساسي) وقم بتشغيل المثال.
افتح Unity وابدأ باختيار File -> New Project.
بعد ذلك، اسحب أدلة BLE
و Particula
و Plugins
من GoCubeUnityPlugin
إلى مشروع Unity الخاص بك.
لقد أنشأنا لك برامج نصية تتعامل مع اتصال GoCube على iOS وAndroid. المشهد الأول الذي نحتاج إلى إنشائه هو GoCubeConnectionScene. في أغلب الأحيان، هذا هو المشهد الذي يجب أن يظهر عند تشغيل التطبيق لأول مرة.
ابدأ باختيار File -> New Scene، واحفظه باسم GoCubeConnectionScene
. كل ما عليك فعله هو تحديد موقع مبنى GoCubeConnection
الجاهز الموجود في دليل Assets/Particula/Prefabs
في مشروعك. اسحب الجاهزة إلى مكان الحادث.
ملاحظة - كائن لعبة Next Scene
عبارة عن سلسلة من اسم المشهد الذي تريد أن تقوم Unity بتحميله بعد انتهاء GoCubeConnectionScene. سينتقل إلى المشهد بعد اتصاله بـ GoCube.
لسوء الحظ، SDK هذا مدعوم فقط في C# في الوقت الحالي.
سيتعامل المشهد السابق مع اتصالات GoCube. بعد توصيل GoCube، يمكن لمشروعك الوصول إليه من خلال فئة GoCubeProvider
المفردة. الوصول إليهم عن طريق هذه المكالمة:
ج#
IOnlineCube connectedGoCube = GoCubeProvider.GetProvider().GetConnectedGoCube();
ستكون هذه المعلمة فارغة في حالة عدم اتصال GoCube.
ستعمل هذه الوظائف بشكل جيد على كلا النظامين الأساسيين للهواتف المحمولة.
افتح أنماط GoCube LED (C#):
// Open GoCube leds (pattern 1)
connectedGoCube.PlayLedPattern(LedPattern.Pattern1);
احصل على ما إذا كان المكعب قد تم حله أم لا (C#):
// Get if the cube is solved or not
connectedGoCube.IsSolved()
هناك المزيد من الأوامر التي يمكنك التحقق منها في فئة IOnlineCube. الوثائق الكاملة موجودة في /Assets/Plugins/Particula/Particula.GoCube.xml
يتيح لك GoCube SDK تتبع دورات المكعب في الوقت الفعلي من خلال الحصول على إشعار بمجرد إجراء عملية التدوير. طريقة القيام بذلك هي التسجيل في حدث دوران المكعب:
connectedGoCube.afterRotation += RotationEvent;
تذكر إلغاء التسجيل للحصول على الإشعار عندما لم تعد بحاجة إليه.
connectedGoCube.afterRotation -= RotationEvent;
احصل على البيانات وافعل بها ما تريد. تحتوي كل رسالة على معرف الوجه الفريد الذي تم تدويره.
private void RotationEvent(Rotation rot)
{
// You can do your stuff here....
}
يتم توزيع البرنامج الإضافي GoCube Unity بموجب ترخيص كود مصدر ParticulaCode.
Android™ هي علامة تجارية مسجلة لشركة Google Inc | iOS™ هي علامة تجارية مرخصة لشركة Apple