Le plugin GoCube Unity est un groupe de classes C# qui forment un pont entre Unity et nos Android™ et iOS™ natifs. Unity peut appeler le code natif de chaque plate-forme pour les commandes GoCube et recevoir des rappels du code natif vers Unity. Le moyen le plus simple de démarrer avec le plugin est de commencer par l’exemple que nous avons créé.
Notice: The GoCube Unity Plugin only works with Android and iOS.
Connectez-vous à un GoCube, il affichera alors un cube virtuel qui est un miroir du cube physique. L'exemple contient quelques appels API simples.
Ouvrez simplement un projet Unity et sélectionnez le dossier qui contient les dossiers « Assets » et « ProjectSettings ». Ouvrez la scène GoCubeConnectionScene (passez à la plateforme Android ou iOS) et exécutez l'exemple.
Ouvrez Unity et commencez par choisir Fichier -> Nouveau projet.
Ensuite, faites glisser les répertoires BLE
, Particula
et Plugins
de GoCubeUnityPlugin
vers votre projet Unity.
Nous avons créé pour vous des scripts qui gèrent la connexion d'un GoCube sur iOS et Android. La première scène que nous devons créer est la GoCubeConnectionScene. La plupart du temps, c'est la scène qui devrait apparaître lorsque vous démarrez l'application pour la première fois.
Commencez par choisir Fichier -> Nouvelle scène et enregistrez-le sous GoCubeConnectionScene
. Tout ce que vous avez à faire est de localiser le préfabriqué GoCubeConnection
qui se trouve dans le répertoire Assets/Particula/Prefabs
de votre projet. Faites glisser le préfabriqué dans la scène.
Remarque - L'objet de jeu Next Scene
est une chaîne du nom de la scène que vous souhaitez qu'Unity charge une fois la GoCubeConnectionScene terminée. Il passera à la scène après s'être connecté au GoCube.
Malheureusement, ce SDK n’est actuellement pris en charge qu’en C#.
La scène précédente gérera les connexions GoCube. Une fois qu'un GoCube est connecté, votre projet y a accès via la classe singleton GoCubeProvider
. Accédez-y par cet appel :
C#
IOnlineCube connectedGoCube = GoCubeProvider.GetProvider().GetConnectedGoCube();
Ce paramètre sera nul si aucun GoCube n'est connecté.
Ces fonctions fonctionneront correctement sur les deux plates-formes mobiles.
Modèles de LED ouverts GoCube (C#) :
// Open GoCube leds (pattern 1)
connectedGoCube.PlayLedPattern(LedPattern.Pattern1);
Obtenez si le cube est résolu ou non (C#) :
// Get if the cube is solved or not
connectedGoCube.IsSolved()
Il existe d'autres commandes que vous pouvez consulter dans la classe IOnlineCube. La documentation complète se trouve dans /Assets/Plugins/Particula/Particula.GoCube.xml
Le SDK GoCube vous permet de suivre les rotations des cubes en temps réel en recevant une notification une fois la rotation effectuée. La façon de procéder est de s'inscrire à l'événement de rotations de cubes :
connectedGoCube.afterRotation += RotationEvent;
N'oubliez pas de vous désinscrire de la notification lorsque vous n'en avez plus besoin.
connectedGoCube.afterRotation -= RotationEvent;
Recevez les données et faites-en ce que vous voulez. Chaque message a un identifiant de visage unique qui a pivoté.
private void RotationEvent(Rotation rot)
{
// You can do your stuff here....
}
Le plugin GoCube Unity est distribué sous la licence de code source ParticulaCode.
Android™ est une marque déposée de Google Inc | iOS™ est une marque sous licence d'Apple