XenseAR SDK Integration Guide for Flutter iOS

Prerequisites

Download the Template Project from the Downloads page.
Download the corresponding SDK from the Downloads page.
Prepare the Flutter project that you want to integrate with XenseAR.

Integration Steps

1. Run the Template Project to understand how the SDK works

Run the following command in the terminal:


flutter run

2. Open Runner.xcworkspace in Xcode.

All framework imports and file creation steps should be performed using the Xcode interface.

3. Create a new file named XenseARBridge.swift and copy its implementation from the Template Project.

4. Update AppDelegate.swift using the implementation provided in the Template Project.

5. Add the following permission descriptions to Info.plist

These permissions are required by the XenseAR SDK.


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <!-- ... -->
 
    <key>NSCameraUsageDescription</key>
    <string>Camera access is required for augmented reality features.</string>
 
    <key>NSMicrophoneUsageDescription</key>
    <string>Microphone access is required for audio and web content features.</string>
 
    <key>NSLocationWhenInUseUsageDescription</key>
    <string>Location access is required for location-based augmented reality features.</string>
 
    <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
    <string>Location access is required for location-based augmented reality features.</string>
 
    <key>NSMotionUsageDescription</key>
    <string>Motion data is required for augmented reality tracking.</string>
 
    <key>NSPhotoLibraryUsageDescription</key>
    <string>Photo library access is required to access and save photos.</string>
 
    <key>NSPhotoLibraryAddUsageDescription</key>
    <string>Photo library access is required to save photos.</string>
 
    <!-- ... -->
</dict>
</plist>

6. After completing the steps above, continue to the Usage page to learn how to use the SDK in your Flutter application.