CKTIS / JavaScript
HTMLMediaElement: tempo, volume ed eventi di riproduzione
HTMLMediaElement fornisce l’API comune agli elementi audio e video. Consente di leggere lo stato di riproduzione, modificare la posizione e disattivare l’audio, e aggiornare l’interfaccia in base agli eventi invece di presumere che un comando di riproduzione riesca subito.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
media.currentTime = seconds; media.volume = 0.5; media.muted = true; media.addEventListener("timeupdate", render);HTMLMediaElement è l’interfaccia comune agli elementi audio e video. È una Web API definita da HTML, non una funzionalità di una specifica edizione di ECMAScript. La presenza di Node 24 non dimostra il supporto nei browser. L’interfaccia di base è ampiamente disponibile, ma volume presenta limiti di compatibilità; verifica i browser e i dispositivi di destinazione.
HTMLMediaElement.currentTime indica la posizione in secondi. Quando readyState vale HAVE_NOTHING, come nell’elemento senza sorgente dell’esempio, l’assegnazione memorizza la posizione predefinita da cui iniziare la riproduzione, senza avviare un salto. Negli altri stati, l’assegnazione richiede un salto all’interno della linea temporale disponibile. HTMLMediaElement.duration è di sola lettura: secondi, NaN quando non sono disponibili dati oppure Infinity per una durata indefinita. Calcola la percentuale di avanzamento solo se la durata è finita e positiva. HTMLMediaElement.volume accetta valori da 0 a 1. HTMLMediaElement.muted disattiva l’audio indipendentemente, senza modificare il volume memorizzato.
Le proprietà di sola lettura HTMLMediaElement.paused e HTMLMediaElement.ended indicano rispettivamente lo stato di pausa e il completamento della riproduzione; non sono intercambiabili. paused === false non garantisce che la riproduzione stia avanzando, ad esempio durante il buffering. HTMLMediaElement.error contiene null oppure un oggetto MediaError. Gli eventi play e pause segnalano cambiamenti di stato, mentre i metodi play() e pause() impartiscono comandi. Gestisci il rifiuto della promise restituita da play(), ad esempio se le regole di autoplay bloccano la riproduzione.
loadedmetadata segnala il caricamento dei metadati, durationchange una variazione della durata ed emptied lo svuotamento dello stato della risorsa: aggiorna anche l’interfaccia in quel caso. Usa timeupdate per aggiornare la posizione, ma non come orologio dei fotogrammi: la frequenza dipende dal carico. volumechange riguarda le modifiche a volume o muted; ended segnala la fine della riproduzione. L’evento error può segnalare non solo un errore nel caricamento della risorsa, ma anche un errore fatale di decodifica dopo l’inizio della riproduzione. Leggi le proprietà correnti nei gestori degli eventi.
L’esempio crea un elemento senza sorgente, registra gli eventi e stampa lo stato iniziale. Non riproduce file né verifica la decodifica. NaN è rappresentato intenzionalmente come testo, così che la serializzazione JSON conservi questa distinzione.
Esempi
const media = document.createElement("audio");
const events = [
"timeupdate", "loadedmetadata", "durationchange", "emptied",
"play", "pause", "volumechange", "ended", "error"
];
function snapshot() {
return JSON.stringify({
currentTime: media.currentTime,
duration: Number.isNaN(media.duration) ? "NaN" : String(media.duration),
volume: media.volume,
muted: media.muted,
paused: media.paused,
ended: media.ended,
error: media.error === null ? null : media.error.code
});
}
for (const type of events) {
media.addEventListener(type, () => console.log(type, snapshot()));
}
console.log(snapshot());Risultato
{"currentTime":0,"duration":"NaN","volume":1,"muted":false,"paused":true,"ended":false,"error":null}Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.
Fonti
- HTMLMediaElement - Web APIs | MDN
- HTMLMediaElement: currentTime property - Web APIs | MDN
- HTMLMediaElement: duration property - Web APIs | MDN
- HTMLMediaElement: volume property - Web APIs | MDN
- HTMLMediaElement: timeupdate event - Web APIs | MDN
- HTMLMediaElement: volumechange event - Web APIs | MDN
- HTMLMediaElement: paused property - Web APIs | MDN
- HTMLMediaElement: ended property - Web APIs | MDN
- HTMLMediaElement: error property - Web APIs | MDN
- HTMLMediaElement: play() method - Web APIs | MDN