Welcome Guest, you are in: <root>Elements • Login

Page History: Audio Player Element

Compare Page Revisions

7 6 5 4 3 2 1 0 Current 7 6 5 4 3 2 1 0

« Older Revision - Back to Page History - Newer Revision »

Page Revision: 2011/07/18 11:14

The audio clip element can play audio files, of different formats, stored as resources in the Library.

Table of Contents [Hide/Show] Description Snapshots Practical Use Generic Properties

Description ¶

Selecting Event – Add Element command and selecting Audio Clip under the Stimuli grouping will add a new Audio Clip element. The audio clip element can play audio files, of different formats, stored as resources in the Library. The element is designed for delivering audio feedback to participants or playing voice instructions. Several audio items can be loaded into an element's resource list, in order to make a switchable stimuli set. Different audio formats are supported provided that the appropriate codecs are installed on the system being used (the files have to be played correctly by other software players). The playback of some audio formats may be delayed due to a decoding script run by a background codec program, so this should be checked where necessary.

Snapshots ¶

Snapshot 1

Snapshot 2

Practical Use ¶

If, under the Properties tab, the Behaviour property is set to pmOnce or pmLoop, the start of playback is aligned with the activation of the parent event. Playback can also be controlled manually by setting the property IsPlaying to true or false at the runtime. Other playback properties such as the volume, balance and playing position also can be adjusted dynamically.

Generic Properties ¶

Name	Description	Attributes	Value Type
Calibration
Test Audio	Plays the current audio resource from the resource list of the element	Design-time command
Control
Behaviour	Defines the playback method for the element: pmOnce – the current audio resource is played once starting at the time of activation of the parent event. pmLoop - the current audio resource is played repeatedly starting at the time of activation of the parent event until the latter is disactivated. pmNone - the playback doesnot start automatically until the property Is Playing is set to true	D,R	stPlayMethod, Int32
Is Playing	At the runtime indicates if the current audio resource is playing or not at the given moment of time. While playing, set it to false to make a pause. If the playback is finished, set to true to initiate it again.	R	Boolean
Playback
Volume	Volume of playback, from the ground (0) to full (100)	D,R	Int32
Balance	Stereophonic balance of playback, from -100 (left) to 100 (right). Zero is default center.	D,R	Int32
Duration	Indicates the total duration of the current audio resource in seconds	R, Read-only	double
Position	The current position of playback, in percents. Can be used for fast adjustments of the playback position at the runtime. If the property value is set to non-zero at the design time, then playback at the runtime will start from the defined position.	D,R	float

+=== Properties inherited from clLibraryElement ===

Name	Description	Constraints	Value Type	Upon Runtime Change
Material List
Selected Index	Defines the index of the active item in the material list of the element.		Int32	A change causes the current item to be reloaded and an update of the element.
Selected Item	Defines the name of the active item in the material list of the element. The name matches to a name of item in the Material Library		String	A change causes the current item to be reloaded and an update of the element.
Item Count	Returns the total number of items in the material list of the element.	Status..	Int32
Equalize RGB	The property is only available in the visual element. If the value is true, the average RGB pixel intensity will be equalized across all items in the material list. You can turn on this property, when you need to obtain a luminance-balanced set of visual stimulus.	Design Time..	Boolean

+=== Properties inherited from clElement === Inherited properties of clElement

Name	Description	Constraints	Value Type	Upon Change
Control
Is Enabled	If set to false the element is completely omitted when the experiment is run.	Design Time..	Boolean
Title	Title of the element.	Design Time..	String