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

Импорт аудио и история операций

Это руководство пользователя: как загружать аудио и плейлисты в библиотеку, следить за импортом и разбираться со статусами.

Что умеет импорт

  • По ссылке — вставьте ссылку на аудиофайл, видео (YouTube) или другой медиа — файл скачается, и вы сможете его отредактировать перед добавлением.
  • Плейлист — по ссылке на YouTube-плейлист: приложение определит его, создаст группировку и загрузит все выпуски в очередь.

Импорт по ссылке

  1. Откройте Источники и нажмите «Импорт по URL».
  2. Вставьте ссылку и нажмите «Импортировать».
  3. Дождитесь загрузки — откроется шаг редактирования: обложка, название, авторы, теги, группировка.
  4. Нажмите «Добавить запись» — запись появится в библиотеке.

Импорт плейлиста

  1. Вставьте ссылку на плейлист (например, YouTube) и нажмите «Импортировать».
  2. Приложение покажет «Обнаружен плейлист: Название (N выпусков)».
  3. Выберите:
    • «Загрузить все» — все выпуски будут скачаны в очередь;
    • «Только первый» — скачается только первый выпуск.
  4. Группировка создастся автоматически; каждый выпуск станет отдельной записью.

Статусы операций

Каждый импорт отражается в Истории со своим статусом:

  • В процессеВ процессе — идёт скачивание или конвертация (полоска прогресса растёт).
  • ГотовоГотово — все элементы загружены.
  • ЧастичноЧастично — плейлист загрузился не полностью: часть выпусков была пропущена из-за ошибок. Подробности — в логе.
  • ОшибкаОшибка — операция не удалась (например, ссылка недоступна). Причина — в логе.
  • ОтмененоОтменено — вы остановили операцию вручную.

Как следить за импортом

  • Откройте Историю: операции обновляются в реальном времени — статус, процент и сообщение меняются без перезагрузки страницы.
  • У активной операции вместо значка — лоадер, а под названием — полоска прогресса.
  • Фильтры сверху помогают найти нужное: Все / В работе / Завершено / Ошибки / Отменено.

Подробности (лог)

У операций импорта есть кнопка «Подробнее» — она раскрывает журнал шагов:

  • получение списка плейлиста;
  • скачивание каждого файла (в процентах);
  • конвертация в MP3;
  • загрузка в хранилище и создание записи;
  • ошибки — с кратким объяснением.

Над логом — подсказка о текущем статусе операции.

Отмена и продолжение

  • Отменить — у операции в процессе в меню есть пункт «Отменить»: скачивание остановится, частичные файлы удалятся.
  • Продолжить — если импорт завершился с ошибкой или был отменён, но файл уже скачан — можно продолжить редактирование; иначе — повторить загрузку.

Что делать при ошибках

СитуацияЧто делать
Ошибка «Файл недоступен по ссылке»Проверьте ссылку — файл мог быть удалён или закрыт
Ошибка «Не удалось подключиться к источнику»Проверьте доступ в интернет и ссылку
Ошибка «YouTube временно ограничил» (429)Подождите немного и повторите — сервис временно ограничивает частые запросы
Частично «Загружено не всё»Часть выпусков не загрузилась — откройте «Подробнее», там причины по каждому
Ошибка «Файл не найден после загрузки»Повторите попытку позже

Очистка истории

Кнопка «Очистить» в Истории удаляет все операции и уведомления об изменениях. Записи в библиотеке при этом не удаляются.


Если что-то пошло не так — откройте «Подробнее» у операции: там будет конкретное объяснение.