Почему видео не запускается автоматически — 3 причины, включая баг React с muted

Ты поставил на главную видео-фон. На ноутбуке в Chrome крутится. Открываешь на iPhone — стоит первый кадр, а посередине серый треугольник «play».
Самое обидное: в коде у тебя всё как в инструкции. autoPlay есть, muted есть. Но если сайт на React или Next.js, вполне может оказаться, что muted до браузера просто не доехал. Это старая особенность React, и о ней ниже.
Начнём с самой частой причины. Каждую разберём по схеме: причина → как проверить → как починить.
Причина 1. У видео есть звук (самая частая)
Браузеры не дают сайтам внезапно шуметь. Правило у всех похожее:
- видео без звука (
muted) может запускаться само всегда; - видео со звуком — только после того, как пользователь что-то нажал на странице.
Есть и подвох «у меня работает». Chrome запоминает сайты, где ты часто сам включаешь видео. Таким сайтам он разрешает автозапуск со звуком. Ты на своём сайте кликаешь по видео десятки раз — и Chrome тебе доверяет. А новый посетитель видит застывший кадр.
Как проверить. Открой консоль. В Chrome будет ошибка вида:
play() failed because the user didn't interact with the document first
Ещё надёжнее — открой сайт в окне инкогнито. Там у браузера нет истории доверия, как у твоих пользователей.
Как починить. Добавь muted. Если звук правда нужен — запускай без звука и покажи кнопку «Включить звук». Включение звука по нажатию разрешено всегда.
Причина 2. На iPhone нет playsinline
Safari на iPhone исторически показывает видео на весь экран. Это одна из тех мелочей, из-за которых сайт надо проверять именно на телефоне. Без специального атрибута он не станет проигрывать ролик прямо внутри страницы — а значит, и автозапуска не будет.
Как проверить. Посмотри на тег: есть ли там playsinline. В React атрибут пишется как playsInline, с большой I.
Как починить. Полный набор для фонового видео:
<video autoplay muted loop playsinline poster="/hero.jpg">
<source src="/hero.mp4" type="video/mp4" />
</video>
poster — картинка, которую видно, пока видео грузится или если оно так и не запустится. Не пропускай его.
Причина 3. React теряет атрибут muted
Вот та самая неочевидная. Ты пишешь в JSX muted, но React выставляет его как свойство элемента, а не как атрибут в HTML. Это известная история: issue про это открыто в репозитории React с 2017 года.
Пока всё рисуется в браузере, разницы почти нет. Но если страница рендерится на сервере, как в Next.js, в HTML прилетает тег без muted. Safari смотрит на этот HTML, видит «видео со звуком» и запрещает автозапуск. А React выключит звук позже, когда решение уже принято.
Как проверить. На странице в консоли выполни:
document.querySelector("video").outerHTML
Если в выводе нет слова muted, а в твоём JSX оно есть — это оно.
Как починить. Выстави muted руками через ref и запусти видео сам:
const ref = useRef(null)
useEffect(() => {
const video = ref.current
video.muted = true
video.play().catch(() => {})
}, [])
return <video ref={ref} autoPlay muted loop playsInline poster="/hero.jpg" src="/hero.mp4" />
play() возвращает промис. Если браузер всё же откажет, ошибка не повиснет в консоли красным, а пользователь увидит постер.
Бонус: иногда запретил сам пользователь
На iPhone в режиме энергосбережения Safari часто не запускает видео автоматически. В настройках сайтов в Safari и Chrome пользователь может выключить автовоспроизведение совсем. Тут ничего не сломано и починить нельзя. Поэтому у видео всегда должен быть постер, а смысл страницы не должен держаться на ролике.
Похожая логика, как и с картинками, которые не грузятся: всегда думай, что увидит человек, если медиа не появится.
Как попросить ИИ починить сразу
видео не запускается на айфонеФоновое видео на главной не запускается автоматически на iPhone в Safari, в Chrome на ноутбуке работает. Проект на Next.js. Проверь, что у тега video есть muted, playsInline, loop и poster. Учти, что React не выводит атрибут muted в серверный HTML: выставь video.muted = true через ref и вызови play() с catch. Если видео не запустилось, должен остаться виден постер.Почему у меня работает, а у пользователей нет?
Скорее всего, Chrome доверяет тебе как частому зрителю своего сайта. Проверяй автозапуск в окне инкогнито и на реальном телефоне — так ты увидишь сайт глазами нового посетителя.
Можно ли сделать автозапуск со звуком?
Только после действия пользователя. Например, видео стартует без звука, а по нажатию кнопки ты ставишь video.muted = false. Обойти это правило нельзя.
Не проще ли вставить GIF?
Нет. GIF весит в разы больше короткого MP4 и выглядит хуже. Беззвучное видео с muted и playsinline запускается так же надёжно, как GIF, но грузится быстрее.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





