分享一个基于HTML5实现的视频播放器

Posted 2020-09-26 WebEnh

什么是hivideo？

    最近一段时间在使用PhoneGap开发一个App应用，App需要播放视频，本想直接使用html5的video，但使用它在全屏播放时不支持横屏播放，只能放弃。最终决定还是自己封装一个播放器算了，免得以后要扩展功能麻烦。

    最近迷上hi这个单词，所以我给这个播放器取名叫做：hivideo。

    hivideo是一款基于html5的视频播放器，摒弃video原有的播放控制条样式，自己重写了一次。支持暂停、播放进度控制、声音控制、全屏播放。如果是要在手机端使用hivideo，全屏播放时还支持横屏播放。

    hivideo最终实现的效果如下：

如何使用hivideo？

    hivideo目录结构：

assets

----images

----hivideo.css

hivideo.js

    要想使用hivideo，首先得在主界面引入样式hivideo.css文件。

<link rel="stylesheet" href="assets/hivideo.css" />

    hivideo.js文件可在主页面直接引用，同时也支持CommonJs、AMD规范。

    在需要转换为hivideo播放器的video标签上添加属性：

<video ishivideo="true"></video>

    hivideo会自动把上面的video元素转换为hivideo播放器。我们还可以在video标签上设置播放属性：

    1.autoplay: 自动播放。

    2.isrotate：全屏是否横屏播放，如果在手机端使用hivideo，我们可以设置该属性为true，表示全屏播放时横屏显示。

    3.autoHide：播放视频时自动隐藏控制条。

    使用方式：

<video ishivideo="true" autoplay="true" isrotate="false" autoHide="true">
    <source src="http://www.html5videoplayer.net/videos/madagascar3.mp4" type="video/mp4">
</video>

    如果是后期动态添加的video元素，也可以通过hivideo动态加载。例如页面动态添加了一个id为”player”的video元素，可通过如下方式把video转换为hivideo播放器：

hivideo(document.getElementById("player"));

 

    在线演示Demo：https://heavis.github.io/hivideo/index.html

    开源地址：https://github.com/heavis/hivideo

如何隐藏浏览器的播放器样式

    目前大多数浏览器都支持video元素，并且不同浏览器实现的video样式也不尽相同。

    chrome实现的播放器样式：

    Firefox实现的播放器样式：

    IE实现的播放器样式：

   

    为了让播放器在各个浏览器下样式统一，首先要隐藏各个浏览器实现的样式。但一般我们通过浏览器开发工具查看不到播放器下的元素，因为这些元素都是阴影元素，它们是通过文档片段附加到video上，对于文档流是不可见的。
    如何查看浏览器下的阴影元素？Chrome为开发人员提供了可选项，打开开发者工具->Settings->General页签，我们能看到Elments有一个叫做”Show user agent shadow DOM”的选项：

    勾选上该选项，现在我们通过开发工具可以查看到video下的播放元素：

    上图中<div pseudo=”-webkit-media-controls”>元素就是控制条的容器，我们只要设置它的display为none就可以隐藏掉控制条，但也需要兼容各个浏览器：

video[ishivideo="true"]::-webkit-media-controls{
display:none !important;
}

video[ishivideo="true"]::-moz-media-controls{
display:none !important;
}

video[ishivideo="true"]::-o-media-controls{
display:none !important;
}

video[ishivideo="true"]::media-controls{
display:none !important;
}

    这里我遇到一个费解的问题，把上面的样式通过合并的方式写是无效的，下面的写法不能隐藏掉阴影元素：

video[ishivideo="true"]::-webkit-media-controls,
video[ishivideo="true"]::-moz-media-controls,
video[ishivideo="true"]::-o-media-controls,
video[ishivideo="true"]::media-controls{
    display:none !important;
}

 

    隐藏浏览器阴影元素后就可以开始动手实现自己的控制条了。实现之前，我们得了解video提供的API。

播放器常用API

    各个浏览器操作播放器提供的API名称一般都带有厂商前缀，所有基本上每一个API函数都对应多个版本，需要考虑兼容性。

    1.全屏事件

["fullscreenchange", "webkitfullscreenchange", "mozfullscreenchange", "MSFullscreenChange"].forEach(function(eventType){
    document.addEventListener(eventType, function(event){

    })
});

    如果播放器全屏状态放生变化上面的事件就会触发。上面的事件我们只知道全屏状态发生变化，但不知道当前是进入全屏还是退出全屏。还需要结合全屏状态API。

 

    2.当前是否全屏状态

hivideo.prototype.isFullScreen = function(){
    return document.fullscreenElement ||
        document.webkitFullscreenElement ||
        document.mozFullScreenElement || 
        document.msFullscreenElement;
};

    上面是hivideo封装的判断是否全屏的函数。

 

    3.进入全屏模式

if (video.requestFullscreen) {
    video.requestFullscreen();
} else if (video.webkitRequestFullscreen) {
    video.webkitRequestFullscreen();
} else if (video.mozRequestFullScreen) {
    video.mozRequestFullScreen();
} else if (video.msRequestFullscreen) {
    video.msRequestFullscreen();
}

     

    4.退出全屏模式

