Пропустить навигацию

Решение проблем

Обновлено: 28.12.2025
Начните с раздела «Диагностика и поддержка» — там собраны все инструменты для решения проблем и обращения в поддержку.

Если у вас возникла проблема с плеером, сначала проверьте этот раздел. Здесь собраны типичные ситуации и способы их решения.

Кому подходит эта статья

  • Разработчикам — нужно решить проблемы с встраиванием плеера
  • Владельцам контента — требуется диагностировать проблемы с воспроизведением видео
  • Администраторам платформ — нужно помочь пользователям решить проблемы с плеером
Если проблема не решена после проверки этого раздела, обратитесь в поддержку. Подробную информацию о том, что собрать и как обратиться, смотрите в разделе «Диагностика и поддержка».

Проблемы с загрузкой и отображением

Плеер не отображается

Симптомы: На месте плеера пустое место, белый экран или ошибка загрузки.

Возможные причины и решения:

  1. Неправильный код встраивания

    • Используйте оригинальный код из панели управления Kinescope
    • Проверьте, что код скопирован полностью, включая все атрибуты
    • Убедитесь, что атрибут allow присутствует в коде iframe

  2. Блокировка iframe

    • Проверьте, что на сайте нет блокировщиков рекламы, которые могут блокировать iframe
    • Убедитесь, что домен не заблокирован в настройках безопасности браузера
    • Проверьте Content Security Policy (CSP) вашего сайта

  3. Ошибки JavaScript

    • Откройте консоль браузера (F12) и проверьте наличие ошибок
    • Убедитесь, что на странице нет конфликтующих скриптов

Видео не загружается или зависает

Симптомы: Плеер загружается, но видео не начинает воспроизведение, или воспроизведение прерывается.

Возможные причины и решения:

  1. Настройки конфиденциальности

    • Проверьте, что видео доступно для встраивания в настройках конфиденциальности
    • Убедитесь, что домен вашего сайта добавлен в список разрешённых доменов
    • Для видео с DRM убедитесь, что сайт использует HTTPS

  2. Статус обработки видео

    • Проверьте статус видео в каталоге — оно должно быть полностью обработано
    • Дождитесь завершения обработки перед встраиванием

  3. Проблемы с сетью

    • Проверьте скорость интернета с помощью теста скорости
    • Закройте в браузере все вкладки, кроме плеера, и перезагрузите страницу
    • Проверьте консоль браузера на наличие сетевых ошибок

  4. Проблемы с браузером

    • Попробуйте открыть видео в другом браузере
    • Очистите кеш браузера и перезагрузите страницу
    • Отключите расширения браузера, которые могут влиять на воспроизведение

Проблемы с параметрами и настройками

Параметры seek и duration не работают

Симптомы: Параметры указаны в URL, но видео воспроизводится с начала или полностью.

Решения:

  • Проверьте защиту DRM: Параметры seek и duration не работают с видео, защищёнными DRM-шифрованием. Используйте незащищённые видео или воспроизводите полное видео
  • Проверьте формат URL: Убедитесь, что параметры правильно переданы в URL (формат: ?seek=60&duration=30)
  • Для iframe: Параметры должны быть в URL атрибута src, например:
    <iframe src="https://kinescope.io/embed/123456789?seek=60&duration=30"
        allow="autoplay; fullscreen; picture-in-picture; encrypted-media;"
        frameborder="0"
        allowfullscreen></iframe>

Параметр player_id не применяется

Симптомы: Указан player_id, но шаблон плеера не меняется.

Решения:

  • Тип ссылки: Параметр player_id работает только со ссылками на видео (не с iframe). Убедитесь, что используете ссылку вида https://kinescope.io/[ID_ВИДЕО]?player_id=[ID_ПЛЕЕРА]
  • Формат ID: Проверьте правильность ID шаблона (формат UUID, например: 1213d24d-4624-4764-bf40-0baaf743377d)
  • Доступность шаблона: Убедитесь, что шаблон существует и доступен в вашей рабочей зоне
  • Для iframe: Используйте настройку шаблона в коде вставки или через IFrame API

Проблемы с отображением

Плеер отображается с неправильными размерами

Симптомы: Плеер слишком большой или маленький, не адаптируется под размер экрана, обрезается.

Решения:

Для адаптивного кода:

  • Проверьте CSS стили контейнера div — должны быть указаны position: relative, padding-top (для соотношения сторон) и width: 100%
  • Проверьте CSS стили самого iframe — должны быть position: absolute, width: 100%, height: 100%, top: 0, left: 0
  • Убедитесь, что контейнер имеет достаточную ширину для отображения плеера

Для фиксированного кода:

  • Убедитесь, что указаны корректные значения width и height в пикселях
  • Проверьте, что соотношение сторон соответствует видео (обычно 16:9)

Общие рекомендации:

  • Проверьте, что на странице нет конфликтующих CSS стилей, которые могут переопределять размеры
  • Используйте инструменты разработчика браузера для проверки применённых стилей

Полноэкранный режим не работает

Симптомы: Кнопка полноэкранного режима не работает или отсутствует, переход в полноэкранный режим не происходит.

Решения:

  • Атрибут allowfullscreen: Убедитесь, что атрибут allowfullscreen присутствует в коде iframe
  • Атрибут allow: Проверьте, что атрибут allow содержит fullscreen, например:
    allow="autoplay; fullscreen; picture-in-picture; encrypted-media;"
  • iOS устройства: На iOS устройствах может потребоваться дополнительная настройка. См. псевдо-полноэкранный режим для iOS
  • Браузерные ограничения: Некоторые браузеры могут блокировать полноэкранный режим для iframe из соображений безопасности

