CKTIS / HTML
element HTML: audio
Element audio osadza zasób dźwiękowy i udostępnia przeglądarce model wyboru źródła, buforowania, czasu oraz odtwarzania.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<audio controls preload="metadata" src="sound.wav"></audio>audio może wskazać jeden src albo zawierać kolejne source; opcjonalny type, jeśli jest podany, pomaga pominąć nieobsługiwane formaty. Tekst potomny jest awaryjny tylko dla przeglądarek bez obsługi elementu, nie stanowi transkrypcji ani alternatywy dostępności w przeglądarkach obsługujących audio.
controls udostępnia natywne sterowanie, preload jest tylko wskazówką, a autoplay może zostać zablokowane; muted i loop zmieniają początkowe wyciszenie oraz powtarzanie.
play() zwraca Promise, który może zostać odrzucony przez politykę lub błąd zasobu; pause() zatrzymuje odtwarzanie, a currentTime służy do przewijania, gdy media są gotowe.
Przykład czeka na loadedmetadata osadzonego pliku WAV i odczytuje duration, paused oraz rozwiązany currentSrc bez uruchamiania dźwięku.
Przykłady
<!doctype html>
<meta charset="utf-8">
<audio id="clip" controls preload="metadata" src="data:audio/wav;base64,UklGRiwAAABXQVZFZm10IBAAAAABAAEAQB8AAEAfAAABAAgAZGF0YQgAAACAgICAgICAgA=="></audio>
<output id="result"></output>
<script>
const clip = document.querySelector("#clip");
clip.addEventListener("loadedmetadata", () => {
document.querySelector("#result").textContent = `duration=${clip.duration.toFixed(3)}; paused=${clip.paused}; controls=${clip.controls}; source=${clip.currentSrc.startsWith("data:audio/wav")}`;
}, { once: true });
</script>
Wynik
duration=0.001; paused=true; controls=true; source=true
Wynik potwierdza załadowane metadane, natywne sterowanie i wybrane źródło; nie dowodzi słyszalnego odtwarzania ani zgody polityki autoplay.