- Create a new app in Quixxi Portal using Add
New button
. - In “Create your app” dialog give a name of your application and
click Continue
- Click the newly created app and choose
"Control"
in header tab and choosePackage
in left side menu. - Click
"Add Platform"
and choose Hololens as platform and checkAnalytics
in Select module option. - Give proper package name for your application and click on
"Start Packaging"
. - Now Quixxi will pack Analytics framework and notify you once it gets completed.
- Click
"Download Demo"
to receive a complete demo application which showcases the features of Analytics framework. - The app is ready to go and you can read
here
how to install it. - Click
"Download Library"
to get the library
Editing your project.json file
First of all edit your project.json file and be sure to include the following two lines among your dependencies:
<span style="font-size: 16px;"><span style="font-family: 'Times New Roman',Times,serif;">dependencies": { "Microsoft.NETCore.UniversalWindowsPlatform": "5.2.2", "quixxi.analytics.hololens": "1.0.0-preview8" },</span></span>
In this way, every time you will reload the NuGet packages needed for your project and you will automatically work with all the latest updates available for our library. Our NuGet package is available here too.
Initialization
Please instantiate your QuixxiAnalytics object in your app’s launcher class as follows:
<span style="font-size: 16px;"><span style="font-family: 'Times New Roman',Times,serif;">private readonly string appGUID = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"; private readonly string appKEY = "YYYYYYYYYYYYYYYYYYYY"; QuixxiAnalyticsLibrary.QuixxiAnalytics quixxi; quixxi = new QuixxiAnalyticsLibrary.QuixxiAnalytics(appGUID, appKEY);</span></span>
appGUID and appKEY of your app are two string values provided by the Developer’s_readme.txt file.
User/Device registration
For registering the user and the device details with Quixxi, you need to call the following callback after QuixxiAnalytics initialization
<span style="font-size: 16px;"><span style="font-family: 'Times New Roman',Times,serif;">quixxi.PostUserRegistrationData();</span></span>
Events
In order to upload user events you can use the following callback:
<span style="font-size: 16px;"><span style="font-family: 'Times New Roman',Times,serif;">quixxi.PostUserEventsData(event_name, event_value);</span></span>
event_name : a string to identify your event.
event_value : a string containing your event value.
Diagnostics
Caught exceptions can be pushed to Quixxi with the following callback:
<span style="font-size: 16px;"><span style="font-family: 'Times New Roman',Times,serif;">try { // your code here } catch(Exception ex) { quixxi.PostExceptionEventsData(ex); }</span></span>