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-playsinline和playsinline参数使视频播放时局域播放，不脱离文档流，但是前提是需要嵌入网页的APP（比如WeChat微信）中UIwebview的allowsInlineMediaPlayback = YES、webview.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全屏设置。它有true和false两个属性值，true支持全屏播放，false不支持全屏播放。其实ISO 微信浏览器是Chrome的内核，相关的属性都支持，也是为什么X5同层播放不支持的原因。安卓微信浏览器是X5内核，一些属性标签比如playsinline就不支持，所以始终全屏。

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

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