Das GoCube Unity Plugin ist eine Gruppe von C#-Klassen, die eine Brücke zwischen Unity und unserem nativen Android™ und iOS™ bilden. Unity kann den nativen Code jeder Plattform für GoCube-Befehle aufrufen und Rückrufe vom nativen Code in Unity empfangen. Der einfachste Weg, mit dem Plugin loszulegen, besteht darin, mit dem von uns erstellten Beispiel zu beginnen.
Notice: The GoCube Unity Plugin only works with Android and iOS.
Stellen Sie eine Verbindung zu einem GoCube her, dann wird ein virtueller Würfel angezeigt, der ein Spiegelbild des physischen Würfels ist. Das Beispiel enthält einige einfache API-Aufrufe.
Öffnen Sie einfach ein Unity-Projekt und wählen Sie den Ordner aus, der die Ordner „Assets“ und „ProjectSettings“ enthält. Öffnen Sie die GoCubeConnectionScene-Szene (wechseln Sie zur Android- oder iOS-Plattform) und führen Sie das Beispiel aus.
Öffnen Sie Unity und wählen Sie zunächst Datei -> Neues Projekt.
Ziehen Sie als Nächstes die Verzeichnisse BLE , Particula und Plugins von GoCubeUnityPlugin in Ihr Unity-Projekt.
Wir haben für Sie Skripte erstellt, die die Verbindung eines GoCube auf iOS und Android abwickeln. Die erste Szene, die wir erstellen müssen, ist die GoCubeConnectionScene. Meistens ist dies die Szene, die beim ersten Start der App angezeigt werden sollte.
Wählen Sie zunächst Datei -> Neue Szene und speichern Sie sie als GoCubeConnectionScene . Sie müssen lediglich das GoCubeConnection Prefab finden, das sich im Verzeichnis Assets/Particula/Prefabs in Ihrem Projekt befindet. Ziehen Sie das Fertigteil in die Szene.
Hinweis – Das Spielobjekt Next Scene ist eine Zeichenfolge mit dem Namen der Szene, die Unity laden soll, nachdem die GoCubeConnectionScene abgeschlossen ist. Nach der Verbindung mit GoCube wird mit der Szene fortgefahren.
Leider wird dieses SDK derzeit nur in C# unterstützt.
In der vorherigen Szene werden GoCube-Verbindungen verarbeitet. Nachdem ein GoCube verbunden wurde, hat Ihr Projekt über die Singleton-Klasse GoCubeProvider Zugriff darauf. Greifen Sie über diesen Aufruf darauf zu:
C#
IOnlineCube connectedGoCube = GoCubeProvider.GetProvider().GetConnectedGoCube();
Dieser Parameter ist null, wenn kein GoCube verbunden ist.
Diese Funktionen funktionieren auf beiden mobilen Plattformen einwandfrei.
Öffnen Sie GoCube-LED-Muster (C#):
// Open GoCube leds (pattern 1)
connectedGoCube.PlayLedPattern(LedPattern.Pattern1);
Ermitteln Sie, ob der Würfel gelöst ist oder nicht (C#):
// Get if the cube is solved or not
connectedGoCube.IsSolved()
Es gibt weitere Befehle, die Sie in der IOnlineCube-Klasse ausprobieren können. Die vollständige Dokumentation befindet sich in /Assets/Plugins/Particula/Particula.GoCube.xml
Mit dem GoCube SDK können Sie die Würfelrotationen in Echtzeit verfolgen, indem Sie eine Benachrichtigung erhalten, sobald eine Rotation durchgeführt wurde. Die Möglichkeit dazu besteht darin, sich für das Cube-Rotations-Event anzumelden:
connectedGoCube.afterRotation += RotationEvent;
Denken Sie daran, sich für die Benachrichtigung abzumelden, wenn Sie sie nicht mehr benötigen.
connectedGoCube.afterRotation -= RotationEvent;
Empfangen Sie die Daten und machen Sie damit, was Sie wollen. Jede Nachricht hat die eindeutige Gesichts-ID, die rotiert wurde.
private void RotationEvent(Rotation rot)
{
// You can do your stuff here....
}
Das GoCube Unity Plugin wird unter der ParticulaCode-Quellcodelizenz vertrieben.
Android™ ist eine eingetragene Marke von Google Inc | iOS™ ist eine lizenzierte Marke von Apple
