HTML <audio> элемент используется для встраивания аудиоконтента в документы. Он может содержать один или несколько аудио-источников, представленных при помощи аттрибута src или при помощи <source> элемента; браузер будет выбирать наиболее подходящий источник.

Категории контента Потоковый контент, фразообразующий контент, встроенный контент. Если имеются controls аттрибут: интерактивный контент и явный контент.
Допустимый контент Если элемент имеет src аттрибут: 0 или больше <track> элементов, за которым следует прозрачный контент, который не содержит медиаэлементов, то есть нет <audio> или <video>
Иначе: 0 или больше <source> элементов, следующих за 0 или больше <track> элементами, следующий за прозрачным контентом, который не содержит медиаэлементов
Упущение тега None, both the starting and ending tag are mandatory.
Допустимые родители Любой элемент, который принимает встроенный контент.
Допустимые ARIA роли application
DOM интерфейс HTMLAudioElement

Атрибуты

Для данного элемента доступны глобальные атрибуты.

autoplay
Логический атрибут; если он определён (даже если значение равно "false"), аудио начнёт автоматически воспроизводиться сразу же, как это будет возможно, без ожидания скачивания всего аудиофайла.
autobuffer Вышла из употребления с версии Gecko 2.0
Логический атрибут; если определён, аудио автоматически будет скачиваться, даже если не установлен autoplay. Это будет продолжаться, пока медиа-кэш не станет полным, или весь аудио-файл не будет скачан, что наступит раньше. Это должно быть использовано только тогда, когда ожидается, что пользователь выберет для воспроизведения аудио; например, если пользователь переходит на страницу, используя ссылку "Проиграй это аудио". Этот атрибут был удалён в Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1) в пользу атрибута preload .
buffered
Атрибут, который вы можете прочитать, чтобы определить, какие временные диапазоны средств медиа будут буферизованы. Этот атрибут содержит TimeRanges объект.
controls
Если этот атрибут присутствует, браузер предложит элементы управления, чтобы позволить пользователю контролировать воспроизведение звука, в том числе громкость, поиск, и паузы / возобновления воспроизведения.
loop
Логический атрибут; если он указан, запись зациклится.
mozCurrentSampleOffset
Частота, заданная в качестве количества образцов с начала звукового потока, в аудио, которое сейчас проигрывается
muted
Логический атрибут, который указывает, будет ли изначально заглушено воспроизведение. По умолчанию false.
played
 TimeRanges объект, указывая все диапазоны звука, которые играли.
preload
Этот перечисляемый атрибут предназначен для предоставления подсказки браузеру о том, что автор считает лучшим для сайта. Тег может иметь следующие значения
  • none: указывает, что аудио не должно предварительно загружаться
  • metadata:  указывает, что метаданные (e.g. length) забираются;
  • auto: указывает на то, что весь звуковой файл может быть загружен, даже если пользователь не будет использовать его;
  • the empty string: синоним значения auto

Если он не указан, это будет определенное браузером значение. Спецификация советует использование атрибута metadata.

Заметки по использованию:
  • Атрибут autoplay имеет приоритет над preload. Если autoplay указан, браузер, очевидно, должен был бы начать загрузку для воспроизведения.
  • Браузер не принуждается спецификацией следовать значению этого атрибута; это просто подсказка
src
URL встриваемого аудио. это субъект HTTP access controls. Не является обязательным; вы можете вместо этого использовать <source>  элемент внутри аудиоблока для определения аудио, которое вы хотите встроить.
volume
Громкость воспроизведения, в диапазоне от  0.0 (самая тихая) до 1.0 (самая громкая).

Коррекции времени задаются в виде значений с плавающей точкой с указанием количества секунд для частоты.

Примечание: Определение коррекции времени до сих пор не завершено в спецификации HTML5 и может быть изменено.

События

Этот элемент может запустить различные события.

Заметки по использованию

Запасной контент для браузеров, не поддерживающих элемент <audio> может быть добавлен также, внутри открытия и закрытия <audio> </audio> тега.

Большинство базового контента воспроизоведения может быть доступно при помощи аттрибута control; для более продвинутого использования, аудио воспроизведение и его контроль может быть создано при помощи манипуляций с HTML Media API, and more specifically the features defined in the HTMLAudioElement interface.

ВЫ также можете использовать Web Audio API для прямого генерирования и манипулирования аудиопотка. Смотри Web Audio API для подробностей.

Примеры

Базовое использование

<!-- Simple audio playback -->
<audio
  src="http://developer.mozilla.org/@api/deki/files/2926/=AudioTest_(1).ogg"
  autoplay>
  Ваш браузер не поддерживает <code>audio</code> элемент. 
</audio>

<!-- Audio playback with captions -->
<audio src="foo.ogg">
  <track kind="captions" src="foo.en.vtt" srclang="en" label="English">
  <track kind="captions" src="foo.sv.vtt" srclang="sv" label="Svenska">
</audio> 

Аудио элемент с элементом источника

<audio controls="controls">
  Ваш браузер не поддерживает <code>audio</code> элемент.
  <source src="foo.wav" type="audio/wav">
</audio>

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

Спецификация Статус Комментарий
HTML Living Standard
Определение '<audio>' в этой спецификации.
Живой стандарт  
HTML5
Определение '<audio>' в этой спецификации.
Рекомендация  

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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка 3.0 (Да) 3.5 (1.9.1) [1] 9.0 10.5 3.1
autoplay аттрибут 3.0 (Да) 3.5 (1.9.1) 9.0 10.5 3.1
buffered аттрибут ? (Да) 4.0 (2.0) ? ? ?
controls аттрибут 3.0 (Да) 3.5 (1.9.1) 9.0 10.5 3.1
loop аттрибут 3.0 (Да) 11.0 (11.0) 9.0 10.5 3.1
muted аттрибут ? (Да) 11.0 (11.0) ? ? ?
played property ? (Да) 15.0 (15.0) ? ? ?
preload аттрибут 3.0 (Да) 4.0 (2.0) 9.0 (Да) [2] 3.1
src аттрибут 3.0 (Да) 3.5 (1.9.1) 9.0 10.5 3.1
volume аттрибут   (Да)        
Feature Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка ? (Да) 1.0 (1.0) [1] ? ? ?
autoplay аттрибут ? (Да) 1.0 (1.0) ? ? ?
buffered аттрибут ? (Да) 4.0 (2.0) ? ? ?
controls аттрибут ? (Да) 1.0 (1.0) ? ? ?
loop аттрибут ? (Да) 11.0 (11.0) ? ? ?
muted аттрибут ? (Да) 11.0 (11.0) ? ? ?
played property ? (Да) 15.0 (15.0) ? ? ?
preload аттрибут ? (Да) 4.0 (2.0) ? ? ?
src аттрибут ? (Да) 1.0 (1.0) ? ? ?
volume аттрибут   (Да)        

[1] For Gecko to play audio, the server must serve the file using the correct MIME type.

[2] Supported under the older name autobuffer

Смотрите также

Метки документа и участники

Внесли вклад в эту страницу: pavel9609, torbasow, Neiromaster
Обновлялась последний раз: pavel9609,