Xerte Community Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Interactivity > Audio Recorder ======

A page that allows the learner to make, save, listen to and download audio recordings, in response to a text or audio stimulus.  This enables learners to make recordings for later reference, or for upload into a portfolio. Language learners can also compare their own pronunciation to a model. Several recordings (audio clips) can be made on the same page.

===== Example demo =====

{{url>https://xot.xerte.org.uk/xapi_launch.php?template_id=116&group=xertepagetypes#audioRecord}}

**Note:** the Audio Recorder requires browser microphone permissions which cannot be displayed in this embedded example. To demo the full functionality, view the example page at [[https://xot.xerte.org.uk/xapi_launch.php?template_id=116&group=xertepagetypes#audioRecord| Xerte Page Types > Interactivity: Audio Recorder]] (opens in new tab).


===== Editor Interface =====

{{:xerte-inter-categories-editor.jpg?800&direct}}

==== Top Level: Core Properties ====

^ Property ^ Description ^ Type ^ Additional information ^
| Page Title | Text that appears in header of published page | Text |   |
| Page Text | Content that appears at the top of the page | Text+ (Toolbar) | Use this to give the context or instructions for the task.  Other content (e.g. images, audio, video) can be embedded here. |
| Panel Width | {Small/**Medium**/Large/Full}  The width of the panel in which the recording is made and the audio player bars display. | Drop-down |   |
| Clip Order | (**Sequence**/Random}  Allows the recording tasks to display in the sequence in which they appear in the authoring interface, or at random. | Drop-down |   |

==== Top Level: Optional Properties ====

=== Page-specific ===

^ Property ^ Description ^ Type ^ Additional information ^
| Download: Example Audio | Makes the (optional) example audio available for download. | Tick box |   |
| Download: Recorded Audio | Makes the learner's recorded audio available for download. | Tick box | :!: Note that the learners' own recordings are saved in **.webm** format.  This format will play in most up-to-date browsers and in Windows Media Player.  |
| Feedback | The feedback that is displayed when all the recordings on the page have been made. | Text+ (Toolbar) |   |

=== General ===

See [[:optional_properties|General Optional Properties]]


==== Top Level: Language Options ====

^ Property ^ Description ^ Type ^ Additional information ^
| Next Button | Text displayed on the Next button. | Text | Default - 'Next' |
| Previous Button | Text displayed on the Previous button. | Text | Default - 'Previous' |
| Restart Button | Text displayed on the Restart button. | Text | Default - 'Restart' |
| Restart Confirm Text | Text displayed after Restart button is clicked. | Text | Default - 'Restarting will remove all recordings. Do you want to restart?" |
| Clip {i} of {n} | Displays which clip the learner is on and the total number of clips to be made. | Text | Default - 'Clip {i} of {n}' |
| Record Button | Text displayed on the Record button. | Text | Default - 'Record' |
| Stop  Record Button | Text displayed on the Stop Record button. | Text | Default - 'Stop Record' |
| Download Button | Text displayed on the Download button. | Text | Default - 'Download' |
| Delete Clip Button | Text displayed on the Delete Clip button. | Text | Default - 'Delete Clip' |
| Clip Name Text | Instruction displayed when saving an audio clip. | Text | Default - 'Enter audio clip name' |
| Default Clip Name | Name given to the audio clip if the learner does not enter one. | Text | Default - 'Try Again' |
| Microphone Error | Text displayed if recording fails. | Text | Default - 'Try Again' |

After the core properties have been set click on **New Audio **for each recording you want the learner to make.

==== Audio Core Properties ====

^ Property ^ Description ^ Type ^ Additional information ^
| Title | Text that appears at the top of the nested page, next to the clip number | Text |   |
| Text | Content displayed in the nested page.  You can add text, audio, video and images here. | Text+ (Toolbar) | This is where you would probably set the task and give instructions for the recording. |
| Recordings required | You can require learners to make more than 1 recording per nested page. | Number  picker | Default - '1'.   If you require learners to make multiple recordings on this page, you have options for the way you organise them, depending on the task; one recording per nested page, or several recordings on one nested page.  |
| Request Audio Name | If you leave this box __unticked__,  the learner is not prompted to give their recording a file name. | Tick box | It may be worth unticking this box if you don't think the learner needs to download and save their own recordings for future reference. |
| Feedback | This is the feedback displayed when the learner has saved all the recordings required on this __nested__ page. | Text+ (Toolbar) | Note that  |


==== Audio: Optional Properties ====

=== Page-specific ===

^ Property ^ Description ^ Type ^ Additional information ^
| Audio Example: File | Add the audio example file here | Link to Media Browser |   |
| Audio Example:  Show Example | {**Initially**/After Feedback} | Drop-down | If you want to model pronunciation for learners to imitate it makes sense to choose **Initially** (even if you would prefer learners to try out their pronunciation before listening to the model), because this empowers the learner. They don't have to listen to the model even if it is available.  |

{{tag>pagetype interactivity}}