Android
Prerequisites
Mandatory
Before getting started, the following utilities are necessary.
NVIDIA Omniverse™ Kit version 2021.3 or greater
For Android devices:
Android Studio v3.4+ or Android Command Line Tools.
Android Tablet with AR capabilities. (need a list of supported devices)
Optional
For expert Android developers looking for a more complete environment for debugging, the following is suggested.
A fully setup Android development environment
Android SDK
Android NDK and Android Platform Tools
OpenJDK 1.8
Android Device setup
Android SDK
The Android tools needed by Omniverse can be attained by the more robust Android Studio or by the Command Line Tools.
Install and Configure Android Studio
Android Studio is needed to get the APK tools and to configure our environment.
Once downloaded Install
Once installed launch Android Studio
Upon starting Android Studio, Select “Configure > Configure SDK” to adjust the SDK properties
Select the SDK Platform Tab
Check-On
Android 11
Check-On any additional Android Versions to match your target Android Device(s)
Select the SDK Tools Tab
Check-On
Google USB Driver
Select OK/Apply to continue and install the necessary components.
Once installed, you can close Android Studio
Omniverse USD Composer Environment Variables
Once we have Android Studio installed we need to create Environment Variables for the Platform Tools
In Windows, Open a File Explorer window and Select the address Bar
Type
%localappdata%
to open your local user app data folder.Open Android, then SDK, then platform-tools
In the address bar and select and copy the path
Press the windows Start Button amd type “Env”
Select “Edit the System Environment Variables” to open the System Properties panel on the Advanced Tab
Select “Environment Variables”
In the System Variables list, Locate
Path
and select “Edit”In the resulting window press “New”
Paste the path to the Platform Tools folder and add a trailing \
Typical Path
C:\Users\USERNAME\AppData\Local\Android\Sdk\platform-tools\
Press OK to commit the system variable
Test adb
Open a command prompt and type
adb help
If the help output is delivered from adb, you have successfully installed the android environment and created the necessary paths.
Connecting Your Android Device
Enable Developer mode on the target device
Enable Debug Mode on the target device
Connect the target device to the host workstation
Open a command prompt and type
adb devices
If connected, your device should be listed
Install NVIDIA Omniverse™ CloudXR on Your Device
Navigate to NVIDIA Omniverse™ CloudXR Installer
If installed with defaults, path will be
C:\Program Files\NVIDIA Corporation\Omniverse\Kit\
+ Installed Kit Version Number +omniverse-xr-installation folder\exts\omni.kit.xr.system.cloudxr21\xrclients\googlear
Copy the path from the Windows Explorer Address Bar
Launch Command Prompt in Administrator Mode
Press Start Key on Keyboard and type
cmd
Select “Run As Administrator” on the Command Prompt
Install NVIDIA Omniverse™ CloudXR
Type
cd
+ <space> then Paste (Ctrl+V) the path and hit enter.Check that device is still connected and not “locked” or “asleep” then type
adb install ar-sample.apk
If the install process hangs on “Error: Device not authorized”
Press Ctrl + C to stop adb from executing
On the android device, look for authorization notification
Accept/Authorize the host computer and repeat Install CloudXR step
On your android device a new application called
CloudXR ARCore Client
should be available in your application list.
Connecting with the Android Client
Launch CloudXR ARCore Client on your Android Device.
Enter the IP Address of Host Computer on CloudXR Server IP Address line in NVIDIA Omniverse™ CloudXR Settings.
Use Device to slowly scan your surroundings. Allow device to create a “Grid”.
Tap Screen on any grid location to select where you want NVIDIA Omniverse™ CloudXR to Display your Omniverse Kit Content
The mesh should now appear and allow you to review your model in AR on your device.
Note
Once your model appears, you can reposition your model to another place on your grid by a long tap and hold on the screen. When the grid shows up again tap the new position to re-position the model.