Vrtigo Analytics for A-Frame

https://vrtigo.io

Installation

npm install --save vrtigo-aframe

Setup

import vrtigo from 'vrtigo-aframe';
vrtigo.setAppId('<Your App Id>');
vrtigo.setUserId('<Your User Id>');

Additionally, add an entity with the vrtigo component to the root of your scene.

    <a-entity vrtigo></a-entity>

Please contact [email protected] to obtain an App Id for your A-Frame application.

Introduction

Vrtigo collects and processes metrics in 360 video applications. The vrtigo-aframe package allows developers to integrate Vrtigo into their A-Frame VR applications that make use of 360 content.

Pose Data Collection

All pose data collection is controlled by the Vrtigo API functions in the SDK API table below. The start, unpause, seekEnd, and bufferEnd functions all require an integer representing the relative play position of the video in milliseconds (positionMillis).

The start function, called when a video initially starts playing, additionally requires a string indicating the video being viewed (videoId).

It is important to instrument any event where the playback time changes in the video, such as buffering and seeking/scrubbing, so that the analytics are in sync with the viewer’s behavior.

Interactive Data Collection

This guide describes how to configure Vrtigo Analytics for an interactive experience. It assumes that you’ve already integrated Vrtigo with your app.

Your app may have multiple interactive ‘scenes’. Think of a scene as a self-contained experience that offers one or more choices to the user. For example, a single interactive 360 video experience might be a scene, even if it is made up of multiple underlying assets. Giving the user the ability to time-travel between different parts of the same video is another example of a scene.

Start each scene with vrtigo.startInteractiveScene(interactiveId). Each time the user is presented with a choice, call vrtigo.presentChoice(choiceId). If you’re collecting pose data, you might choose to stop pose collection at this point. When the user makes their choice, call vrtigo.userChoice(choice) with a name identifying the choice. If you stopped collecting pose data when the choice was presented, you can start it again now. In some cases, you may want to make a choice for a user without presenting them one. Call vrtigo.forceChoice(choice) for that behavior.

The arguments interactiveId, choiceId, and choice and be any arbitrary strings. End your interactive scene with vrtigo.endInteractiveScene().

Data Submission

You control when to send data to Vrtigo. To send data after video playback ends, simply call the submit function after calling the stop function. Important: call submit after calling stop and before calling start again. The submit function returns a Promise object, so be sure to catch any potential errors when calling it.

SDK API