Open Face App

Introduction

The Open Face App is intended for use when you have not yet integrated the emteqVR SDK with your own experience. Designed to be light-weight supplementary app that is run alongside other applications and experiences without the need for up front development. Fully customisable annotations and integrated calibration provide full coverage for data collection, but requiring manual triggering during data recording that the full SDK integration provides automatically for users.

It can be used for rapidly prototyping a data collection series, allowing for proof-of-concept and testing of your collection methods early in development without writing any code. This helps mitigate issues and can help identify additional requirements ahead of time spent on any data collection you are working on.

You can find this app on our downloads page.

Tip

Follow our guide on Best Practice for Data Collection.

Usage

When you run the app it will not automatically start recording data as our other Demo applications do. This is because you will need to setup any annotations you require ahead of any data recording. You will also need to begin data recording in order to be able to complete calibration, however you can connect to SuperVision without a recording running to confirm all checks on Mask Fit.

Mask connectivity will be shown at all times in the top right corner, showing fit state for all sensors along with current values. If this shows grey icons and 0 in all locations then no mask is detected connected to this system.

The app will run if minimised, but will stop recording if closed. It can be used (interacted with) while the user has a VR application running in the foreground without any issues for the user in VR.

The buttons on the left are used to control the main portions of the recording session. With buttons to [Start Data Recording], [Stop Data Recording] and [Start Calibration]. These will be inactive depending on the current state of the app.

Calibration

To run a calibration click the [Start Calibration] button. This will take you to the calibration wizard with manual controls for each step of the facial expressions required. You can move back at any time, if you need to restart a calibration session simply go back and re-enter to begin again.

Calibration

Currently the facial expression steps for calibration are:

  • Neutral - 3 seconds.
  • Smile - 3 seconds.
  • Neutral - 3 seconds.
  • Frown (with brow) - 3 seconds.
  • Neutral - 3 seconds.
  • Eye Brow Raise - 3 seconds.

Follow our calibration guide for best practice on running emteqPRO mask calibration.

Annotations

Annotations are used to mark events within your data so that analysis can be performed. Each calibration step uses event annotations as does various mask fit events that trigger if the contact level with the skin alters during the recording.

To add a new event, simply click ‘+ Add New Event' at the top of the screen at any time.

Add New Event

Tip

We recommend setting up the required events as soon as you open the app and before you intend to begin data recording. There is no need to close the app between recording sessions, simply stop the data recording at the end of each session.

There are two types of event annotation you can add. You can select these options from the ‘Event Type' dropdown.

Add New Event Popup

Data Point

The first being a single event annotation or ‘data point'. This will have a time stamp associated with it, and the text string you assign and will represent a single one of event. The second type is ‘data section', which has the same parameters as a ‘data point' except it has a start and end annotation.

Data Section

The second type is ‘data section', which has the same parameters as a ‘data point' except it has a start and end annotation. For example, during calibration the user performs certain facial expressions for 3 seconds. So a ‘data section' would have two events for the start of the smile and another event 3 seconds later with the smile end event.

Triggering Event Annotations

Once you list is created it will look something like this, though likely with more annotation in the list. A scroll bar will appear depending on the screen size and list length.

Add New Event List

You can then activate any annotation at any time during a recording using the [Set], [Start] and [End] buttons for each annotation. These event markers will be visible as events with the SuperVision app.

You can delete an individual event annotation at any time, or clear them all using the controls for each. You will be presented with a confirmation dialog before they are removed.

Eye Tracking - Coming Soon

This app will also soon feature tobii eye tracking support in a reduced capacity compared with full SDK integration.

Details on this will follow soon…