GoCube Unity プラグインは、Unity とネイティブ Android™ および iOS™ との間のブリッジを形成する C# クラスのグループです。 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 です。ほとんどの場合、これはアプリを初めて起動したときに表示されるシーンです。
まず、[ファイル] -> [新しいシーン] を選択し、 GoCubeConnectionScene
として保存します。必要なのは、プロジェクトのAssets/Particula/Prefabs
ディレクトリにあるGoCubeConnection
プレハブを見つけることだけです。プレハブをシーンにドラッグします。
注- Next Scene
ゲーム オブジェクトは、GoCubeConnectionScene の完了後に Unity にロードするシーンの名前の文字列です。 GoCubeに接続するとシーンに進みます。
残念ながら、この SDK は現時点では C# でのみサポートされています。
前のシーンは GoCube 接続を処理します。 GoCube が接続されると、プロジェクトはGoCubeProvider
シングルトン クラスを通じて GoCube にアクセスできるようになります。次の呼び出しでアクセスします。
C#
IOnlineCube connectedGoCube = GoCubeProvider.GetProvider().GetConnectedGoCube();
GoCube が接続されていない場合、このパラメータは null になります。
これらの機能は両方のモバイル プラットフォームで正常に動作します。
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 のライセンス商標です