Плагин 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.
Мы создали для вас скрипты, которые обрабатывают подключение GoCube на iOS и Android. Первая сцена, которую нам нужно создать, — это GoCubeConnectionScene. В большинстве случаев эта сцена должна появиться при первом запуске приложения.
Начните с выбора «Файл» -> «Новая сцена» и сохраните ее как 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.