html5视频媒体标签video的使用方法及完整参数说明

video是HTML5的一个视频媒体标签,其作用是在网页中嵌入指定的视频,video标签的代码结构及参数如下。

HTML代码结构:

<video
    controls
    autoplay
    loop
    preload="auto"
    poster="img/popup-img.png"
    webkit-playsinline="true"
    playsinline="true"
    x5-video-player-type="h5"
    x5-video-player-fullscreen="true"
    x-webkit-airplay="allow" 
    x5-video-orientation="portraint"
    style="object-fit:fill">
        <source src="video.mp4" type="video/mp4">
        <source src="video.ogg" type="video/ogg; codecs=dirac, speex">
        <p>你的浏览器不支持 <code>video</code> 标签.</p>
</video>

参数说明:

  • controls - 显示标准的 HTML5 视频/音频播放器控制条、控制按钮。
  • autoplay - 让文件自动播放。
  • loop - 让文件循环播放。
  • preload - 属性是用来缓存大体积文件的。它有三个可选值:"none" 不缓存、"auto" 缓存、"metadata" 只缓存文件元信息
  • poster - 视频封面
  • webkit-playsinlin="true" - 这个属性在 ios 10中设置有用,其他的目前还不起作用,让视频在小窗内播放,也就是不是全屏播放
  • playsinline="true" - IOS微信浏览器支持小窗内播放
  • x5-video-player-type="h5" - 启用H5播放器,是wechat安卓版特性
  • x5-video-player-fullscreen="true" - 全屏设置,设置为 true 是防止横屏
  • x5-video-orientation="portraint" - 播放器屏幕的方向,landscape横屏,portraint竖屏,默认值为竖屏。
  • source - 标签是为了能够兼容各种浏览器对不同媒体类型的支持,我们可以用多个<source></source>元素来提供多个不同的媒体类型。支持mp4格式视频流的浏览器可以播放mp4文件,如果不支持,可以播放Ogg文件。
  • codecs=dirac, speex - 是用来指定播放使用的解码器(codecs); 这样就可以更精确的让浏览器如何播放提供的视频。

特别说明:

1、webkit-playsinlineplaysinline参数使视频播放时局域播放,不脱离文档流,但是前提是需要嵌入网页的APP(比如WeChat微信)中UIwebview的allowsInlineMediaPlayback = YESwebview.allowsInlineMediaPlayback = YES时才能生效。也就是说如果APP不设置,标签中加入了这两个属性也是无效的,这也就是为什么安卓手机WeChat播放视频时总是全屏,因为APP不支持playsinline,而ISO的WeChat支持。

2、如果做全屏直播或者全屏H5体验的用户,ISO需要删除webkit-playsinline标签,因为并不支持false的属性值,而安卓默认全屏,所以不需要设置。另外,全屏是有播放控件的,无论你是否设置control

3、x-webkit-airplay="allow"暂时无法确切的知道其作用,猜测这个属性应该是使此视频支持ios的AirPlay功能,使用AirPlay可以直接从使用iOS的设备上的不同位置播放视频、音乐还有照片文件,也就是说通过AirPlay功能可以实现影音文件的无线播放,当然前提是播放的终端设备也要支持相应的功能。

4、x5-video-player-type启用同层H5播放器,就是在视频全屏的时候,div可以呈现在视频层上,也是WeChat安卓版特有的属性。

同层播放别名也叫做沉浸式播放,播放的时候看似全屏,但是已经除去了control和微信的导航栏,只留下"X"和"<"两键。目前的同层播放器只在Android(包括微信)上生效,暂时不支持iOS。至于为什么同层播放只对安卓开放,是因为安卓不能像ISO一样局域播放,默认的全屏会使得一些界面操作被阻拦,如果是全屏H5还好,但是做直播的话,诸如弹幕那样的功能就无法实现了,所以这时候同层播放的概念就解决了这个问题。不过在测试的过程中发现,不同版本的ISO和安卓效果略有不同。

5、x5-video-orientation声明播放器支持的方向,可选值landscape横屏或portraint竖屏,默认值portraint。无论是直播还是全屏H5一般都是竖屏播放,但是这个属性需要x5-video-player-type开启H5模式

6、x5­-video­-player­-fullscreen全屏设置。它有truefalse两个属性值,true支持全屏播放,false不支持全屏播放。其实ISO 微信浏览器是Chrome的内核,相关的属性都支持,也是为什么X5同层播放不支持的原因。安卓微信浏览器是X5内核,一些属性标签比如playsinline就不支持,所以始终全屏。

7、在Android的微信里面,就算加上了上面的属性,还会出现上下有黑边,不能全屏的问题。解决办法:给video加上object-fit: fill;的style属性。如果还是有黑边有可能是视频尺寸不合适。

原文地址:https://www.jianshu.com/p/8c17967adee7