Documentation

iOS Cloud Image Recognition SDK

Our Cloud Image Recognition SDK sends images through the Image Recognition API to the CraftAR servers and returns instant responses on collections of all sizes – even ones with millions of images. Our Image Recognition technology offers outstanding accuracy even in non-optimal conditions and our global server infrastructure ensures fast and reliable responses.

Because the heavy processing is done in the cloud, your native iOS app can remain slim even after adding this high-tech capability.

We want to make development easy for you. To integrate the CraftAR iOS Cloud Image Recognition SDK into your native mobile apps, we provide an iOS Framework that you can directly import into your XCode project.

This page gives you pointers to the Tutorials you should follow to integrate this SDK; the documentation of the Classes; how to run the Examples; the Requirements of your system to use this SDK, and finally, Release Notes of our continuous updates.

Download iOS SDK

How to get started with the SDK

In order to get started with the SDK, we recommend you to run the examples included in the distribution that you can download upon request (see button above). The examples are located in the Examples directory as an xCode Project.

Running the examples

The SDK is already linked in the project, available inside the distribution package. You can open it and just run the project from your device (note that running inside the Simulator is not available with the SDK).

The examples app opens a menu view that allows you to open the different examples. Each example opens the camera and the first step is for you to scan any object. We provide a set of reference images to point at that show different experiences. You can find those images in the folder Examples/Reference images.

We strongly recommend that you print this images out for testing. Pointing at them in your laptop/PC’s screen can heavily alter the experience due to artefacts that are invisible to your naked eye but very disturbing when captured with your smartphone.

augmented-reality-item-1augmented-reality-item-2

image-recognition-item

Integrate the iOS Cloud Image Recognition SDK into your own project

Follow this tutorial for instructions on how to integrate the iOS Cloud Image Recognition SDK into your xCode projects.

Requirements

To integrate the iOS Image Recognition SDK into your native app, you will need Xcode 7 or newer, and at least iOS 8.0.

Class Reference Documentation

Follow this link to browse through the classes of the iOS Cloud Image Recognition SDK.

Download iOS SDK

Releases

Version 3.4

July 12th, 2017

  • Changed: (Common) Pods.framework now only contains AFNetworking 3.0.
  • Changed: (Camera) Set focus “point of interest” moved to the CraftARSDK class.
  • Added: (Camera) Add method to run a callback block when the camera is opened to allow custom configurations.
Version 3.3

December 15, 2016

  • Changed: (CloudRecognition) Now you can control the search period through the CloudRecognitionSearchController.
  • Fixed: (Camera) Focus and contrast work better now. Set the focus point of interest instead of “triggering” the focus.
Version 3.2

August 31st, 2016

  • Added: Callback block for the [CraftARSDK stopCapture] message (it’s asynchronous).
  • Added: [CraftARCamera setCapturePreset] allows to use lower resolution video capture to speed up in slow devices.
  • Fixed: Check support for camera features (focus and exposure) before using them.
  • Fixed: Removed warnings produced in xCode due to missing ModuleCache files.
  • Fixed: Removed warnings when compiling for iOS 8.0
Version 3.1

March 14th, 2016

  • We changed singletons to improve swift integration
  • We fixed query image rescaling for Image Recognition
  • We made ‘take picture’ method public
Version 3.0

November 17, 2015

  • New SDK architecture
  • New method to start finder with timeout
  • Added: HD camera preview
  • Fixed: rotated frozen view
Version 2.0.1

December 11, 2014

  • Distribute libs in Universal framework format.
Version 2.0

December 1, 2014

  • The SDK package is now com.craftar
  • The SDK classes are now called CraftARxxx
  • The CloudRecognitionItem class is now called CraftARItem
  • Improved: Faster recognition by using my.craftar.net (points to the geographically closest server)
  • Added: Support arm64 architecture and iOS 8
  • Fixed: several bugs
Version 1.1
  • Fixed: orientation issues.
Version 1.0

October 2, 2013
The first public version of the iOS SDK focuses mainly on our Cloud Image Recognition functionalities.
Learn more about the launch of the SDK in our Releases Blog: Extra, Extra, Read All About our New SDK.