CKTIS / JavaScript
Stan i czas odtwarzania: paused, muted, currentTime i duration
Sprawdzaj osobno stan pauzy i wyciszenia, ustawiaj pozycję na osi czasu w sekundach i odróżniaj znany czas trwania od wartości `NaN` i `Infinity`.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
media.paused // boolean, read-only
media.muted // boolean, read/write
media.muted = true // mute the audio output
media.currentTime // number in seconds, read/write
media.currentTime = 12.5 // request a position on the media timeline
media.duration // number in seconds, read-only; may be NaN or Infinitypaused, muted, currentTime i duration to właściwości instancji HTMLMediaElement, dostępne na elementach audio i video. Należą do API platformy webowej, a nie do samego ECMAScriptu, więc nie zakładaj ich dostępności w środowisku bez DOM.
paused to właściwość logiczna tylko do odczytu. Nowy element ma paused === true. Używaj pause() i play(), zamiast przypisywać wartość do paused. Obietnica zwracana przez play() może zostać odrzucona, na przykład gdy przeglądarka blokuje automatyczne odtwarzanie. Samo paused === false nie oznacza, że pozycja się zmienia: element może czekać na dane.
muted to logiczny stan wyciszenia dźwięku, który można odczytywać i zmieniać. media.muted = true wycisza dźwięk, a false wyłącza wyciszenie. Wyciszenie nie jest pauzą ani ustawieniem volume na zero. defaultMuted odzwierciedla atrybut HTML muted, który określa domyślne wyciszenie, a nie bieżący stan.
currentTime odczytuje pozycję na osi czasu medium w sekundach; ułamki sekund są dozwolone. Przed dostępnością metadanych przypisanie zapisuje żądaną pozycję początkową. Po ich załadowaniu przypisanie inicjuje przewinięcie. NaN i wartości nieskończone powodują TypeError. Faktyczna pozycja może różnić się od żądanej: sprawdź zakresy seekable, zwłaszcza w transmisji na żywo, i użyj zdarzenia seeked, aby wykryć zakończenie przewijania.
duration jest tylko do odczytu: skończona wartość to czas końca na osi czasu medium w sekundach (długość, jeśli oś zaczyna się od zera). NaN oznacza, że czas trwania nie jest jeszcze dostępny, a Infinity — że medium nie ma znanego końca. Odczytaj tę wartość przy loadedmetadata i odświeżaj ją przy durationchange. Dla osi zaczynającej się od zera obliczaj currentTime / duration tylko wtedy, gdy Number.isFinite(duration) && duration > 0.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Media playback state and time</title>
</head>
<body>
<script>
const media = document.createElement("video");
console.log(`currentTime=${media.currentTime}`);
media.muted = true;
media.currentTime = 2.5;
console.log(
`paused=${media.paused}, muted=${media.muted}, ` +
`currentTime=${media.currentTime}, duration=${media.duration}`
);
</script>
</body>
</html>Wynik
currentTime=0 paused=true, muted=true, currentTime=2.5, duration=NaN
Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli. Element nie ma źródła: `2.5` to zapisana pozycja początkowa, a nie wynik przewinięcia ani odtwarzania. Element nadal jest w stanie pauzy, a `duration` pozostaje `NaN`.
Powiązane lekcje
- JavaScript · Lekcja 28 · Średniozaawansowany · Wersja: 3