if (document.exitFullscreen) {
    document.exitFullscreen();
} else if (document.webkitExitFullscreen) {
    document.webkitExitFullscreen();
} else if (document.mozCancelFullScreen) {
    document.mozCancelFullScreen();
} else if (document.msExitFullscreen) {
    document.msExitFullscreen();
}

   

    5.播放状态

    video.paused:true表示未播放， false表示正在播放。

 

    6.播放视频

    video.play()

 

    7.暂停播放
    video.pause()

 

    8.是否静音
    video.muted = true， 静音
    Video.muted = false，不静音

 

    9.声音控制

    设置video.volume控制声音，值的范围0到100。

 

    10.当前播放时间
    video.currentTime，可读可写，单位为妙。可通过<input type=’range’>的值显示播放进度。
   

    11.视频总周期
    video.duration,单位为妙。

    12.播放时间更新事件

video.addEventListener("timeupdate", function(){
});

   

    13.视频元数据加载完成事件

    一般播放视频时都会显示视频总时长，触发loadedmetadata事件时元数据已经加载完成，所以可以在该事件中设置总时长的显示。

video.addEventListener("loadedmetadata", function(){
}

 

    14.视频播放结束事件

video.addEventListener("ended", function(){
}

 

    有了上面列出的API，要实现自定义播放器就比较容易了，在自己实现播放器的过程中对应位置调用对应API即可。

如何实现横屏播放

    原理很简单，在全屏时播放器容器沾满了整个屏幕，我们可以给容器附加一个自定义样式，让容器旋转90度。

.rotate90{
    -webkit-transform: rotate(90deg);
    -moz-transform: rotate(90deg);
    -ms-transform: rotate(90deg);
    -o-transform: rotate(90deg);
    transform: rotate(90deg);
}

    旋转后的容器宽度和高度也要调整，需要把屏幕的高度screen.height赋给容器的宽度，而容器的高度设置为屏幕的宽度。这样就实现了全屏播放效果。下面是全屏播放控制的完整代码：

hivideo.prototype.bindFullEvent = function(){
    var self = this;
    var origWidth = origHeight = 0;

    ["fullscreenchange", "webkitfullscreenchange", "mozfullscreenchange", "MSFullscreenChange"].forEach(function(eventType){
        var curFullhivideoId = null;
        document.addEventListener(eventType, function(event){
        if((curFullhivideoId = document.body.getAttribute("curfullHivideo")) && curFullhivideoId !== self.videoId_ ){
            return;
        }
        var isRotate = self.options.isrotate;
        if(self.isFullScreen()){
            var cltHeight = isRotate ? window.screen.width : window.screen.height;
            var cltWidth = isRotate ? window.screen.height : window.screen.width;
            if(isRotate && !hivideo.hasClass(self.videoParent, "rotate90")){
                hivideo.addClass(self.videoParent, "rotate90");
            }
            self.videoParent.style.height = cltHeight + "px";
            self.videoParent.style.width = cltWidth + "px";
        }else{
            if(isRotate) self.videoParent.className = self.videoParent.className.replace("rotate90", "").trim();
                self.videoParent.style.height = origHeight + "px";
                self.videoParent.style.width = origWidth + "px";
            }
            })
        });

        self.fullBtn && self.fullBtn.addEventListener("click", function(){
        if(!self.isFullScreen()){
            document.body.setAttribute("curfullHivideo", self.videoId_);
            origWidth = self.videoParent.offsetWidth;
            origHeight = self.videoParent.offsetHeight;
            // go full-screen
            if (self.videoParent.requestFullscreen) {
            self.videoParent.requestFullscreen();
            } else if (self.videoParent.webkitRequestFullscreen) {
            self.videoParent.webkitRequestFullscreen();
            } else if (self.videoParent.mozRequestFullScreen) {
                self.videoParent.mozRequestFullScreen();
            } else if (self.videoParent.msRequestFullscreen) {
                self.videoParent.msRequestFullscreen();
            }
                self.exchangeBtnStatus(this, false);
        }else{
        // exit full-screen
            if (document.exitFullscreen) {
                document.exitFullscreen();
            } else if (document.webkitExitFullscreen) {
                document.webkitExitFullscreen();
            } else if (document.mozCancelFullScreen) {
                document.mozCancelFullScreen();
            } else if (document.msExitFullscreen) {
                document.msExitFullscreen();
            }

            self.exchangeBtnStatus(this, true);
        }
    });

    return self;
};

支持CommonJS、AMD规范

    1.CommonJS支持

(function(global, factory){
    "use strict";
    //支持commonJs规范
    if(typeof module === "object" && typeof module.exports === "object"){
        module.exports = factory(global);
    }else{
        factory(global);
    }
}(typeof window !== "undefined" ? window : this, function(window)
}

    2.AMD支持

//支持AMD规范
if (typeof define === "function" && define.amd){
    define("hivideo", [], function(){
        return hivideo;
    })
}