Audio

This article explains the features of the Audio block and how it can be used to collect audio recordings within your app.

Use Cases

1. Voice Feedback: Collect audio feedback from users in applications like surveys or customer service feedback.
2. Meeting Summaries: Capture brief audio summaries or action points from meetings or discussions, ensuring key information is recorded and accessible for later review.
3. Incident Reporting: Allow users to report incidents or issues by providing detailed voice descriptions.

Editing the Block

Click on the Audio block and start editing on the panel that appears on the right side.

Label

The label is the name of the block that the end user sees in the app.

Example: Voice Feedback, Record Response.

Description

The description is the additional information provided to the end user, displayed below the record button. You can also leave this blank if not necessary.

Example: Click to record your response. Recording will stop automatically once the limit is reached.

Max Length (in seconds)

This option sets the maximum duration for audio recordings. Users can select a time limit from 15 seconds to 300 seconds. Once the specified time limit is reached during recording, the block will automatically stop recording and upload the audio file.

Example: Set to 60 seconds if you want to allow a 1-minute recording.

Required

Enable this option if you want to make this field mandatory. When enabled, users must record an audio clip to complete the submission.

Advanced Options

Maximum Number of Files Allowed

Set the maximum number of audio files that a user can record and submit. The default limit is 10 files, but this can be adjusted based on the app’s requirements.

File Name Prefix

Define a prefix for the recorded audio file names for easy identification. You can also set the prefix dynamically using values submitted by users by pulling field variables. To do this, type @ followed by the field name to use its value as the prefix for each recording.

Example: Setting a prefix as “Interview_Response” will label each recording file with this prefix.

Display this field if

Use this option to show or hide the field under specific conditions. It accepts the standard Clappia formulae, similar to conditional sections or in the ‘Calculations & Logic’ block.

1. Type @ to get a list of all the fields you have added in the app and select the relevant field or type @ followed by the field name.

2. Use these field variables to write spreadsheet-like formulae for conditional display of the field in the app.

Retain value if hidden

This option appears once a condition is set in the Display this field if option. Enable this setting if you want the field's value to be retained even when the field is hidden. This is useful for preserving user input in cases where the field may temporarily disappear based on conditions.

Example: If the field is hidden based on user selection but you still need to keep the entered value for future reference or calculations, enable this option to ensure the data is retained.

Allow value to be changed after initial submission

This option is enabled by default. When active, end users can re-record audio after creating a submission. Disable this option if you want to prevent users from altering the recorded audio once it is submitted.

Block Width

Desktop View: Set the width of the PDF Viewer block in the desktop view. Options are 100%, 75%, 50%, or 25%.

Mobile View: Set the width of the PDF Viewer block in the mobile view. Options are 100% or 50%.

Using the Audio Block in App Home

In the app's live version, users can record audio by clicking the record button within the Audio block. In the mobile app, users can still record, upload and submit audio files in offline mode. Once the internet connection is back, the submission will be automatically synced in the background.

Note that users cannot upload audio files directly in this block; they can only record. If they need to upload existing audio files, they should use the Camera, Images & Files block.

Once recording begins, if users exceed the set time limit, the app will automatically stop and save the recording once the maximum configured duration is reached and the audio will be uploaded immediately.

Managing Audio Files in the Submissions Tab

Users with appropriate permissions (such as app admins or users with edit access) can manage audio files for already submitted entries through the Submissions tab.

To modify an audio entry, go to the Submissions tab, locate the specific submission, and click on it. A right panel will appear where the audio files associated with the submission can be managed.

1. Adding Additional Audio Files: If the Audio block has been configured to allow multiple files (using the Maximum number of files allowed setting), users can add more audio recordings to the submission. Simply use the recording button in the right panel to record and save additional audio files as needed.

2. Deleting Audio Files: In the right panel, users can delete any existing audio file by clicking on the delete icon next to the recording.