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 Project ของคุณ
เราได้สร้างสคริปต์สำหรับคุณที่จัดการการเชื่อมต่อของ 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 (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