Skip to main content

Implementing a Simple App

In this tutorial, you will learn how to use the VLSDK by implementing the 1.Simple sample project that uses the most basic features of the SDK.

1. Create a Project​

1.1 Create a New Project​

  1. Create a Universal 3D project.

alt text

1.2 Add VLSDK​

  1. Select Window > Package Management > Package Manager.

alt text

  1. Select + > Install package from git URL.

alt text

  1. Enter https://github.com/NaverCloudPlatform/ARCeyeVLSDK.git?path=Assets/VLSDK in the input field and click the Install button. Various required packages will be installed when you click the Install button.

alt text

2. Initialize VLSDK​

To use the VLSDK, the following essential elements must be added to the scene in this order:

  1. ARFoundation's AR Session and XR Origin
  2. VLSDKSettings.asset
  3. VLSDKManager

2.1 Add ARSession and XR Origin​

Select GameObject > XR > AR Session and GameObject > XR > XR Origin (Mobile AR) to add each object.

alt text alt text

Delete the Main Camera. The Main Camera is included in the VLSDKManager that will be added later, so this prevents duplication.

alt text

2.2 Add VLSDKSettings​

Select Assets > Create > ARCeye > VLSDKSettings.

alt text

Press the + button in the URL List to add an item. Enter the Invoke Url and Secret Key in the added item. These values can be found in the ARC eye console. If you need a simple test, you can use the Invoke Url and Secret Key provided by the 1.Simple sample project. alt text

2.3 Add VLSDKManager​

Select GameObject > ARC-eye > VLSDK > Create VLSDKManager. alt text

Click on the created VLSDKManager to verify that the TextureProvider component has been added. Assign the image to be used when sending requests to the Texture To Send field of the TextureProvider component. alt text

When you enter Play Mode, you can verify that the VLSDK is working. alt text

3. Project Validation​

To run on iOS and Android devices, some additional project settings are required. We provide a Project Validation feature that allows you to check whether these values are properly configured.

Select ARC eye > VLSDK > Project Validation.

alt text

A window will appear that checks whether the settings are valid. Review the warning messages and press the 'Edit' or 'Fix' button to resolve issues.

alt text alt text

4. (URP) AR Background Setup​

If your project uses the Universal Render Pipeline, you need to use the AR Background Renderer Feature to render the AR environment camera preview.

Select Edit > Project Settings and then select the Graphics tab.

alt text

Set the Default Render Pipeline to Mobile_RPAsset. If you have a separate Render Pipeline Asset you're using, you can use that asset instead.

alt text

When you select Mobile_RPAsset, you can verify that Mobile_Renderer is set in the Renderer List. Select Mobile_Renderer.

alt text

Click the 'Add Renderer Feature' button at the bottom of the Inspector screen and select AR Background Renderer Feature. alt text alt text

Now when you build the app, you can verify that the AR camera screen is displayed.

5. Conclusion​

You now know how to install the VLSDK and create a working project. In the next step, we'll explain how to use ARDataset to develop in an Editor environment with an experience similar to the actual environment.