BZ3
YA-VID
A BZ3 SYSTEM
Создать плеер

Потоковое видео с Яндекс.Диска

Для разработчиков и владельцев сайтов: как YA-VID готовит потоковое воспроизведение публичной ссылки и почему direct origin важнее постоянного proxy.

Direct origin

Основная архитектура — отдать браузеру прямой поток Яндекс.Диска, если он доступен, а не тащить весь медиатрафик через сервер YA-VID.

Playback cache

Повторные запросы к уже обработанной ссылке могут стартовать быстрее за счёт сохранённых playback-метаданных.

Smart fallback

Если direct-ссылка устарела, плеер запрашивает refresh. Proxy остаётся аварийным режимом, а не нормой.

Технический сценарий запуска потока

Resolve

API получает публичную ссылку и пытается определить воспроизводимый HLS/file источник.

Cache hit

Если источник уже найден ранее, сервис отдаёт его быстро и не заставляет пользователя ждать полный resolve заново.

Player fallback

Единый JS-плеер пробует origin direct, затем refresh, затем proxy fallback при ошибке.

Архитектурные решения

ЗадачаКак решает YA-VID
Не делать proxy основнымЭто снижает нагрузку на сервер и уменьшает задержку между пользователем и источником.
Не дублировать player logicvideo.php, embed.php и d.php должны опираться на единый модуль yandex-origin-player.js.
Не индексировать player URLСсылки вида /video.php?url=... функциональные, но не должны попадать в sitemap.
SEO-правило: демо потокового плеера на информационных страницах не должен автозагружать тяжёлый HLS до действия пользователя. Это защищает скорость, LCP и мобильный UX.

Частые вопросы по этой задаче

Поток всегда идёт через сервер YA-VID?
Нет. Базовая логика сервиса — предпочитать прямой Yandex-origin поток. Proxy используется только как аварийный fallback, если прямой путь не сработал.
Почему кеш playback важен для SEO и UX?
Кеш снижает время ожидания при повторной обработке той же публичной ссылки: пользователь быстрее видит плеер, а страница меньше нагружает сервер.
Можно ли использовать страницу как документацию для разработчика?
Да. Эта посадочная объясняет архитектуру потокового сценария и помогает понять, почему не стоит встраивать тяжёлый плеер автоматически на каждую SEO-страницу.