# 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 %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ms-kb.msd.unimelb.edu.au/next-lab/augmented-reality/guides/unity-and-vuforia-1/creating-an-ar-app-in-30-minutes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.