Links
Comment on page

Hello World

Place a waving character at a position on the ground, then start scanning around the area to save its position in the world. Load the map again to see it in the same spot, this time it's dancing!
After following all the Building Steps, this set of instructions will show you how to use the Hello World example.

Mapping & Saving

  1. 1.
    Open the app
  2. 2.
    Click the New Map button
  3. 3.
    Place the Circle Icon on a surface of your choice
  4. 4.
    Tap the icon to place the 3d Model
  5. 5.
    Notice the blue Loading Bar in the lower left had corner, move the device around and scan until the bar fills up.
  6. 6.
    Tap Save

Relocalization

  1. 1.
    Tap Load Map
  2. 2.
    Point towards the area where you placed the 3d Model
  3. 3.
    Done!

Concepts in this sample app

Hello World shows the basic functionality of Placenote:
  • Mapping your environment with placenote will collect features of your surroundings, Providing in-depth information about the placement of digital objects in this setting.
  • Saving your maps collects the features from mapping, as well as any information related to digital objects you may have placed, essentially memorizing exactly where digital objects are placed in the real world.
  • Relocalization is when you want to view a previous map that you had saved in your environment. Say you place a Dinosaur AR pet on the coffee table and then after a few days you want to check in on it, simply load the map and your Dinosaur is right where you left it!
  • Minimum map quality threshold is the indicator in the bottom left corner of the screen. The bar will fill up once enough features are collected in the environment, after which the user is able to save the map. This is intended to encourage users to make well scanned maps so that relocalization is more consistent.
  • ARKit Hittesting searches for real-world objects or surfaces detected through the AR session's processing of the camera image. This allows us to estimate the distance of objects in front of the camera. That's how the circle icon seems to move along the table before the character is placed.