HTMLMediaElement: свойство autoplay

Базовая линия Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Свойство HTMLMediaElement.autoplay отражает атрибут HTML autoplay, указывающий, должен ли воспроизведение автоматически начинаться, как только достаточно медиаданных будет доступно без прерывания.

Элемент медиа, исходный код которого — MediaStream, и чье свойство autoplay имеет значение true , начнет воспроизведение, когда станет активным (то есть, когда MediaStream.active станет true).

Примечание: Автоматическое воспроизведение аудио (или видео с аудиодорожкой) может быть неприятным для пользователей, поэтому его следует избегать, когда это возможно. Если вам необходимо использовать функциональность автовоспроизведения, вы должны сделать ее опциональной (требуя от пользователя явно включить ее). Однако автовоспроизведение может быть полезным при создании элементов медиа, исходный код которых будет установлен в более позднее время под управлением пользователя.

Для более подробного ознакомления с автовоспроизведением, блокировкой автовоспроизведения и реакцией на блокировку автовоспроизведения браузером пользователя, обратитесь к нашей статье Руководство по автовоспроизведению для API медиа и Web Audio.

Значение

Булево значение, которое равно true , если элемент медиа начнет воспроизведение, как только будет загружено достаточно контента, чтобы это сделать без прерываний.

Примечание: Некоторые браузеры позволяют пользователям переопределять autoplay , чтобы предотвратить воспроизведение прерывистого аудио или видео без разрешения или в фоновом режиме. Не полагайтесь на то, что autoplay фактически начнет воспроизведение, а вместо этого используйте событие play.

Примеры

<video id="video" controls>
  <source
    src="https://player.vimeo.com/external/250688977.sd.mp4?s=d14b1f1a971dde13c79d6e436b88a6a928dfe26b&profile_id=165" />
</video>

// Disable autoplay (recommended)
// false is the default value
document.querySelector("#video").autoplay = false;

Спецификации

Спецификация
HTML # dom-media-autoplay

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`autoplay`	3	12	3.5	≤12.1	3.1	18	4	≤12.1	3	1.0	≤37

См. также

HTMLMediaElement: Интерфейс, используемый для определения свойства HTMLMediaElement.autoplay
<audio>, <video>

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/autoplay