About this workspace
Contact the owner / RSS feed / This workspace is public
|
back to Layar Vision Index
Here we explain what layer developers need to do to enable Layar Vision in their layers. It contains the following topics:
Basic Concepts
In Layar, an augment is a digital model (2D or 3D) rendered on a target object as seen through the mobile phone camera lens.
A target object is a physical or digital visual entity that contains enough detail to be unique whereby a person can point their phone at said “object” to see the augment (if available).
A reference image is the file uploaded by a developer for analysis so that the object depicted in the file can become a target object; thereby, enabling target tracking of said object. Layar will extract the details of each image to create the unique fingerprint of the object. We will store this as specified in our updated Terms and Conditions. We will keep the reference image in our database as they might be needed for future improvements of our algorithm. Please check Reference Image Best Practices on how to create good reference images. Changes in GetPOI API v6.0
Layar Vision can be enabled by returning a reference image in the getPOI response, for instance,
"hotspots": [ ... } ]
In Hotspot object, we added a new "anchor" object that contains either Geo-location or Vision information. For Vision enabled layer,
To know the detailed changes to getPOIs API v6.0 changes, please read here .
Changes to layer definition
To enable Layar Vision, the following changes have been made on the layar publishing site.
On "create a new layer" page, an option to enable "Layar Vision" is added to indicate that this layer is a Vision enabled layer. This option can be edited later under the "General" tab of the "layer editing" page. NOTE: If "Layar Vision" is enabled, this will also change the Layer type to 3D and 2D objects in 3D spaces and the Minimum API version to version 6.0 automatically after the settings are saved.
2. The ability to upload and maintain reference images for a layer
A new tab called "Layar Vision" is added to the layer editing page. Reference images can be uploaded and maintained here.
For the uploaded reference image, the following information needs to be provided:
Once a reference image is uploaded, the legend below is used to show ratings assigned by Layar server based on the quality and clarity of images and their ability to be used for Layar Vision.
The general flow of enabling Layar Vision
The key components to enable Layar Vision are:
If we have a layer which has Layar Vision enabled and a reference image is uploaded to the layer definition on the publishing site, the interaction among Layar server, Third-party developer POI server and Layar client can be demonstrated using the diagram below:
Try out Layar Vision Demo Layers
To show case the new possibilities in Layar Vision, we have created several demo layers for developers to play with.
1. Cantine Layer
Our first demo layer for Layar Vision. Just search for "cantine" on the Android beta client . You can also watch it below:
We also created a tutorial which further explains how to create the demo Cantine layer. The complete JSON response of this layer together with the reference images are provided in the Cantine_layer.zip file. This zip folder contains:
2. Kitten Edition Layer
Kitten Edition shows the functionality of Layar Vision through the Internet-renowned image of an adorable kitten who happens to be dressed as Link from The Legend of Zelda. The tutorial focuses on how to create the laser eyes effect !! The complete JSON response of this layer together with the reference images and 3d models are provided here.
Want to create your own Vision layer ? A tutorial is also available to help you get started quickly.
|