Getting started

To try the included ar sample project follow the steps below:

a. Windows

  1. Install Visual Studio 2019 community edition
  2. Copy the SampleProject directory to your project directory
  3. Launch your project by double clicking on the .uproject file
  4. Click on rebuild missing modules when prompted
  5. Press the play button in the editor to start the project
  6. Choose your webcam from the list, select resolution, and press the start button
  7. Use the printed Hiro, or Pinball markers to track the motorcycle

b. Android

  1. Setup your Android development enviroment. https://docs.unrealengine.com/latest/INT/Platforms/Android/GettingStarted/
  2. Copy the SampleProject directory to your project directory
  3. Launch your project by double clicking on the .uproject file
  4. Click on rebuild missing moduless when prompted
  5. File -> Package project -> Android

IMPORTANT: Make sure to also generate an .OBB file. 

  1. Edit ->Project Settings -> Android -> UNCHECK Package game data inside APK
  2. Use the generated .bat file to install the packaged app to your device.

IMPORTANT: 32bit vs 64bit version

Only 64bit builds are supported

Edit ->Project Settings -> Android -> Build -> Uncheck Support armv7
Edit ->Project Settings -> Android -> Build -> Check Support arm64-v8a

IMPORTANT:Camera autofocus:

There is CameraPlayer14.java file at this folder

C:\Program Files\Epic Games\UE_X.XX\Engine\Plugins\Media\AndroidCamera\Source\AndroidCamera\Java\src\com\epicgames\ue4.

You should add line:

param.setFocusMode("continuous-picture");

after line 520.

c. iOS

  1. You will need a Mac computer to package your code project for IOS devices!
  2. Install the latest xcode from apple app store
  3. Setup your iOS development environment,
    https://docs.unrealengine.com/latest/INT/Platforms/iOS/QuickStart/index.html
  4. Go to edit -> project settings -> iOS and import your mobile provision and certificate files
  5. Copy the SampleProject directory to your project directory
  6. Launch your project by double clicking on the .uproject file
  7. Click on rebuild missing modules when prompted
  8. For IOS is necessary to add the following line to the Project Settings > IOS > Extra PList Data>Additional PList Data : <key>NSCameraUsageDescription</key><string>Camera is used for AR functionality</string>
  9. File -> Package project -> iOS

d, macOS

The project uses the free WebCamera feed plugin (https://github.com/bakjos/WebCameraFeed) to grab camera frames on iOS, and macOS

The latest versions of OSX require the request to access to the camera, so this plugin won’t work while in the editor. To be able to use the camera in the binary, you need to edit the .plist file in the packaged mac os build, and add some additional plist data. <key>NSCameraUsageDescription</key><string>Camera is used for AR functionality</string>