documentation

System Requirements

License

Generally speaking, you need a valid license file to run VisionLib. If you have just registered, you can use time-limited trial license to get started. For more information, see Licensing.

Unity

  • While we support Unity 2019.4, Unity 2020.3 and higher, we recommend using Unity 2019.4 LTS:
    • We focus our testing on Unity 2019.4
    • Some features (e.g. ARFoundation) might require extra configuration effort on newer Unity versions or will not work at all because of interface changes.
    • The newer versions of Unity change very frequently, so we cannot guarantee that a released version will be resilient to upcoming changes.

Mac

  • A macOS system that supports OpenGL (2011 macOS 10.11 or higher) or Metal (2012 macOS 10.11 or higher).
  • At least 4 GB of RAM and a development environment.

iOS

  • A macOS system for development with Xcode installed.
  • A 64-bit iOS device, for instance one of the following:
    • iPad Air 1 or newer
    • iPad Mini 4 or newer
    • iPad Pro 12" and 9.7"
    • iPhone 6 or newer (not calibrated yet)
    • iOS version 12 or newer
    • We do strongly recommend using an iOS device with A9 or newer processor in order to take advantage of ARKit features.

Windows

Android

  • Building for Android requires Unity 2020 and above.
    • In case of using the ARFoundation VisionLib extension, this implies that using ARFoundation 4.x is mandatory.
  • A system for development.
  • A device running at least Android 5.0 (Lollipop) and at least 1 GB of RAM.
    • If you intend to use AR Foundation, the minimum supported Android version is 7.0 Nougat.
    • Ideally, the device should support ARCore. This way, the calibration will be provided by ARCore.
    • Other devices will need a custom calibration file, which can be created using the VisionLib itself.

Permissions required by VisionLib

Platform Permission Required Reason
UWP Videos Library Optional When recording image sequences on HoloLens, it is hard to download the files if they are stored in the applications internal storage. Therefore we added a memory scheme to write these files into the videos folder, which is accessible via the windows explorer. If you want to do this, you have to provide this permission.
UWP WebCam Mandatory For tracking with the camera it is mandatory to have access to the actual hardware.
UWP Microphone Optional In our example we are using voice commands for interaction with the application. Therefore this permission is required. If you implement interaction in a different way, this permission can be removed.
Android Camera Mandatory For tracking with the camera it is mandatory to have access to the actual hardware.
iOS / MacOS 10.14+ Camera Mandatory When loading a tracking configuration with a camera as input for the first time, the VisionLib will request camera authorization. The loading will fail, if the user rejects the request. Make sure to specify the "Camera Usage Description" in the application's Info.plist file, which will be shown to the user as justification for the camera access.