HTML5的媒体标签(audio, video)的属性、方法和事件汇总

2,884 阅读3分钟

<video>标签属性:

  • src:视频的URL
  • poster:视频封面,没有播放时显示的图片
  • preload:预加载
  • autoplay:自动播放
  • loop:循环播放
  • controls:浏览器自带的控制条
  • width:视频宽度
  • height:视频高度
  • videoWidth:视频内容宽度(初始状态下为0,加载metadata之后才有值)
  • videoHeight:视频内容高度(初始状态下为0,加载metadata之后才有值)

<audio>标签属性:

  • src:音乐的URL
  • preload:预加载
  • autoplay:自动播放
  • loop:循环播放
  • controls:浏览器自带的控制条

获取HTMLVideoElement和HTMLAudioElement对象

JS代码

//audio可以直接通过new创建对象 
Media = new Audio("http://www.abc.com/test.mp3"); 
//audio和video都可以通过JS获取对象,JS通过id获取video和audio的对象 
Media = document.getElementById("media"); 

Media方法和属性:

HTMLVideoElement 和HTMLAudioElement 均继承自HTMLMediaElement JS代码

//错误状态 
Media.error; //null:正常 
Media.error.code; //1.用户终止 2.网络错误 3.解码错误 4.URL无效 

//网络状态 
Media.currentSrc; //返回当前资源的URL 
Media.src = value; //返回或设置当前资源的URL 
Media.canPlayType(type); //是否能播放某种格式的资源 
Media.networkState; //0.此元素未初始化 1.正常但没有使用网络 2.正在下载数据 3.没有找到资源 
Media.load(); //重新加载src指定的资源 
Media.buffered; //返回已缓冲区域,TimeRanges 
Media.preload; //none:不预载 metadata:预载资源信息 auto: 

//准备状态 
Media.readyState;  //1:HAVE_NOTHING 2:HAVE_METADATA 3.HAVE_CURRENT_DATA 4.HAVE_FUTURE_DATA 5.HAVE_ENOUGH_DATA 
Media.seeking; //是否正在seeking 

//回放状态 
Media.currentTime = value; //当前播放的位置,赋值可改变位置 
Media.startTime; //一般为0,如果为流媒体或者不从0开始的资源,则不为0 
Media.duration; //当前资源长度 流返回无限 
Media.paused; //是否暂停 
Media.defaultPlaybackRate = value;//默认的回放速度,可以设置 
Media.playbackRate = value;//当前播放速度,设置后马上改变 
Media.played; //返回已经播放的区域,TimeRanges,关于此对象见下文 
Media.seekable; //返回可以seek的区域 TimeRanges 
Media.ended; //是否结束 
Media.autoPlay; //是否自动播放 
Media.loop; //是否循环播放 
Media.play();  //播放 
Media.pause();  //暂停 

//控制 
Media.controls;//是否有默认控制条 
Media.volume = value; //音量 
Media.muted = value; //静音 

//TimeRanges(区域)对象 
TimeRanges.length; //区域段数 
TimeRanges.start(index) //第index段区域的开始位置 
TimeRanges.end(index) //第index段区域的结束位置 

Media相关的事件:

  • loadstart:客户端开始请求数据
  • progress:客户端正在请求数据
  • suspend:延迟下载
  • abort:客户端主动终止下载(不是因为错误引起),
  • error:请求数据时遇到错误
  • stalled:网速失速
  • play:play()和autoplay开始播放时触发
  • pause:pause()触发
  • loadedmetadata:成功获取资源长度
  • loadeddata:
  • waiting:等待数据,并非错误
  • playing:开始回放
  • canplay:可以播放,但中途可能因为加载而暂停
  • canplaythrough:可以播放,歌曲全部加载完毕
  • seeking:寻找中
  • seeked:寻找完毕
  • timeupdate:播放时间改变
  • ended:播放结束
  • ratechange:播放速率改变
  • durationchange:资源长度改变
  • volumechange:音量改变

Media使用常见问题:

  1. 某些Android手机的原生浏览器(Android Browser),在第一次点击播放video的时候会触发error事件然后自动暂停,需要用户再次点击播放才能顺利播放。
  2. 某些比较老版本(例如2.3以下的)的Android手机的原生浏览器(Android Browser)不支持全屏播放video,但是控制条还是会有全屏按钮,点击会导致浏览器crash。
  3. Android Browser、Chrome for mobile、iOS Safari以及大部分的手机浏览器都不支持自动播放video。
  4. 在QQ手机浏览器for iOS中,video标签不能在页面初始阶段或JS插入DOM是,src为空或者文件地址不可用,否则页面会同时存在原生的视频播放控件和QQ浏览器的视频播放控件。
  5. 国内很多浏览器厂商(如UC、QQ、百度等),甚至手机厂商(如小米),都会拦截video标签使用自己的视频播放控件,由于各厂商实现机制和标准不一,上面列出的事件页面JS不一定都能监听到。