Skip to content

Devices and Recording Data

martinkonopka edited this page Apr 23, 2018 · 7 revisions

Following possible data sources are supported in UXC:

  • Tobii Pro eye trackers - using the Tobii Pro SDK - Tobii X2-60 and TX300 were tested,
  • Webcam video and audio recording - using the FFmpeg binary,
  • Screencast video recording - using the UScreenCapture utility and FFmpeg binary,
  • Keyboard and mouse events logging - using the Windows API hooks,
  • External events logging - using the locally hosted REST API and websockets with ASP.NET SignalR.

Device types

Each devices has assigned its own type code. This is used throughout session definition, session recording data, API and elsewhere. Currently used type codes:

Device states

Each device can be in one of the following states at a time.

  • Disconnected
  • Connected
  • Recording - implies Connected
  • Error - requires reconnection

UXC controls devices automatically, but connecting and disconnecting a device can be also done manually in the app UI.

Recording data

All devices are data sources for session recording. Except of streaming devices - screencast, webcam video and audio recording - all devices write structured data into session data files. Each data sample contains common field Timestamp with local timestamp when the event was received by the app from the device.

See help page of each device for structure and contents of recorded data.

Configuration

Each device may support configuration from two sources:

{
    "project": /* project name */,
    "name": /* session name */,
    "devices": [
        {
            "device" : "WCV",
            "configuration": { "preset" : "HD" }
        },
        // ... other devices 
    ],
    // ... other SessionDefinition settings
}

See help page of each device for specific configuration settings.

Clone this wiki locally