Nreal Light

[Nreal Light] Quickstart for Android

2020年5月31日

目次Category


(2020.06.08時点)NrealLightサンプルデモを動かすために、公式サイトを読んだので、備忘録として残します。
原文は、以下のリンクにあります。
https://developer.nreal.ai/develop/unity/android-quickstart

Quickstart for Android

Androidで、NRSDK Unityアプリの開発を始めましょう

このクイックスタートガイドは、開発環境をセットアップし、NRSDKでサンプルアプリ「Hello MR」をテストするのに役立ちます

Getting Started

必要なハードウェア

・　Nreal コンピューティングユニット

画面のないAndroidスマートフォンと考えると、すべての開発プロセスはモバイルアプリ開発と非常によく似ています。

・　Nreal Light グラス

NrealLightグラスを持っていませんか？ Nreal Developer Kit にサインアップしてください。 または、エミュレータを試して、Nreal Light グラスと、コンピューティングユニットなしで、Nrealアプリの機能を試してください。

・　Nreal コンピューティングユニットを、PCに接続するための USB​​ Type-C ケーブル

・　Wi-Fi接続は必要ありません。
　　ただし、Wi-Fi Android Debug Bridge（adb）接続を使用してデバッグおよびテストができます。

必要なソフトウェア

・　Unity 2018.2.X以降と、Androidビルドのサポート

・　NRSDKForUnity_1.2.1のダウンロード

SDKは、「NRSDKForUnity_1.2.1.unitypackage」としてダウンロードされます

・　Android StudioのSDK Managerを使用してインストールされたAndroid SDK 8.0（APIレベル26）以降


Creating a Unity Project

  1. Unityを起動して、３Dテンプレートを選択して、新規プロジェクトを作成します
  2. 上部タブ「ファイル」 > 「ビルド設定…」 > 「プレイヤー設定…」 > 「API互換性レベル*」の設定を、「.NET Standard 2.0」から「.NET 4.x」に変更します
  3. ダウンロードしてきたNRSDKをUnityにインポートします
    1. 上部タブ「アセット」 > 「パッケージをインポート」 > 「カスタムパッケージ…」を選択します
    2. ダウンロードしてきた「NRSDKForUnity_1.2.1.unitypackage」を選択します
    3. 「Import Unity Package」ダイアログで、「すべて」ボタンを選択して「インポート」ボタンをクリックします


Hello MR – Your First Sample App

「プロジェクト」ウィンドウを開き「Assets > NRSDK > Demos」を選択し「HelloMR.unity」を開きます


Configure Build Settings

    1. 上部タブの「ファイル > ビルド設定…」を選択する
    2. プラットフォームで「Android」を選択し、「Switch Platform」ボタンをクリックする
    3. ビルド設定画面にある「プレイヤー設定…」をクリックする
    4. 以下のテーブルの通りに値を変更する
SettingValue
Player Settings > Resolution and Presentation > Default OrientationPortrait
Player Settings > Other Settings > Auto Graphics APIfalse
Player Settings > Other Settings > Graphics APIsOpenGLES3
Player Settings > Other Settings > Package NameJavaパッケージ形式のユニークなアプリIDを入力します（例.com.nreal.helloMR)
Player Settings > Other Settings > Minimum API LevelAndroid 8.0 or higher
Player Settings > Other Settings > Target API LevelAndroid 8.0 or higher
Player Settings > Other Settings > Write PermissionExternal(SDCard)
Player Settings > Other Settings > Allow ‘unsafe’ codetrue
Project Settings > Quality > V Sync Count
※最後だけ、PlayerSettingではなく、ProjectSettingであることに注意してください。		Don’t Sync

Connect to Nreal Device

  1. Nrealコンピューティングユニットで「開発者向けオプション」と「USBデバッグ」を有効にします。
    　　Android Debug Bridge（adb）はデフォルトで有効になっており、手動で設定する必要はありません）
  2. NrealコンピューティングユニットをWindows PCに接続します。


Build and Run

  1. ビルド設定画面で、「ビルド」ボタンをクリックします。ビルドが成功した後、WiFi Android Debug Bridge（adb）を介してアプリをインストールします。
  2. NrealコンピューティングユニットをPCから取り外し、Nrealグラスに接続します。
  3. このアプリを初めて実行する場合は、scrcpyなどのツールでアプリを認証する必要があります。
  4. Nreal Lightコントローラーと一緒にアプリを起動します。Nreal Lightコントローラーの使用方法については、コントローラーガイドを参照してください。
  5. NRSDKが水平面を見つけ、検出された平面が緑のグリッドで覆われるまで移動します。
  6. 「トリガー」ボタンをクリックして、Nrealロゴオブジェクトを配置します。
  7. （オプション）Android Logcatを使用して、ログに記録されたメッセージを表示します。データケーブルを介して接続する必要がないように、WiFi Android Debug Bridge（adb）を使用してPCに接続することをお勧めします


Next Steps

画像追跡を使用して、物理環境で複数の画像を検出および追跡できるアプリを構築します。

この記事を書いた人

佐々木　努

執行役員CTO
人材開発室 室長
一般社団法人 iCD協会 活用支援委員会メンバー