Skip to main content

Requirements

Platform Requirements

The Aila framework requires iOS/iPadOS 16.0 or greater.

Architecture Support

  • Real Devices: armv7 and arm64 architectures
  • iOS Simulator: i386 and x86_64 architectures for building; however, all function calls will not function and scanning will not occur, as the iOS Simulator has no access to a camera

Permissions

Due to privacy concerns, iOS/iPadOS regulates access to video and audio recording. Because Aila requires such access, Aila_Init() may cause the operating system to present the user with a permission request dialog. If the user denies permission, an error is reported and all Aila API calls will not function.

After permission is granted or denied, the operating system stores the user's decision, and dialogs will not be presented again. Changing the permissions requires manual intervention through system settings.

In addition, certain mobile device management (MDM) solutions can disable video and audio recording. Such MDM restrictions will prevent Aila from functioning.

warning

When deploying an application that uses the Aila SDK, care must be taken that video/audio permissions are granted, and that MDM restrictions are not in effect.

Audio and Camera Control

During normal operation, the library requires exclusive control over audio playback and recording. The application must not play or record any sound, as this will interfere with case communications. If the application must play audio through the device's built-in speaker, audio control can be temporarily obtained using Aila_EnableSpeaker() and then released using Aila_DisableSpeaker().

Similar restrictions apply to the device camera. See Aila_ReleaseCamera() and Aila_RegainCamera() for temporary camera access.

Mobile Imager Background Modes

For the Mobile Imager for iPod (legacy product), ensure the following are enabled in Background Modes in the application's Info.plist to enable charging:

  • Audio, Airplay, and Picture in Picture
  • Background Fetch

The mobile sled will charge when the iPod itself charges.

warning

For the Mobile Imager only, if the required background modes are not added, iOS will prevent charging when the application is in the background or the screen is off.

Standalone Usage Restriction

The Aila SDK is intended to be used with Aila hardware such as the Interactive Kiosk. For development and testing purposes only, a limit of 250 barcode scans may be performed when not connected to the kiosk. If this limit is exceeded, subsequent scans will return the string <UNLICENSED> and an error message will be emitted to the system log. Connecting to Aila hardware resets the limit. Standalone usage is only permitted in a development environment.

This restriction does not apply when licensed for Aila SoftScan.

info

To use the SDK without hardware limitations, contact Aila about a SoftScan license.