Viuw Unity Sdk by ViuwAnalytics - 1

AnalyticsSDK

Viuw Unity SDK to enable Augmented Reality spatial analytics.

Unknown VersionUnknown LicenseUpdated 1 year agoCreated on October 2nd, 2018
Go to source

Viuw Analytics Unity SDK

Viuw Analytics enables augmented reality app developers to understand user engagement by delivering spatial analytics of user behavior.

Our Viuw Dashboard is currently in open beta. We are actively seeking developer feedback and suggestions. We have a dedicated team standing by to provide developer support if any issues are encountered on the Viuw Dashboard or in the Viuw SDK.

Supported AR Frameworks

The Viuw Unity SDK is compatible with:

  1. ARKit Plugin for Unity
  2. ARCore Plugin for Unity

Getting started

  1. Create and register a scene at www.viuw.io. Create a scene to view your dashboard.
  2. From your dashboard, generate an API key, Project ID, and Scene ID.
  3. Integrate the SDK to view scene reconstruction and analytics.

SDK Integration

  1. Download or clone this repository, or see Releases.
  2. In your Unity scene, add the Viuw SDK folder to your Unity project files.

Usage

  1. Create an empty game object in your scene hierarchy.

  1. Add the ViuwSession script as a component.

  1. Choose your AR platform from the Platform dropdown.

  2. Specify your API, projectId, and scene Id from the Viuw Dashboard.

  3. Next, you will configure your scene objects.

Understanding Scene Objects

A Scene Object represents a 3D object that you want the Viuw SDK to track and analyze. In the ViuwManager script component, you will see that a Scene Object contains 2 fields:

-Game Object: This takes a prefab from your scene hierarchy and is used to track your object’s transform during an app session.

-Upload Object: This takes a prefab from your project window and is used to upload your object to the Viuw Dashboard, so that it can be visualized. IMPORTANT: Uploaded prefabs must contain a mesh collider, mesh filter, and mesh renderer for them to be properly heatmapped on your Viuw Dashboard.

For example, to set up tracking and upload for this dino_prefab:

Upload your objects to the Viuw Dashboard

  1. For each object, drag the prefab into the Upload Object field of the scene object. These objects must come from your project window files, not from the scene hierarchy. See the annotated screenshot above.
  2. When you are ready to upload, press ‘Upload Objects.’
  3. Upload may take up to several minutes based upon the number and size of selected prefabs. You will receive a success response on successful upload.
  4. If you receive an error message, follow the instructions in the message and try again.

Track your objects

In order for an object to be tracked in-scene, you must drag the game object into the Game Object field of a Scene Object. These objects must come from your scene hierarchy, not from your project window. See the annotated screenshot above.

Confirm your integration

You are all set. To confirm your installation and setup, build and run your app in iOS or Android, and check the ‘Individual Sessions’ dropdown to see that sessions are being logged.

Roadmap

Viuw is currently building support for Vuforia, Hololens, and Meta 2. Tell us what frameworks and hardware you would like to see supported: admin@viuw.io.

Feedback and Support

The viuw dashboard is currently in beta and we would love to hear your feedback. On the Viuw Dashboard, select ‘Feedback & Support’ on the left toolbar. You can also drop us a line at admin@viuw.io.

Show all projects by ViuwAnalytics