AR Image Tracking Documentation

1. Introduction (Common to Both Assets)

AR Image Tracking provides a fast and user-friendly solution for image tracking in AR applications. This documentation combines AR Single Image Tracking and AR Multi Image Tracking features, offering:

  • Ready-to-use templates for quick setup and implementation.
  • Multiple demos showcasing different functionalities and use cases.
  • Robust tracked image object handling for creating and removing objects dynamically.

Use cases include:

  • Learning AR functionality.
  • Understanding image tracking mechanisms.
  • Integrating image tracking with other components.
  • Prototyping AR applications.

2. AR Single Image Tracking

Overview

AR Single Image Tracking is a simplified solution designed for beginners to learn and implement AR image tracking. It includes:

  • A ready-to-use template.
  • 6 demos showcasing various functionalities such as tracked object editing, transformation, and interaction.

Key Features

  • Quick setup for image tracking with minimal configuration.
  • Robust handling of tracked objects.
  • Support for custom asset integration.

How to Change Tracked Image

  1. Navigate to [Template/Demo Folder]/Blueprints/Data.
  2. Open the D_ARCandidateImage file.
  3. Set the image in “Candidate Texture”.
  4. Configure name, width, height, and orientation.

Testing the App

Launching the App
  • Open [Map_SingleImageTracking].
  • Connect your Android device to the PC.
  • Use the “Launch” button to deploy the app.
Packaging the App
  1. Ensure Android development setup.
  2. Set [Map_OneImageTracking] as the default map in project settings.
  3. Go to File > Package Project > Android, select texture settings, and package the app.

Demos

  • Demo 01: Tracked Object Editing (e.g., color sliders).
  • Demo 02: Component Access (e.g., mesh updates).
  • Demo 03: Object Transformation (e.g., scaling, rotation).
  • Demo 04: Skeleton Mesh with Animation.
  • Demo 05: Virtual Object Selection.
  • Demo 06: AR Business Card with animation.

3. AR Multi Image Tracking

Overview

AR Multi Image Tracking extends the functionality of single image tracking by allowing multiple images to be tracked simultaneously. It includes:

  • A template for multi-image tracking.
  • 5 demos demonstrating advanced use cases such as multi-image interaction and AR measurements.

Key Features

  • Advanced handling for multiple tracked images.
  • Support for dynamic interactions and transformations.
  • Enhanced prototyping capabilities.

Adding or Editing Tracked Images

  1. Right-click > Miscellaneous > Data Asset > ARCandidateImage.
  2. Configure the candidate image (texture, name, dimensions).
  3. Set image and object lists in sequence for tracking.

Testing the App

Launching the App
  • Open the desired map.
  • Connect your Android device to the PC.
  • Use the “Launch” button to deploy the app.
Packaging the App
  1. Ensure Android development setup.
  2. Set the desired map as the default map in project settings.
  3. Go to File > Package Project > Android, select texture settings, and package the app.

Demos

  • Demo 01: AR Measurement (distance between tracked images).
  • Demo 02: Multi-Image Interaction (e.g., moving objects between tracked images).
  • Demo 03: Object Transformation (scaling, rotation).
  • Demo 04: Player Location Detection.
  • Demo 05: AR Business Card with animation.

Comparison to Single Image Tracking

  • Single Image Tracking: Simplified and robust, designed for beginners and single-image use cases.
  • Multi Image Tracking: Advanced, supports simultaneous tracking of multiple images with enhanced functionality.

4. Common Errors and Solutions

Plugins to Enable

  • Android: AR Utilities, AR Core.
  • iOS: AR Utilities, Apple ARKit.

App Not Running on PC/Mac

AR apps cannot run on PC/Mac as there is no AR SDK support. Use Android or iOS devices to test the app.

iOS Build Limitations

Building for iOS requires a Mac. Apple has restricted iOS builds from non-Mac devices.

This documentation provides a consolidated guide for implementing both AR Single and Multi Image Tracking, helping developers effectively utilize Unreal Engine’s AR capabilities.