STISIM Drive (SDL) - PR - Play Recording

Play a previously recorded message. This option allows you to play any message recorded using your computer's sound system. The files that you create for this option must be in the Windows ".WAV" format. See the Simulation Auditory Feedback section for more details on your sound system. The play recording event has the highest priority of all playbacks. Therefore if a recording is playing (siren or crash for example) when a recorded message is started, the recorded message will be the one played.

EVENT PARAMETERS:

PARAMETER 1:	The complete name of the file that contains the message to be played, including the path. You must include the file name extension (.WAV) in the file name.
PARAMETER 2:	The playback flag: To specify the type of playback, set parameter 2 to one of the following: 0 - Play the recording and continue to run the simulation 1 - Play the recording, continue to run the simulation, but hold all subsequent events until the recording has finished
PARAMETER 3:	Volume control when playing back the file. Values range from 0 to 10.

EXAMPLES:

1000,PR,C:\STISIM\SOUND\TRAIN1.WAV,1,10
1000,PR,C:\STISIM\SOUND\TURNLEFT.WAV,0,10

The PR event is generally used during training scenarios but can be used at anytime during a simulation run. Using the PR command allows you to create training scenarios that are totally automated because you can record and play the instructions back to the driver without the use of an experimenter. This also guarantees that each driver gets the exact same instructions. This event is also ideal for giving instructions to drivers as they travel through the simulation.

In the first example shown, the previously recorded file TRAIN1.WAV will begin playing after the driver has traveled 1000 feet down the road. Since parameter 2 is set to 1, then all subsequent events will be suspended until the recording has finished. This example would most likely show up in a training scenario. The second event line is an example of using the PR event in an actual scenario. The TURNLEFT.WAV file would contain a message telling the driver to turn to the left. After the driver has traveled 1000 feet down the road, STISIM Drive would play the recording. In this case, parameter 2 is set to 0 and therefore all events will continue to be displayed.

Since both of these examples are supposed to provide driving instruction to the driver, their volume control has been set to the maximum value of 10.