HTML DOM Audio-objekti

Audio-objekti

Audio-objekti on uusi objekti HTML5:ssä.

Audio-objekti edustaa HTML <audio>-elementtiä.

Tavoita Audio-objekti

Voit käyttää getElementById() -metodia tavoitellaksesi <audio>-elementtiä:

var x = document.getElementById("myAudio");

Kokeile itse!

Luo Audio-objekti

Voit luoda <audio>-elementin käyttämällä document.createElement() -metodia:

var x = document.createElement("AUDIO");

Kokeile itse!

Audio-objektiominaisuudet

Ominaisuudet Kuvaus
audioTracks Palauta AudioTrackList-objekti, joka edustaa käytettävissä olevia ääniraitoja.
autoplay Aseta tai palauta, tulisiko ääni toistaa heti, kun se on valmis (ladattu).
buffered Palauta TimeRanges-objekti, joka edustaa äänen varastoitua osaa.
controller Palauta MediaController-objekti, joka edustaa äänen nykyistä mediasäätöä.
controls Aseta tai palauta, tulisiko äänen ohjain (esim. toisto/pausa) näyttää.
crossOrigin Aseta tai palauta äänen CORS-asetukset.
currentSrc Palauta nykyisen äänen URL.
currentTime Aseta tai palauta äänessä oleva nykyinen toiston paikka sekunneissa.
defaultMuted Aseta tai palauta, onko ääni oletusarvoisesti hiljainen.
defaultPlaybackRate Aseta tai palauta äänen oletuspyöritysvauhti.
duration Palauta äänen pituus sekunneissa.
ended Palauta, onko äänen toisto päättynyt.
error Palauta MediaError-objekti, joka edustaa äänen virhetila.
loop Aseta tai palauta, tulisiko ääni toistaa uudelleen lopetettuna.
mediaGroup Aseta tai palauta äänen mediaryhmän nimi.
muted Aseta tai palauta, onko ääni pois päältä.
networkState Palauta äänen nykyinen verkkotila.
paused Aseta tai palauta, onko ääni keskeytetty.
playbackRate Aseta tai palauta äänen toiston nopeus.
played Palauta TimeRanges-objekti, joka edustaa äänen toistettuja osia.
preload Aseta tai palauta äänen preload-ominaisuuden arvo.
readyState Palauta äänen nykyinen valmiustila.
seekable Palauta TimeRanges-objekti, joka edustaa äänen haettavissa olevia osia.
seeking Palauta, onko käyttäjä nykyisesti etsimässä äänessä.
src Aseta tai palauta äänen src-ominaisuuden arvo.
textTracks Palauta TextTrackList-objekti, joka edustaa saatavilla olevia tekstiraitoja.
volume Aseta tai palauta äänen äänenvoimakkuus.

Audio-objektin metodit

Metodi Kuvaus
addTextTrack() Lisää uusi tekstiraita ääneen.
canPlayType() Tarkista, pystyykö selain suorittamaan määritetyn äänityypin.
fastSeek() Määritä toistoaika äänentoistossa.
getStartDate() Palauta uusi Date-objekti, joka edustaa nykyistä aikalinjan siirtymää.
load() Lataa uudelleen äänielementti.
play() Aloita äänen toisto.
pause() Pysäytä nykyinen äänentoisto.

Standardiominaisuudet ja tapahtumat

Audio-objekti tukee standardejaOminaisuudetjaTapahtumat.

Liittyvät sivut

HTML-opas:HTML5 ääni

HTML viittausopas:HTML <audio>-elementti