ARToolKit for Unity on Android

From ARToolworks support library

Jump to: navigation, search

Main Page > ARToolKit for Unity > ARToolKit for Unity on Android

Contents

Requirements

You must have a Unity Pro with Android Pro license to be able to export projects from Unity that use the ARToolKit for Unity plugins.

Player Settings

When exporting to Android, some Player Settings must be configured as follows to work correctly with ARToolKit for Unity (settings not mentioned can be adjusted to suit the user):

  • Resolution and Presentation
    • Orientation: "Landscape Left" - required so that the live video is oriented to match the screen.
    • Use 32-bit Display Buffer: ticked (checked)
  • Other Settings:
    • Bundle Identifier: For testing, set to "com.mycompany.myapp". Note however that this will need to be changed before deployment of your finished application, or else it will lead to conflicts when other ARToolKit for Unity applications are installed on the device. See below for instructions on how to change prior to deployment of your finished application.
    • Minimum API Level: "Android 2.2 'Froyo' (API Level 8)" or higher.
    • Device Filter: ARMv7 only. If you wish to support older ARMv6 with VFP-level devices, please see the readme in the folder "extras/Native plugin for Android ARMv6 deivce" in your ARToolKit for Unity SDK.
    • Graphics Level: OpenGL ES 2.0

Setting the Bundle Identifier

In ARToolKit for Unity Android applications, changing the bundle ID in the Unity Android "Build settings" also requires that the bundle ID be manually changed in the Android manifest. To do this, look inside your Unity project folder, for the file Assets/Plugins/Android/AndroidManifest.xml. Open the file in a text editor and locate the text package="com.mycompany.myapp", editing the "com.mycompany.myapp" to match the bundle identifier set in Unity.


Tested Devices

Unity maintains its own list of Android devices which have been tested with Unity alone: here. You should verify that your device works with Unity at all before attempting to use the ARToolKit for Unity plugin.

Additionally, the ARToolKit for Unity plugin has currently been tested on:

  • HTC Desire
  • HTC Evo 4G
  • Samsung Vibrant (T959 Galaxy S)
  • Samsung Galaxy S
  • Samsung Galaxy SII
  • LG Optimus 3D
  • Samsung Galaxy Tab 2 7.0

Known Issues

ARToolKit for Unity release 2.0.3 was unable to be verified on an Android OS v2.2 device, and we caution against attempting to support Android OS 2.2 devices with this release. We hope to restore 2.2 support in a future release.

On Android OS releases v2.2.x and earlier, a defect in the handling of compressed resources inside .jar files embedded in .apks limits the size of compressed resources to as little as 1.0 megabyte (although this can be higher on some variants of the 2.2 OS series, depending on the device manufacturer). This imposes a limitation on the size of the NFT datasets which can be used if targeting Android 2.2 to 1.0 megabyte. This limitation was removed in Android OS 2.3.

Views
Personal tools