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 License Types.

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 64-bit Intel (x86_64) or Apple silicon (ARM64) macOS system running macOS 10.13 (High Sierra) or higher with support for OpenGL or Metal.
  • At least 4 GB of RAM and a development environment.

iOS

  • A macOS system for development with Xcode installed.
  • A 64-bit (ARM64) iOS device. E.g. one of the following devices:
    • 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 strongly recommend using an iOS device with an A9 processor (or newer) in order to take advantage of ARKit features.

Windows

  • 32-bit (x86) or 64-bit (x86_64) system running Windows 7 or later.
  • An OpenGL 3.2 compatible graphics card.
  • At least 4 GB of RAM and a development environment.
  • Visual C++ Redistributable for Visual Studio must be installed.

UWP

  • Supported architectures: x86, x84_64, ARM32 and ARM64.

Android

  • Building for Android requires Unity 2020 and above.
    • When using ARFoundation VisionLib extension, AR Foundation version 4.x is mandatory.
  • A system for development.
  • A device running at least Android 5.0 (Lollipop) and at least 1 GB of RAM. Both ARM32 and ARM64 devices are supported.
    • If you intend to use AR Foundation, the minimum supported Android version is 7.0 Nougat. Using an 64-bit (ARM64) device is also strongly recommended in this case.
    • 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.