Проблемы с DRM (Widevine)

Видео с DRM не воспроизводится на Android в режиме инкогнито

Симптомы: Видео с DRM-защитой не воспроизводится в режиме инкогнито на Android устройствах.

Причина: По информации от Google, с версии Chrome 62 поддержка Widevine отключена в режиме инкогнито на Android. Это сделано для того, чтобы пользователи не теряли платные лицензии при закрытии вкладок в режиме инкогнито.

Решение: Используйте обычный режим браузера (не инкогнито) для просмотра видео с DRM.

Подробнее: Media updates in Chrome 62.

Возможна запись экрана при включённом DRM

Симптомы: Даже при включённом DRM возможно записать видео с экрана.

Причина: Известны случаи, когда запись экрана возможна даже при включённом DRM из-за особенностей CSS стилей страницы.

Решения:

  • Скругления углов: Если один из родительских элементов имеет скругления (border-radius), укажите CSS-стили: overflow: initial или overflow: visible
  • CSS фильтры: Избегайте использования backdrop-filter или filter на странице с DRM-видео
  • CSS свойства: Если iframe плеера или родительский элемент использует aspect-ratio или padding-top, рассмотрите альтернативные способы задания размеров

Подробнее: Chromium issue 362007492.

Не работает Widevine DRM в WebView на Android

Симптомы: Видео с DRM не воспроизводится в WebView на Android.

Решения:

  1. Проверка поддержки DRM:

    • Проверьте поддержку DRM через Shaka Player support page
    • Если результат null, то поддержки DRM нет в вашем WebView

  2. Настройка WebView:

    • Убедитесь, что в WebView включена поддержка защищённого контента
    • Проверьте настройки WebView для работы с медиа-контентом

  3. Дополнительные ресурсы:

Проблемы с API и автозапуском

Плеер не запускается при программном вызове play()

Симптомы: При вызове метода play() через вашу кнопку или программно плеер не запускается.

Причина: Это ограничения браузера. Браузер требует, чтобы пользователь нажал именно на плеер, а не на внешнюю кнопку. Это связано с политикой автозапуска браузеров.

Решения:

  • CSS решение: Установите CSS-стиль pointer-events: none для кнопки (или других элементов над плеером), чтобы нажатие проходило сквозь кнопку и попадало на плеер:
    .custom-play-button {
  pointer-events: none;
}
  • Альтернатива: Используйте нативную кнопку воспроизведения плеера вместо кастомной кнопки

Подробнее: Autoplay policy in Chrome.

Ошибка NotAllowedError при вызове методов API

Симптомы: При вызове методов API появляется ошибка “The request is not allowed by the user agent …” или “The request is not triggered by a user activation”.

Причина: Это связано с тем, что некоторые методы API браузера требуют действий пользователя (user activation) и могут запускаться только как прямой результат нажатия или прикосновения пользователя к элементу страницы.

Решения:

  • Вызов в обработчике события: Убедитесь, что методы API вызываются в ответ на прямое действие пользователя (клик, касание) в обработчике события
  • Не используйте таймеры: Не вызывайте методы API из setTimeout, setInterval или других асинхронных операций без предварительного действия пользователя
  • Проверка user activation: Используйте проверку user activation перед вызовом методов, если это возможно

Подробнее: User activation.

Проблемы с производительностью

Страница зависает при большом количестве плееров

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

Решения:

  1. Отложенная загрузка:

    • Используйте атрибут loading="lazy" для iframe, которые находятся вне видимой области:
      <iframe src="https://kinescope.io/embed/123456789"
        loading="lazy"
        allow="autoplay; fullscreen; picture-in-picture; encrypted-media;"
        frameborder="0"
        allowfullscreen></iframe>

  2. Отключение предзагрузки:

    • Отключите предзагрузку видео для плееров, которые не видны сразу, используя параметр preload=false:
      <iframe src="https://kinescope.io/embed/123456789?preload=false"
        allow="autoplay; fullscreen; picture-in-picture; encrypted-media;"
        frameborder="0"
        allowfullscreen></iframe>

  3. Автопауза:

    • Используйте автопаузу (параметр autopause=1), чтобы при воспроизведении одного плеера остальные ставились на паузу:
      <iframe src="https://kinescope.io/embed/123456789?autopause=1"
        allow="autoplay; fullscreen; picture-in-picture; encrypted-media;"
        frameborder="0"
        allowfullscreen></iframe>

  4. Дополнительные рекомендации:

    • Ограничьте количество одновременно загруженных плееров на странице
    • Используйте виртуализацию для больших списков видео
    • Рассмотрите возможность загрузки плееров по требованию (lazy loading)

Подробнее об оптимизации см. раздел «Оптимизация загрузки» в статье «Встраивание».

Типовые решения

Быстрая диагностика

Если проблема не очевидна, выполните следующие шаги по порядку:

  1. Проверьте консоль браузера (F12) на наличие ошибок
  2. Проверьте код встраивания — используйте оригинальный код из панели управления
  3. Проверьте настройки конфиденциальности — видео должно быть доступно для встраивания
  4. Проверьте статус видео — оно должно быть полностью обработано
  5. Попробуйте другой браузер — проблема может быть связана с конкретным браузером
  6. Очистите кеш браузера и перезагрузите страницу

Сбор информации для поддержки

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

Что дальше?

Если проблема не решена:

Связанные статьи