Playing back audio

In this section, we'll show how you can embed an audio player into the interface, and how you can make sure that a Toloker listened to your file.

Add an audio player to the interface

To insert an audio file into the task interface, add the view.audio component to the template. In the url property, specify a direct link to the file (we recommend that you use the MP3 format):

{
  "type": "view.audio",
  "url": "https://example.com/audio.mp3"
}
Copy text

If you pass a link to an audio file in the input data, use the data.input component in the url property.

To loop audio playback automatically, put true in the loop property.

Make sure that the Toloker listened to the audio

{
  "type": "view.audio",
  "url": "https://example.com/audio.mp3",
  "validation": {
    "type": "condition.played"
  }
}
Copy text

Record audio

To allow Tolokers to upload their audio files, use the field.audio component.

On the website, field.audio allows Tolokers to upload audio files, and in the app, it opens the sound recorder.

{
  "type": "field.audio",
  "data": {
    "type": "data.output",
    "path": "path",
  }
}
Copy text

Create a task to transcribe audio

To create a template for audio transcription tasks, we used the following components:

• condition.played: To make sure that a Toloker listened to the audio.
• condition.required: To make sure that a Toloker entered text into the multiline field (field.textarea).
• plugin.toloka: To customize the task layout.

Last updated: August 2, 2023