YouTube

Ролик ставится на сайт айфреймом с адреса вида youtube.com/embed/ID. Поведение плеера задаётся параметрами адреса, и их два десятка: autoplay, start и end в секундах, loop в паре с playlist, controls для скрытия панели, fs для запрета полноэкранного режима, disablekb для отключения горячих клавиш, cc_lang_pref и cc_load_policy для субтитров, hl для языка интерфейса, color для цвета полосы прокрутки, playsinline для проигрывания без разворота на iPhone. Документация оговаривает минимальный размер окна: от 200×200 пикселей, с панелью управления — от 480×270.

Ниже плеер живьём. До клика на странице лежит только обложка: сам плеер тянет мегабайты скриптов ещё до того, как зритель нажал play, и десяток таких превращает страницу в кирпич. Мы у себя показываем картинку, а айфрейм подставляем по нажатию — тем же приёмом, что и в статьях блога.

С параметром enablejsapi=1 и подключённым iframe_api плеер управляется со своей страницы: playVideo(), pauseVideo(), seekTo(), громкость, скорость, getCurrentTime(), getDuration() и getPlayerState(). Состояний шесть: −1 — не начато, 0 — закончилось, 1 — играет, 2 — пауза, 3 — буферизация, 5 — ролик подготовлен. События: onReady, onStateChange, onPlaybackQualityChange, onPlaybackRateChange, onError и onApiChange.

Одну оговорку из документации стоит держать в голове: просмотр засчитывается в официальную статистику ролика только тогда, когда воспроизведение запустил сам зритель кнопкой в плеере. Запуск через playVideo() из кода в счётчик не попадёт — автозапуски и «продолжить с того места» красивых цифр на канале не сделают.

Короткий ролик живёт по адресу вида youtube.com/shorts/ID, но встраивается тем же кодом, что и обычное видео — youtube.com/embed/ID. Плеер сам разворачивается вертикально, от сайта нужен только контейнер с соотношением 9:16. В привычной рамке шестнадцать к девяти шортс встанет с чёрными полями по бокам и будет выглядеть ошибкой вёрстки.

Длина шортса — до трёх минут, название — до ста символов. Загрузить вертикальный ролик можно с компьютера, а снять — прямо в мобильном приложении.

Важное для тех, кто сравнивает цифры: с 31 марта 2025 года просмотры Shorts считаются иначе. Учитываются и первые, и повторные запуски без требований к минимальному времени просмотра, а в аналитике на месте просмотров появился отдельный показатель «Заинтересованные просмотры». От него же зависят и доля дохода от рекламы, и требования Партнёрской программы. Сравнивать просмотры шортса и обычного ролика в лоб после этой правки стало бессмысленно.

Ниже четыре ролика с официального канала YouTube — четыре типовых приёма. Ролики подгружаются по клику, до этого на странице лежат только обложки.