Найдите связь между конкретным состоявшимся запуском вебинара и уроком. Название встречи или общий ID повторяющейся серии могут указывать сразу на несколько занятий. Затем проверьте, получен ли готовый файл, создана ли запись материала в LMS и разрешена ли её выдача ученику. Эти этапы нельзя считать одним состоянием «вебинар завершён».

Повторяющаяся встреча содержит разные экземпляры

Zoom различает meeting ID и UUID конкретного экземпляра встречи. Для повторяющихся запусков создаются отдельные UUID; это описано в официальном руководстве API, проверенном 26 октября 2026 года. В интеграции сохраняйте аккаунт провайдера и идентификатор экземпляра, а не выбирайте урок по последнему совпавшему названию.

Условная связь материала:
provider_account -> разрешённый аккаунт видеосервиса
meeting_series -> общая встреча, если есть
meeting_instance -> конкретный состоявшийся запуск
lesson_id -> урок нужного потока
recording_file_id -> выбранный файл
state -> ожидается / готов / проверен / опубликован
material_version -> версия привязки

Сохраните запланированную связь ещё при создании занятия. После события от видеосервиса уточните её данными состоявшегося экземпляра. Если одно занятие перезапускали, возможны несколько частей записи; не перетирайте первую часть последней только потому, что оба события относятся к одному уроку.

Готовность записи проверяется отдельно от окончания эфира

НаблюдениеСледующая проверка
Встреча закончилась, файла нетОбработка записи у провайдера
Файл есть, урок пустСопоставление экземпляра и материала
Открылся прошлый вебинарИдентификатор запуска
Виден только звукВыбор файла и его типа
Куратор видит, ученик нетПрава выдачи и состояние материала

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

Не переносите служебную ссылку скачивания как постоянный публичный URL урока без проверки механизма доступа. Для скачивания может требоваться авторизация провайдера. В LMS нужна собственная разрешённая схема выдачи: управляемая ссылка либо принятая копия в хранилище. Токен скачивания не должен попадать в текст урока или открытый журнал.

Если копирование идёт в фоне, создавайте материал как ожидающий и публикуйте только после проверки готового артефакта. Ошибка загрузки или нулевой файл должны оставлять понятный отказ. При повторе события ищите уже созданный материал по устойчивому ключу, чтобы не добавлять одинаковое видео несколько раз.

Проверка воспроизводит два занятия одной серии

  1. Провести два разрешённых тестовых запуска повторяющейся встречи.
  2. Назначить им разные искусственные уроки.
  3. Сопоставить экземпляры, файлы и итоговые материалы.
  4. Повторить обработку одного события без создания дубля.
  5. Открыть каждый урок тестовым учеником и проверить нужную запись.

Смена урока вручную должна сохранять историю привязки. Иначе поздняя задача со старым назначением вернёт видео обратно. Зафиксируйте версию решения и правило для незавершённых задач; перемещение материала и повторное скачивание файла — разные действия.

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

Проверенные источники