External article

How to Run

1. Setup Hardware and Launch External Application
   Make sure your hardware/headset are connected and running and launch the external application you want to record data with (i.e., Unreal, Unity, SteamVR, etc.).

1. Launch the Recorder
   Launch the External_Application_Data_Recorder.py file to get the recorder ready.

1. Choose Window Title
   Choose the Window Title to capture.

1. Select Recording Length
   Select recording length (seconds). You can end early by closing the window or pressing Space.

1. Choose Your Hardware
   Select the hardware profile you’re using.

1. Start Recording
   Put on the headset and press Spacebar (default; configurable). If connected to Biopac, AcqKnowledge transport starts. On supported HMDs you’ll see a live gaze point on the mirrored window.

1. Finish & Save
   When the timer ends you’ll hear a beep. Data goes to the /data folder.

1. Replay Your Session
   View a replay with visualizations by launching the External_Application_Data_Replay.py file and choose your session. (If the replay crashes, you may need to run convert_video_to_fix.py and convert the video.)

1. Scrub Through Playback
   Use the scrubber in the replay to scrub through the playback. Press the 1 and 2 keys to synchronize moving the scrubber in AcqKnowledge if using version 6.02 or higher. (See the Replay page for more information and controls.)

1. Toggle Visualizations
   Toggle visualizations such as scan path, fixation spheres, and the heatmap in the replay. (You may need to toggle items first to see the visualizations. Visualizations other than gaze point are not available for stand-alone Android-based applications.)

   

2. Export Gaze-Overlay Video
   Press 4 in the replay to record a video with the gaze point (plays through in real time). Press 5 to stop. This saves in the replay_recordings folder. Open the recorded video in AcqKnowledge to see synchronization with physiological data. (See sending-events-to-biopac.md for details.)

   

3. (Optional) Experimental AOI Tracker
   Run the Experimental AOI Tracker Tool to tag objects or regions to follow (see below).