Документация Толоки

Воспроизвести аудио

Обратите внимание

Документация на русском языке может быть устаревшей. Самые последние изменения доступны в документации на английском языке.

В этом разделе мы покажем, как добавить аудиоплеер в интерфейс и как убедиться, что исполнитель этот файл прослушал.

Примечание

Вы можете добавлять медиафайлы (аудио, видео, картинки) со своего сервера, Яндекс Диска или из облачных хранилищ, таких как Yandex Cloud, Google Cloud, Amazon AWS и т.п.

Добавить аудиоплеер в интерфейс

Чтобы вставить звуковой файл в интерфейс задания, добавьте в шаблон компонент view.audio. В свойстве url укажите прямую ссылку на файл (рекомендуем использовать формат MP3):

{
  "type": "view.audio",
  "url": "http://example.com/audio.mp3"
}

Если ссылка на аудиофайл передается во входных данных, в свойстве url используйте компонент data.input.

Чтобы аудио автоматически воспроизводилось повторно, в свойстве loop укажите true.

Убедиться, что исполнитель прослушал аудио

Чтобы убедиться, что исполнитель запустил аудио и хотя бы начал его прослушивание, в свойстве validation используйте компонент condition.played.

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

Чтобы убедиться, что исполнитель завершил прослушивание аудио, в свойстве validation используйте компонент condition.played-fully.

{
  "type": "view.audio",
  "url": "http://example.com/audio.mp3",
  "validation": {
    "type": "condition.played-fully"
  }
}

Записать аудио

Чтобы дать возможность исполнителю загружать свои аудиофайлы, используйте компонент field.audio.

Если исполнитель выполняет задание на сайте, то field.audio позволит загрузить файл, а если в приложении — откроет режим записи звука.

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

Создать задание, в котором нужно превратить аудио в текст

Чтобы создать шаблон для задания по транскрибации аудио, мы использовали следующие компоненты:

  • condition.played — чтобы убедиться, что исполнитель прослушал аудио;
  • condition.required — чтобы убедиться, что исполнитель ввел текст в многострочное поле (field.textarea);
  • plugin.toloka — чтобы настроить внешний вид задания.