Page History: Audio Player Element
Compare Page Revisions
Page Revision: 2016/05/08 12:52
|
New Element
|
| Info |
| Category: |
Multimedia |
|
AddIn: |
Base Elements |
| Creator: |
OkazoLab Team |
|
Scope: |
Parent Event |
| Owns Snippets: |
no |
|
Usage: |
Runtime Screen,Snippets |
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 |
| Playback mode | 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, from the ground (0) to full (100), of the audio clip | D,R | Int32 |
| Balance | Stereophonic balance of playback, from -100 (left) to 100 (right). | D,R | Int32 |
| Duration | The duration of the current audio clip in seconds. | R, Read-only | Double |
| Position | The current playing position (percentages, 0..100, to the total duration) of the audio clip. | D,R | Double |
+=== 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. | | 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. | | 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. | | Boolean |
|
| Title | Title of the element. | | String |
|
Audio Player element allows a playback of audio clips stored in Material Library. Various audio formats are supported, including mp3. The element provides all playback controls and onset playback synchronization. Multiple clips can be loaded into element's list in order to form a stimulus set.
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.