GoCube Unity 外掛程式是一組 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 並選擇「檔案」->「新專案」。
接下來,將BLE
、 Particula
和Plugins
目錄從GoCubeUnityPlugin
拖曳到您的 Unity 專案中。
我們為您建立了處理 iOS 和 Android 上 GoCube 連線的腳本。我們需要創建的第一個場景是 GoCubeConnectionScene。大多數時候,這是您第一次啟動應用程式時應該彈出的場景。
首先選擇 File -> New Scene,並將其儲存為GoCubeConnectionScene
。您需要做的就是找到專案中Assets/Particula/Prefabs
目錄中的GoCubeConnection
預製件。將預製件拖曳到場景中。
注意- Next Scene
遊戲物件是您希望 Unity 在 GoCubeConnectionScene 完成後載入的場景名稱的字串。連接GoCube後會前往場景。
不幸的是,目前該 SDK 僅支援 C#。
上一個場景將處理 GoCube 連線。連接 GoCube 後,您的專案可以透過GoCubeProvider
單例類別存取它。透過以下調用存取它們:
C#
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;
接收資料並用它做任何你喜歡的事情。每個訊息都有一個已輪換的唯一面部 ID。
private void RotationEvent(Rotation rot)
{
// You can do your stuff here....
}
GoCube Unity 外掛程式根據 ParticulaCode 原始碼許可證分發。
Android™ 是 Google Inc 的註冊商標| iOS™ 是 Apple 的授權商標