使用方法
RTT4Uの使い方¶
Unityのリアルタイムテスト(以下、RTT4Uと呼ぶ)を使用するには、以下の手順に従う必要があります。
- RTTクライアントアプリを構築する(最初は一度、必要に応じて再構築)\n2. Unityエディタのプレイモードを実行する
RTT クライアント¶
RTT4Uは、Hive SDKを内部で適用するアプリを構築し、それをAndroidエミュレーターであるRTT Playerで実行することによって機能します。
したがって、RTT4Uを使用してHive SDKで実装されたアプリをテストするには、アプリを少なくとも一度ビルドする必要があります。ビルドされたアプリはRTTクライアントと呼ばれます。RTTクライアントアプリは、RTTプレーヤー上でHive SDK Androidライブラリを実行し、実行結果をUnityエディターに返します。
RTTクライアントアプリを構築するには、以下の条件を満たす必要があります:
- Hive SDK Unity Androidのインストールと設定からアプリ開発までのすべてのプロセスを完了する
- アプリがUnityで正しくビルドできるように、Android SDKとNDKがインストールされていることを確認する
RTTクライアントアプリを構築する方法は2つあります: 自動と手動です。
自動ビルド(推奨)¶
ビルドプロセスは次のとおりです:
- Unityプロジェクトを保存します。
- メニューからHive > RTT4U > Build RTT Clientを選択して、RTTクライアントのビルドを開始します。
- ビルドが完了すると、RTTClient.apkがUNITY_PROJECT_DIRECTORY/Library/Builds/RTTClientに作成されます。これはRTTクライアントのための一時的なUnityプロジェクトです。
hive_config.xmlの内容を変更したり、Androidの依存関係を修正した場合は、RTTクライアントを再構築する必要があります。
手動ビルド¶
自動ビルドに時間がかかりすぎる場合やRTTClient.apkが作成されない場合は、手動ビルドを試してください。手動ビルドを試みる前に、以下を確認してください:
- Hive SDKが正しく適用されていることを確認してください
- アプリがUnityプロジェクトで正しくビルドできることを確認してください
マニュアルビルドは以下の手順に従います:
- メニューからHive > RTT4U > RTTクライアントプロジェクトパスを確認を選択します。
- UnityエディターコンソールでRTTClient Temp Project : {PROJECT_DIRECTORY}というログを探します。
- UnityエディターでPROJECT_DIRECTORYにあるプロジェクトを開きます。これはRTTクライアント用の一時的なUnityプロジェクトです。
- ファイル > ビルド設定 > ビルドを選択してプロジェクトを直接ビルドします。プロジェクトターゲットはAndroidである必要があります。
- ビルド中に発生する問題を解決します。
- 見つけた解決策を、作業していた元のUnityプロジェクトに適用します。
Unityエディターのプレイモードを実行中¶
RTTクライアントアプリをビルドした後、以下の手順に従ってUnityエディターのプレイモードでHive SDKの機能をテストしてください。
1. スタートシーンでのプラグイン初期化を実装する¶
アプリを開始するシーンでHive SDK Unity Pluginの初期化(HIVEUnityPlugin.InitPlugin
)を実装します。Hive SDK Unity Pluginの初期化コードは、RTT Clientアプリを実行した後に呼び出されることを確認してください。
void Awake () {
// Creates a game object for the Hive SDK plugin.
hive.HIVEUnityPlugin.InitPlugin();
}
Warning
Hive SDK Unityプラグインの初期化が完了する前に別のシーンに切り替えると、Hive SDK GameObjectが作成されず、RTT4Uが正しく機能しなくなります。
2. RTT4Uを有効にする¶
メニューからHive > RTT4U > RTTを有効にするを選択してRTT4Uを有効にします。
Note
RTT4UはRTTプレーヤーを実行してもアクティブにできません。RTT4UはRTT有効化を使用してアクティブにする必要があります。インストール後にエミュレーターが正常に機能しているかどうかを確認するためにのみRTTプレーヤーを実行を使用してください。
3. Open RTTClientWaiter シーン¶
現在作業中のシーンを保存した後、Hive > RTT4U > RTTクライアント待機シーンを開くを選択して、RTTClientWaiterシーンを開きます。
4. プレイモードに入る¶
Unityエディターで再生ボタンをクリックして、プレイモードに入ります。
5. RTTクライアントアプリが実行されるのを待つ¶
プレイモードに入ると、RTTプレイヤーとRTTクライアントアプリが自動的に実行されます。RTTクライアントアプリが起動するまで待ってください。
6. Hive SDK機能のテスト¶
希望するシーンでHive SDKの機能をテストします。たとえば、ゲームアプリでは、ログイン、ゲームロビー、ストア、バトルなどのさまざまなシーンでHive SDKの機能をテストできます。Hive SDKのUIはRTTプレーヤーに表示され、表示されたUIからHive SDKをテストし、Unityエディタのプレーヤーモードに戻ってアプリをテストできます。
Note
テストのためにHive SDKフローに従うことをお勧めします。例えば、ほとんどのHive SDK機能は、Hive SDKの初期化とIdPログインを実行した後にテストできます。