# Vuforia Primer

## Create a Developer Account

Head to the [Vuforia Developer Portal](https://developer.vuforia.com/vui/auth/register) and register for a Vuforia developer account.

Once you have verified your account, [Log In ](https://developer.vuforia.com/vui/auth/login)to the **Vuforia Developer Portal**.

## License Manager

Each application that you create using Vuforia **requires a License Key**. These License keys are **free** for development. 

1. In the **License Manager** page, `Develop > License Manager` select **Get Development Key**
2. **Enter a License name** (usually the name of your application). 

![Figure 0.1.1 - Adding a Development Key](https://1820679795-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXautSvCbUco5Lv7YrH%2F-LYZK9y8Wl8jdT2P34mj%2F-LYZUQJdH88-S0AyqO61%2FScreen%20Shot%202019-02-13%20at%2012.34.00%20pm.png?alt=media\&token=9a867971-d3ac-4b5f-92fe-f18bc667805f)

{% hint style="info" %}
Note that this is a **free development key** and for apps that are **not monetised**. If you wish to create a monetised app, select **Buy Development Key**
{% endhint %}

Once you have created a license key, they are stored within the License Manager. Click on the License Name to access the license key. 

## Target Manager

Targets refer to objects which your application will recognise. You can create a database with several targets, so that when each of those targets are recognised, different content can be displayed.

1. In the **Target Manager** page, `Develop > Target Manager` select **Add Database**
2. **Enter a Database name** (usually the name of your application) and select **Device** as the Database type.

![Figure 2.0 - Creating a Target Database](https://1820679795-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXautSvCbUco5Lv7YrH%2F-LYZK9y8Wl8jdT2P34mj%2F-LYZXeX-QUzMLWTt5ls4%2FScreen%20Shot%202019-02-13%20at%2012.45.20%20pm.png?alt=media\&token=5c221d1d-a134-4e34-b599-cdd57875cd3b)

### Adding Targets

Targets can refer to images or 3D objects. To add targets to your database, click **Add Target**

In the **modal pop-up window:**

![Figure 2.1 - Adding Targets to the Target Database](https://1820679795-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXautSvCbUco5Lv7YrH%2F-LYZK9y8Wl8jdT2P34mj%2F-LYZZI3EWhipa2myTWUU%2FScreen%20Shot%202019-02-13%20at%2012.52.19%20pm.png?alt=media\&token=00778c7e-b86a-4ec3-bc57-7c0f46064d3a)

1. **Select** a **Target Type** (Images are generally the easiest to work with)
2. **Upload** the **selected file**; and
3. **Enter** any other **required parameters** such as **dimensions**
4. **Click Add**

{% hint style="info" %}
Vuforia has [sample targets](http://developer.vuforia.com/sites/default/files/sample-apps/targets/imagetargets_targets.pdf) available to download from their [library](https://library.vuforia.com/content/vuforia-library/en/articles/Solution/sample-apps-target-pdfs.html).
{% endhint %}

Once the target has been uploaded, the target should have received a **star rating**. Click **refresh** on the bottom right of screen if the target has not received a rating.

![Figure 2.1.1 - Rating Targets](https://1820679795-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXautSvCbUco5Lv7YrH%2F-LYZK9y8Wl8jdT2P34mj%2F-LYZ_sQK2DHZRbkXZwft%2FScreen%20Shot%202019-02-13%20at%201.02.06%20pm.png?alt=media\&token=aa2f4b13-3c06-40fb-87a9-78c316c0d38c)

The **star rating** refers to how many **tracking features** a particular target contains. We recommended to **only use targets** with a rating of **four stars or more**.

By **clicking** on the particular **target name,** you can view the number and location of **tracking features**.

![Figure 2.1.2 - Showing Target Features](https://1820679795-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXautSvCbUco5Lv7YrH%2F-LYZK9y8Wl8jdT2P34mj%2F-LYZaL2uRCB4BRMYzSf9%2FScreen%20Shot%202019-02-13%20at%201.02.01%20pm.png?alt=media\&token=830549af-8ee6-4d41-a5cd-16d379d3e491)

{% hint style="info" %}
You can learn more about **Image Targets** from the [Vuforia Library](https://library.vuforia.com/articles/Training/Image-Target-Guide)
{% endhint %}

**Add** as many **targets as required**.

![](https://1820679795-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXautSvCbUco5Lv7YrH%2F-LYZK9y8Wl8jdT2P34mj%2F-LYZbrG3Fa8BpkarsCQ1%2FScreen%20Shot%202019-02-13%20at%201.11.03%20pm.png?alt=media\&token=b482b92a-1f4a-473b-b961-011274505766)

### Downloading a Target Database

After all targets have been added to the database, **Download the Database** using the button on the top right of the `Targets` window

**Select** **Unity Editor** as the **Development Platform**

![Figure 2.2 - Downloading a Target Database](https://1820679795-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXautSvCbUco5Lv7YrH%2F-LYZK9y8Wl8jdT2P34mj%2F-LYZcqXCt1u1zTOufM65%2FScreen%20Shot%202019-02-13%20at%201.15.23%20pm.png?alt=media\&token=ff2c1012-f12f-4e00-b025-633044e46c4e)

The **database** may take several minutes to compile, **depending on the sizes and number of targets**. The **database** will be downloaded as a `.unitypackage`

## Importing Vuforia Packages in to Unity.

In your **Unity Project**, head to `Assets > Import Package > Custom Package`

![Figure 3.0 - Importing Custom Packages](https://1820679795-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXautSvCbUco5Lv7YrH%2F-LYZpUMmRqEZgRZi00Pt%2F-LYZrO5l0o6xUrFkCqJ4%2FScreen%20Shot%202019-02-13%20at%202.15.31%20pm.png?alt=media\&token=5d5e3fa8-7add-4d56-a747-5a73f987c96c)

**Select** the recently downloaded `.unitypackage` file.

In the **Import Unity Package** window, **select all objects** and click `Import`

![Figure 3.0.1 - Importing Unity Package Assets](https://1820679795-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXautSvCbUco5Lv7YrH%2F-LYZpUMmRqEZgRZi00Pt%2F-LYZrWCDgf2roVHox0mW%2FScreen%20Shot%202019-02-13%20at%202.15.51%20pm.png?alt=media\&token=89b9dc4f-3bba-4981-ac1c-7f365f62999f)

The **Imported Vuforia Assets** will appear in the **Project window**.

![Figure 3.0.2 - Vuforia Assets in the Project Window](https://1820679795-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXautSvCbUco5Lv7YrH%2F-LYZpUMmRqEZgRZi00Pt%2F-LYZrzs2agFPvdEI2_bW%2FScreen%20Shot%202019-02-13%20at%202.20.56%20pm.png?alt=media\&token=652e6aba-8940-49f9-a5d1-d9eb5d9611b1)

## Going Further

See: [Creating a Simple AR App](https://ms-kb.msd.unimelb.edu.au/next-lab/augmented-reality/guides/unity-and-vuforia-1/vuforia-primer) to learn **how to use Vuforia elements in Unity**

{% content-ref url="vuforia-primer" %}
[vuforia-primer](https://ms-kb.msd.unimelb.edu.au/next-lab/augmented-reality/guides/unity-and-vuforia-1/vuforia-primer)
{% endcontent-ref %}