Субтитры в встраиваемых видео YouTube

Ноутбук с открытым YouTube на экране, воспроизводится видео

Коротко о разнице: закрытые субтитры и субтитры

Закрытые субтитры (closed captions, CC) показывают не только речь, но и звуковые эффекты, идентификацию говорящих и другие аудио-индикаторы. Это важно для людей с нарушениями слуха.
Субтитры обычно передают только произнесённый текст и используются для понимания речи на иностранном языке.

Пояснение: автоматические субтитры генерируются системой распознавания речи YouTube, поэтому качество зависит от чёткости речи, акцента и шума в фоне. Ручная разметка автора остаётся наиболее точной.

Важно: параметры URL влияют только на встраиваемые (embedded) плееры. На странице YouTube поведение субтитров контролируется интерфейсом плеера и пользовательскими настройками.

Как включить субтитры в встраиваемом iframe (быстрый пример)

Чтобы принудительно включать субтитры при встраивании, добавьте в src iframe параметр cc_load_policy=1. Пример минимального кода:

Если нужно указать язык субтитров (ISO 639-1, двухбуквенный код), добавьте cc_lang_pref перед cc_load_policy. Пример для французского:

Оба варианта работают для встраиваемого плеера. Но помните: если в видео нет субтитров (ни ручных, ни автоматически сгенерированных), принудительная подгрузка не создаст текст на пустом месте.

Как формируются субтитры и почему они иногда отсутствуют

Автор может загрузить файлы субтитров (SRT, VTT) через YouTube Studio. Это самый надёжный вариант.
YouTube может автоматически сгенерировать субтитры с помощью распознавания речи — зависят от качества аудио и языка.
Встроенные субтитры отключены в iframe по умолчанию, поэтому нужно явно включать их через параметры или API.
Некоторые видео запрещают встраивание вовсе — тогда iframe не будет работать, и параметры бессильны.

Альтернативные подходы

Ручная загрузка субтитров через YouTube Studio
- Автор: загрузите SRT/VTT в раздел «Субтитры» в YouTube Studio. Это даёт точность и контроль синхронизации.
YouTube IFrame API — управление субтитрами из кода
- Можно программно выставлять трек субтитров и включать их. Пример использования API приведён ниже.
Сторонние сервисы и плагины
- Сервисы транскрибации (автоматические и платные корректировки) и плагины для CMS могут облегчить создание качественных субтитров.
Локальные субтитры для собственных видео
- Если вы хостите видеоплеер самостоятельно (HTML5

Пример: управление субтитрами через YouTube IFrame API

Ниже — упрощённый пример включения субтитров и выбора языка через официальную IFrame API. Этот код требует загрузки API и создания объекта player.

// загрузите IFrame API скрипт и создайте player
var player;
function onYouTubeIframeAPIReady() {
  player = new YT.Player('player', {
    height: '360',
    width: '640',
    videoId: 'rB9ql0L0cUQ',
    events: {
      'onReady': onPlayerReady
    }
  });
}

function onPlayerReady(event) {
  // включить субтитры и выбрать язык 'en'
  try {
    player.setOption('captions', 'track', { 'languageCode': 'en' });
  } catch (e) {
    console.warn('Не удалось установить опцию субтитров через API', e);
  }
}

Примечание: вызов setOption может не сработать, если плеер ещё не инициализирован или если у видео нет доступных дорожек субтитров. Всегда проверяйте ошибки в консоли и тестируйте в целевых браузерах.

Панель управления YouTube с настройками субтитров и закрытых подписей

Как делиться ссылками на встраиваемые видео с включёнными субтитрами

При прямом шаринге HTML-ссылки для встраивания можно добавить параметры, как в примерах выше. Пример простаивания ссылки:

https://www.youtube.com/embed/rB9ql0L0cUQ?cc_load_policy=1&cc_lang_pref=en

Учтите:

Параметры встраиваемого URL действуют только в iframe. На странице YouTube эти параметры исчезают после перехода по кнопке «Watch on YouTube».
Параметры, такие как start=15, persistируют при переходе на YouTube и зададут время старта на платформе.

https://www.youtube.com/embed/rB9ql0L0cUQ?rel=0&start=15

Когда принудительное включение субтитров не сработает (сценарии)

У видео нет ни автоматических, ни загруженных субтитров.
Владелец видео отключил автоматическую генерацию субтитров и не загрузил ручные файлы.
Встраивание видео блокируется политикой владельца или настройками приватности.
Браузер или расширение блокируют запросы к YouTube или мешают загрузке скриптов.

Чеклист перед публикацией страницы с встраиваемым видео и субтитрами

Вставлен параметр cc_load_policy=1 в src iframe.
Указан cc_lang_pref=xx, если нужен конкретный язык.
Видеo действительно содержит субтитры (проверьте на YouTube: есть ли CC/англ/other).
Проверили работу в нескольких браузерах и на мобильных устройствах.
Если нужны точные тексты — загрузили VTT/SRT в YouTube Studio.
Обновили политику конфиденциальности сайта, если используете сторонние субтитры/сервисы.

Критерии приёмки

Субтитры включаются автоматически при загрузке страницы в iframe для целевых браузеров.
Указанный язык субтитров совпадает с отображаемым (если доступен).
При переходе на страницу YouTube видео начинает воспроизведение с заданного времени, если указан start.
Нет визуальных конфликтов с адаптивной вёрсткой страницы.

Тестовые кейсы

Встраиваем видео с ручными субтитрами, добавляем ?cc_load_policy=1 — субтитры отображаются.
Встраиваем видео без субтитров, добавляем ?cc_load_policy=1 — субтитров нет, поведение корректно (не падает ошибка).
Указываем cc_lang_pref=cс и cc_load_policy=1, где язык недоступен — плеер использует доступную дорожку или не показывает субтитры.
Используем API setOption для выбора трека — проверяем консоль на ошибки.

Безопасность и конфиденциальность

При использовании сторонних транскрибационных сервисов проверьте условия обработки персональных данных.
Встраивая видео с параметрами, вы по-прежнему загружаете ресурсы с домена youtube.com — учтите это в политике cookie на сайте.

Часто задаваемые вопросы

Как понять, есть ли у видео субтитры?

Откройте видео на YouTube, нажмите кнопку субтитров (CC) — система покажет доступные треки или сообщение об их отсутствии.

Можно ли включить автоматические субтитры, если автор их отключил?

Нет — если автор и платформа не предоставляют дорожки, принудительных автоматических субтитров через параметры URL не появится.

Работает ли cc_load_policy=1 для мобильных браузеров?

Да, но поведение может отличаться в зависимости от мобильного браузера и версий OS; тестируйте на целевых устройствах.

Быстрая памятка (cheat sheet)

Синтаксис в iframe: ?cc_lang_pref=xx&cc_load_policy=1
IFrame API: player.setOption(‘captions’, ‘track’, { ‘languageCode’: ‘en’ })
Если субтитров нет — загрузите VTT/SRT в YouTube Studio.

Короткое резюме

Добавлять субтитры в встраиваемые видео YouTube просто: используйте cc_load_policy=1 и опционально cc_lang_pref. Для точности лучше загрузить субтитры вручную через YouTube Studio или управлять дорожками через IFrame API. Всегда тестируйте и учитывайте ограничения авторских настроек и политик встраивания.

Социальный предпросмотр

OG Title: Субтитры в встраиваемых видео YouTube OG Description: Как принудительно включить субтитры в iframe, управление языком и альтернативные способы.