Kudan

Search results for "{{ search.query }}"

No results found for "{{search.query}}". 
View All Results

Getting Started

This tutorial will show you how to setup an augmented reality project on iOS using KudanAR.

Download Kudan's AR Framework for iOS

To get started, the first thing you'll need is Kudan's AR framework. You can download it on our Download page.

Download the iOS SDK

Download the iOS SDK

Create a new Xcode project

Start up Xcode and create a new Xcode project. If all you want is an AR view, just leave it on the default "Single View Application" and click next.

Amongst other details, you'll be required to enter a Product Name and Organization Identifier. These two fields together make up your Bundle Identifier. You must make sure that this is the same as the Bundle Identifier associated with your API Key. This will either be the Bundle Identifier you used when generating a free API Key, or, if you are using the Development License Key, simply eu.kudan.ar.

Create a new Xcode Project

Create a new Xcode Project

Import Kudan's AR Framework to the project

Copy or move the KudanAR.framework file into the project folder, then import it into the project, either by dragging and dropping the file from the folder into the project hierarchy, or by clicking File -> Add Files to "<Project>" to add the file.

Add Kudan's framework to the project

Add Kudan's framework to the project

Import the libc++ standard library to the project

Import the libc++ library to your project by selecting the workspace of your project, scrolling to the bottom of the General tab, clicking the small + icon in the Linked Frameworks and Binaries section, search for "libc++" and add the libc++.tbd file.

Add libc++ to the project

Add libc++ to the project

Disable Bitcode

If you attempt to build your project now, it will fail, and you will receive the following error message :

Apple Mach-O Linker (ld) Error

ld: '<PathToProject>/KudanAR.framework/KudanAR(KudanAR-arm64-master.o)' does not contain bitcode. You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE), obtain an updated library from the vendor, or disable bitcode for this target. for architecture arm64

clang: error: linker command failed with exit code 1 (use -v to see invocation)

This is because Kudan's AR framework is a fat binary. To disable Bitcode, go to the Build Settings tab of your workspace, scroll down to Build Options, and set Enable Bitcode to No.

Disable Bitcode

Disable Bitcode

Import the ARAPIKey class to your App Delegate

Open the AppDelegate in your project and change it to the following:

#import "AppDelegate.h"
#import <KudanAR/ARAPIKey.h>

@interface AppDelegate ()
@end

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 
{
    [[ARAPIKey sharedInstance] setAPIKey:@"<Put API Key here>"];
  
    return YES;
}

@end
import UIKit
import KudanAR.ARAPIKey

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?
    
    
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

        ARAPIKey.sharedInstance().setAPIKey("<Put API Key here>")
        
        return true
    }

}

Find the API Key for your corresponding Bundle ID:

  • If using your own Bundle ID, this will be the key generated on the website
  • If using the eu.kudan.ar development Bundle ID, you can use the Development License Key. Note that while this key dos not display a Watermark, it cannot be used to upload your app to the app store. To publish your app, you will need to generate a free key on the website (see above), or purchase a license.

Set up your View Controller

Make sure your View Controller is a subclass of ARCameraViewController:

#import <KudanAR/KudanAR.h>

@interface ViewController : ARCameraViewController

@end
import UIKit
import KudanAR

class ViewController: ARCameraViewController {

}

This will allow you to implement the setupContent method in your View Controller. The setupContent method is called when the ARCameraViewController first loads. For example:

#import "ViewController.h"

@interface ViewController ()
@end

@implementation ViewController

- (void)setupContent
{   
  // Setup code goes here
}

@end
import UIKit
import KudanAR

class ViewController: ARCameraViewController 
{
    override func setupContent() 
    {
    	// Setup code goes here
    }
}

If you changed your View Controller to look like the above, you can build and run your app. You should see a camera stream displaying on your screen, but you can't detect or track anything just yet. We'll change that in the next tutorial.


What's Next

Set up an image trackable and add an image to it.

Marker Basics

Getting Started

This tutorial will show you how to setup an augmented reality project on iOS using KudanAR.