MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

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 и может быть изменено.

События

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

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

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

Большинство базового контента воспроизоведения может быть доступно при помощи аттрибута 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>

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

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

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

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
 Обновлялась последний раз: pavel9609,