Snobal Cloud SDK

Snobal SDK provides libraries and developer tools necessary to build, test, and integrate your VR/AR apps with Snobal . Snobal SDK is made available under license by Snobal.

You need to have a Snobal account before you can use the Snobal SDK. Reach out to get started.

Typically a normal flow for a VR application using the Snobal SDK would be:

1. Snobal app asks for the pairing code. From this, it installs all the required applications & creates a settings file uses to login.
2. Attendee runs the application, it logs in using the settings file.
3. Application checks for sessions for attendee.
4. Application allows attendee to select which activity they want to do. Any order of activities is allowed.
5. Application opens the selected activity.
6. Application opens the first task.
7. Attendee passes or fails the task. Application closes the tasks with this outcome.
8. Application can reopen the same task or move on to the next.
9. The process repeats until the application deems the activity is over.
10. Application closes the activity with an outcome. That is, lower than 50% of tasks completed is a fail.
11. Application closes the session. This moves the session from the Inprogress to the completed tab.
12. Application logs out. This also happens automatically when the application closes.
13. Application terminates.

In the example below the attendee (Snobal: Nigel) has two activities, DTC Activity1 Name & DTC Activity2 Name. Define the number of activities and task names you require. Each has the required tasks listed with a tick for a pass, a cross for a fail, and a grey circle to show the task has been opened but not closed yet.

This attendee has passed activity 1 (green button) and failed activity 2 (red button). The attempt column shows the number of times the attendee tried on this session, you can repeat the same task again & again.

Example session in progress:

This SDK comes with a sample scene for quick setup and examples. It is recommended to use the SDK in a Unity test project to get familiar before trying to integrate it into an existing project.
It is also recommended to get familiar with your Snobal dashboard before starting, create a new attendee, create a new device, create a new session.

Steps to get started:

1. Create new a Unity project
2. Import the latest SnobalCloudSDK Unity package
3. Goto the sample scene (PairingScene)
4. Go to your Snobal admin dashboard, and create a new device to get a device pairing token.
5. Run the sample scene, enter your pairing code & click pair. The pairing code is used to map this device to a tenant & session. If everything worked well it should create a SnobalCloudSettings.json file in your unity persistent data path. Normally on Android applications, the Snobal app would do these steps but for development on a PC you can write your own pairing UI like this. This only happens once, you can skip the pairing next time.
6. Login with the button, this should display the Snobal tenant or workspace you are paired with.
7. Create a session on your Snobal admin dashboard.  Click the Get session button & you should see the session details displayed.
8. Enter the activity name and press Open Activity. View session details on your Snobal admin dashboard, including the open activity. Continue to watch the session details after each step below.
9. Enter a task name and press Open Task.
10. Close the task with a pass or fail.
11. Repeat 9 and 10 for all tasks.
12. Close activity with a pass or fail.
13. Repeat step 8 for all activities and tasks.
14. Close session.
15. Log out.

Sample scene from the SDK:

Note:

Snobal writes out a settings file called SnobalCloudSDK.json in the persistent data path. It also requires internet access.
Ensure you enable write permission & internet access for your application inside Unity.

Next steps:

1) Check the pairing example script for examples on calling the Snobal functions to pair, login, get a session, open and close activities, and tasks.
2) The SnobalCloudMono game object is the only thing required in order for Snobal to work in any project. Reference the SnobalCloudInstance for access to all the cloud functionality.

Remember not to delete it if you switch scenes.

Snobal SDK works with any platform supported by Unity including Android & PC.

If you cannot locate the answer to your questions here then please submit a technical support question.