Developer Guide

Load 3D models embedded into your app with CraftAR AR SDK

icon Date Developer Guide

icon Date Jul 23, 2019

icon author Catchoom Team

icon folder , , ,

This article applies only to the Augmented Reality SDK.

The Augmented Reality SDK let’s you render 3D models into the AR scene.
Those models can come from:

  • the online web content creator and downloaded automatically once the object is recognized; or
  • embedded into your app and loaded programmatically at runtime.

For both options, the Augmented Reality SDK provides means to know the status of the loading process.

This article describes how to load a 3D model that is embedded into the app on iOS and on Android. For 3D models downloaded from the cloud at run-time, you can read the separate dedicated article.
In order to add 3D model contents on top of the reference image programmatically is as easy as creating the 3D model with the name of the model stored in the resources of the application.

Loading the embedded 3D model on Android

The following lines show how the content is created for a 3D model called “pizza.obj” using the Android Augmented Reality SDK:

In this case, the model has been added to the project inside the res/raw directory. The Android SDK takes care into copying resources in this folder to the external storage, if available.
Note: Eclipse is very restrictive about file names in the res folder. If you find issues adding your models there, you can compress them into a file named The SDK will uncompress that file when the application is ran for the first time.

Loading the embedded 3D model on iOS

The following lines show how the content is created for a 3D model called “pizza.obj” using the iOS Augmented Reality SDK:

Related Posts in Developer Guide