Skip to main content

How To Run The Program

Overview of Key Components​

OVRCameraRig​

This is the AR camera object

Passthrough​

This object is used to setup a passthrough layer for AR experience

Canvas​

Contains the user interface elements. Initially, the "TakeOffHeadset" UI will appear after each condition, asking the user to remove the headset and fill out a questionnaire.

The code to trigger this is in PlayShot_Female.cs > audioFinishedCoroutine() for female conditions and in PlayShot_Male.cs > audioFinishedCoroutine() for male conditions.

Announcement​

The structure is as following:

Annoucement
|___ Female Announcement    (disable)
|___ Male Announcement      (disable)

Displays announcements before an avatar replaces the dummy object. If the owner is female, the Male Announcement will show up, e.g., "A male student is entering...".

  • The code triggering this is in DistanceController.cs > announcementRoutine().

GameObject​

The structure is as following:

GameObject
|___ Dummy
|___ Male4          (disable)
|___ Female4        (disable)

GameObject contains all the agents (models). Initially, only the Dummy is visible.

The models for Male4 or Female4 will replace the Dummy based on the condition set. The code for this behavior is in DistanceController.cs.

Running the Study​

Step 0: Connection with Headset​

  • Since this project uses HDRP (High Definition Render Pipeline), it's recommended to use CableLink to connect the Quest 3 headset to your system for optimal performance.

Step 1: Reposition the Dummy​

  1. At the start of each condition, a dummy appears. Its position is typically off-screen.
  2. To reposition it in front of the user:
  • Press the Hand Trigger on the right controller (recommended).
  • Alternatively, you can check the "Reposition Character" box under GameObject > Reposition Character.
  1. The character is placed based on where the camera is looking, so ensure you're looking directly where you want the dummy to appear.

The code for this action is in RepositionCharacter.cs.

Step 2: Replace the Dummy with the Correct Agent​

  1. In the Inspector, under GameObject > Distance Controller:
    • Check Is Female, if the visual gender is female; uncheck it for male.
    • Check Owner Is Female, if the owner gender is female; uncheck it for male.
  2. Press Index Trigger or click the Log box under GameObject > DistanceController (Script) in the inspector to replace the dummy with the avatar.
  3. Wait for the 3-second announcement UI, then select the appropriate condition at the end of GameObject in the Inspector. For example:
    • If the condition is FFF, check the box FFF under PlayShot_Female (Script).
    • If the condition is MMM, check the box MMM under PlayShot_Male (Script).
  4. After the avatar finishes speaking, participants have 5 seconds to look at the avatar before the prompt "Take off the headset" appears.
  5. The program will replace the avatar with the dummy after the 5-second period.
  6. Don't stop the program. For subsequent conditions, you can skip repositioning the dummy and begin directly from Step 2.